> For the complete documentation index, see [llms.txt](https://docs.stackai.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.stackai.com/integrations/catalog/semrush.md).

# Semrush

Research keywords, analyze domains and competitors, and inspect backlink profiles with the Semrush SEO platform.

## Connectors

Choose the connector that matches your authentication method. The options below use the names shown in StackAI.

| Connector | Authentication |
| --------- | -------------- |
| Semrush   | API Key        |

### Semrush

Connect to the Semrush SEO platform with an API key from the API Units tab of your Semrush subscription. Provides keyword research, domain analytics, competitor discovery, and backlink intelligence.

#### Set up in Semrush

1. Sign in to Semrush with a subscription that includes API access.
2. Open your account's Subscription info / API Units page and locate the API key.
3. Copy the API key value (keep it private; API calls consume your API Units).

#### Set up in StackAI

1. Open **Settings → Connections**, add a connection, and select **Semrush**.
2. Enter the credentials and connection details in the fields below.
3. Save the connection and check its connection status. Select this saved connection when configuring an action or feature that uses it.

**Connection fields**

| StackAI field    | Required                 | What to enter                                                                                                                                                                                                                                                                                                             |
| ---------------- | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| API Key          | Yes                      | Your Semrush API key. Generate it at <https://www.semrush.com/accounts/subscription-info/api-units/> (API Units tab). Note: the Semrush API requires a separate API subscription and is not included with standard Semrush seats. [Provider instructions](https://www.semrush.com/accounts/subscription-info/api-units/). |
| Default Database | Optional / as applicable | Default Semrush regional database used when an action does not specify one. Use a two-letter country code such as 'us', 'uk', 'de', 'fr'. The full list (\~142 databases) is at <https://developer.semrush.com/api/basics/databases/>.                                                                                    |

**Provider documentation:** [Setup reference](https://developer.semrush.com/api/).

### Verify the connection

Check that the connection is healthy. Then run a read operation against a resource the connected account can access. A successful connection check confirms authentication; it does not guarantee permission for every action.

If access is denied, check the credential or OAuth permissions, the selected account or environment, and access to the specific resource. Update expired credentials or reconnect after permissions change.

## Use an action

1. Add the required **Semrush** action to the workflow.
2. Select a connection when the action requests one.
3. Complete the required fields. Use the reference picker when a value comes from another workflow step.
4. Run the workflow and inspect the action’s output. Check the result before using it in a later step.

## Actions

### Keyword Overview

Get the Semrush overview for a single keyword — search volume, CPC, competition, and trend.

#### Inputs

| Field    | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Keyword  | string          | Yes      | The keyword to look up in Semrush.                                                                                                                                                                                                                                                                                                                                                                                             |
| Database | select (string) | No       | Semrush regional database (e.g. 'us', 'uk', 'de'). Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field    | Type    | Description                                                             |
| -------- | ------- | ----------------------------------------------------------------------- |
| Overview | object  | The Semrush overview row for the keyword, or null if nothing was found. |
| Found    | boolean | Whether Semrush returned overview data for this keyword.                |

### Batch Keyword Overview

Look up search volume, CPC, and competition for up to 100 keywords in a single Semrush call.

#### Inputs

| Field    | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                    |
| -------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Keywords | array           | Yes      | Up to 100 keywords to look up in a single Semrush call.                                                                                                                                                                                                                                                                                                                                                                        |
| Database | select (string) | No       | Semrush regional database (e.g. 'us', 'uk', 'de'). Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field     | Type    | Description                                                        |
| --------- | ------- | ------------------------------------------------------------------ |
| Overviews | array   | Overview rows returned by Semrush, one per keyword that was found. |
| Count     | integer | Number of rows returned by Semrush.                                |

### Related Keywords

Expand a seed keyword into Semrush's list of related variations, with search volume and CPC.

#### Inputs

| Field        | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------ | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Seed Keyword | string          | Yes      | The seed keyword to expand into related variations.                                                                                                                                                                                                                                                                                                                                                    |
| Max Results  | integer         | No       | Maximum number of related keywords to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                 |
| Database     | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field            | Type    | Description                                                 |
| ---------------- | ------- | ----------------------------------------------------------- |
| Related Keywords | array   | Related keywords returned by Semrush, ordered by relevance. |
| Count            | integer | Number of related keywords returned.                        |

### Keyword Questions

Discover question-formatted keywords (how, what, why, …) around a seed keyword for FAQ and People Also Ask content.

#### Inputs

| Field        | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------ | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Seed Keyword | string          | Yes      | The seed keyword to expand into question-formatted queries.                                                                                                                                                                                                                                                                                                                                            |
| Max Results  | integer         | No       | Maximum number of question keywords to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                |
| Database     | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field     | Type    | Description                                      |
| --------- | ------- | ------------------------------------------------ |
| Questions | array   | Question-formatted keywords returned by Semrush. |
| Count     | integer | Number of question keywords returned.            |

### Keyword Difficulty

Score up to 100 keywords for how hard they are to rank for in organic search (0-100).

#### Inputs

| Field    | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| -------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Keywords | array           | Yes      | Up to 100 keywords to score for ranking difficulty.                                                                                                                                                                                                                                                                                                                                                    |
| Database | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field        | Type    | Description                                        |
| ------------ | ------- | -------------------------------------------------- |
| Difficulties | array   | Difficulty rows returned by Semrush (0-100 index). |
| Count        | integer | Number of difficulty rows returned.                |

### Keyword Organic Results

List the domains ranking in Google's top 100 organic results for a keyword — core SERP competitor research.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Keyword     | string          | Yes      | The keyword whose organic SERP (top-100 ranking domains) you want to inspect.                                                                                                                                                                                                                                                                                                                          |
| Max Results | integer         | No       | Maximum number of ranking domains to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                  |
| Database    | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field   | Type    | Description                                                |
| ------- | ------- | ---------------------------------------------------------- |
| Results | array   | Domains ranking for the keyword, ordered by SERP position. |
| Count   | integer | Number of ranking rows returned.                           |

### Keyword Paid Results

List the domains running Google Ads for a keyword — paid competitor research.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Keyword     | string          | Yes      | The keyword whose paid SERP (domains running Google Ads) you want to inspect.                                                                                                                                                                                                                                                                                                                          |
| Max Results | integer         | No       | Maximum number of advertisers to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                      |
| Database    | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field   | Type    | Description                                   |
| ------- | ------- | --------------------------------------------- |
| Results | array   | Advertisers running paid ads for the keyword. |
| Count   | integer | Number of advertiser rows returned.           |

### Broad Match Keywords

Discover long-tail keyword variations that contain or closely match a seed keyword, with search volume and CPC.

#### Inputs

| Field        | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ------------ | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Seed Keyword | string          | Yes      | The seed keyword to expand into broad-match variations (long-tail discovery).                                                                                                                                                                                                                                                                                                                          |
| Max Results  | integer         | No       | Maximum number of variations to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                       |
| Database     | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field    | Type    | Description                                 |
| -------- | ------- | ------------------------------------------- |
| Keywords | array   | Broad-match variations of the seed keyword. |
| Count    | integer | Number of variations returned.              |

### Domain Overview

Get the Semrush overview for a domain — rank, organic/paid keywords, traffic, and cost.

#### Inputs

| Field    | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| -------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Domain   | string          | Yes      | The domain to look up, without 'http\://' or '[www](http://www).'.                                                                                                                                                                                                                                                                                                                                     |
| Database | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field    | Type    | Description                                                            |
| -------- | ------- | ---------------------------------------------------------------------- |
| Overview | object  | The Semrush overview row for the domain, or null if nothing was found. |
| Found    | boolean | Whether Semrush returned overview data for this domain.                |

### Domain Organic Keywords

List the keywords a domain currently ranks for in organic search, with position, traffic share, and search volume.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Domain      | string          | Yes      | The domain whose organic keywords you want to list.                                                                                                                                                                                                                                                                                                                                                    |
| Max Results | integer         | No       | Maximum number of keywords to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                         |
| Database    | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field    | Type    | Description                                                     |
| -------- | ------- | --------------------------------------------------------------- |
| Keywords | array   | Organic keywords returned by Semrush, ordered by traffic share. |
| Count    | integer | Number of keyword rows returned.                                |

### Domain Organic Competitors

Discover which domains compete with yours in organic search, ranked by keyword overlap.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Domain      | string          | Yes      | The domain whose organic competitors you want to list.                                                                                                                                                                                                                                                                                                                                                 |
| Max Results | integer         | No       | Maximum number of competitors to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                      |
| Database    | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field       | Type    | Description                                                          |
| ----------- | ------- | -------------------------------------------------------------------- |
| Competitors | array   | Competing domains returned by Semrush, ordered by competition level. |
| Count       | integer | Number of competitors returned.                                      |

### Domain Organic Pages

List the top-ranking organic pages of a domain, with the number of keywords each page ranks for and its traffic share.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Domain      | string          | Yes      | The domain whose top-ranking organic pages you want to list.                                                                                                                                                                                                                                                                                                                                           |
| Max Results | integer         | No       | Maximum number of pages to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                            |
| Database    | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field | Type    | Description                                                  |
| ----- | ------- | ------------------------------------------------------------ |
| Pages | array   | Top-ranking organic pages of the domain, ordered by traffic. |
| Count | integer | Number of pages returned.                                    |

### Domain Paid Keywords

List the keywords a domain targets in Google Ads, with position, search volume, CPC, and traffic share.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Domain      | string          | Yes      | The domain whose paid search keywords you want to list.                                                                                                                                                                                                                                                                                                                                                |
| Max Results | integer         | No       | Maximum number of keywords to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                         |
| Database    | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field    | Type    | Description                                               |
| -------- | ------- | --------------------------------------------------------- |
| Keywords | array   | Paid keywords a domain bids on, ordered by traffic share. |
| Count    | integer | Number of keywords returned.                              |

### Domain Paid Competitors

Find the domains competing with a target in Google Ads, with shared keywords and AdWords traffic/cost estimates.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Domain      | string          | Yes      | The domain whose paid-search competitors you want to find.                                                                                                                                                                                                                                                                                                                                             |
| Max Results | integer         | No       | Maximum number of competitors to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                      |
| Database    | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field       | Type    | Description                                            |
| ----------- | ------- | ------------------------------------------------------ |
| Competitors | array   | Paid-search competitors, ordered by competition level. |
| Count       | integer | Number of competitors returned.                        |

### Domain vs Domain

Compare the organic keyword profiles of up to 5 domains side-by-side, showing each domain's position for every shared keyword.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Domains     | array           | Yes      | Between 2 and 5 domains to compare.                                                                                                                                                                                                                                                                                                                                                                    |
| Max Results | integer         | No       | Maximum number of keyword rows to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                     |
| Database    | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field           | Type    | Description                                                                    |
| --------------- | ------- | ------------------------------------------------------------------------------ |
| Shared Keywords | array   | Keywords across the compared domains, with each domain's position per keyword. |
| Count           | integer | Number of keyword rows returned.                                               |

### URL Overview

Get Semrush's overview for a specific URL — rank, organic/paid keywords, traffic, and cost.

#### Inputs

| Field    | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| -------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| URL      | string          | Yes      | The full URL (including scheme) to look up.                                                                                                                                                                                                                                                                                                                                                            |
| Database | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field    | Type    | Description                                                     |
| -------- | ------- | --------------------------------------------------------------- |
| Overview | object  | Semrush overview row for the URL, or null if nothing was found. |
| Found    | boolean | Whether Semrush returned overview data for this URL.            |

### URL Organic Keywords

List the keywords a specific URL ranks for in organic search, with position, traffic share, and search volume.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                                                                                                                                                                                                                                                                                            |
| ----------- | --------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| URL         | string          | Yes      | The full URL whose organic keywords you want to list.                                                                                                                                                                                                                                                                                                                                                  |
| Max Results | integer         | No       | Maximum number of keywords to return (1 to 1000). Default: 10.                                                                                                                                                                                                                                                                                                                                         |
| Database    | select (string) | No       | Semrush regional database. Leave blank to use the connection's default. Available values: United States, United Kingdom, Canada, Australia, Germany, France, Spain, Italy, Netherlands, Belgium, Sweden, Norway, Denmark, Finland, Poland, Portugal, Brazil, Mexico, Argentina, Switzerland, Austria, Ireland, India, Japan, Singapore, Hong Kong, Taiwan, Turkey, South Africa, United Arab Emirates. |

#### Outputs

| Field    | Type    | Description                                  |
| -------- | ------- | -------------------------------------------- |
| Keywords | array   | Organic keywords driving traffic to the URL. |
| Count    | integer | Number of keywords returned.                 |

### Backlinks Overview

Get the high-level backlink profile for a domain or URL — authority score, backlinks, referring domains, and referring IPs.

#### Inputs

| Field       | Type            | Required | Description                                                                                                                  |
| ----------- | --------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| Target      | string          | Yes      | The domain, subdomain, or full URL whose backlink profile you want to inspect.                                               |
| Target Type | select (string) | No       | How Semrush should interpret the target: as a root domain, subdomain, or URL. Available values: Root Domain, Subdomain, URL. |

#### Outputs

| Field    | Type    | Description                                               |
| -------- | ------- | --------------------------------------------------------- |
| Overview | object  | Aggregate backlink metrics, or null if nothing was found. |
| Found    | boolean | Whether Semrush returned overview data for this target.   |

### Backlinks List

List individual backlinks (source URL, anchor, first/last seen) pointing at a domain, subdomain, or URL.

#### Inputs

| Field       | Type            | Required | Description                                                                                                             |
| ----------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| Target      | string          | Yes      | The domain, subdomain, or URL whose inbound backlinks you want to list.                                                 |
| Target Type | select (string) | No       | How Semrush should interpret the target: root domain, subdomain, or URL. Available values: Root Domain, Subdomain, URL. |
| Max Results | integer         | No       | Maximum number of backlinks to return (1 to 1000). Default: 10.                                                         |

#### Outputs

| Field     | Type    | Description                               |
| --------- | ------- | ----------------------------------------- |
| Backlinks | array   | Individual backlinks returned by Semrush. |
| Count     | integer | Number of backlinks returned.             |

### Referring Domains

List the domains linking to a target, with authority score, backlink counts, origin IP, and country.

#### Inputs

| Field       | Type            | Required | Description                                                                                                             |
| ----------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| Target      | string          | Yes      | The domain, subdomain, or URL whose referring domains you want to list.                                                 |
| Target Type | select (string) | No       | How Semrush should interpret the target: root domain, subdomain, or URL. Available values: Root Domain, Subdomain, URL. |
| Max Results | integer         | No       | Maximum number of referring domains to return (1 to 1000). Default: 10.                                                 |

#### Outputs

| Field             | Type    | Description                                                |
| ----------------- | ------- | ---------------------------------------------------------- |
| Referring Domains | array   | Domains linking to the target, ordered by authority score. |
| Count             | integer | Number of referring domains returned.                      |

### Backlink Anchors

List the anchor texts used by inbound backlinks, with referring domains and backlink counts per anchor.

#### Inputs

| Field       | Type            | Required | Description                                                                                                             |
| ----------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| Target      | string          | Yes      | The domain, subdomain, or URL whose backlink anchor texts you want to inspect.                                          |
| Target Type | select (string) | No       | How Semrush should interpret the target: root domain, subdomain, or URL. Available values: Root Domain, Subdomain, URL. |
| Max Results | integer         | No       | Maximum number of anchors to return (1 to 1000). Default: 10.                                                           |

#### Outputs

| Field   | Type    | Description                                      |
| ------- | ------- | ------------------------------------------------ |
| Anchors | array   | Anchor-text distribution from inbound backlinks. |
| Count   | integer | Number of anchors returned.                      |

### Backlinks Indexed Pages

List the pages of a target that receive backlinks, with backlink counts and referring-domain counts per page.

#### Inputs

| Field       | Type            | Required | Description                                                                                                             |
| ----------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| Target      | string          | Yes      | The domain, subdomain, or URL whose indexed pages you want to list.                                                     |
| Target Type | select (string) | No       | How Semrush should interpret the target: root domain, subdomain, or URL. Available values: Root Domain, Subdomain, URL. |
| Max Results | integer         | No       | Maximum number of pages to return (1 to 1000). Default: 10.                                                             |

#### Outputs

| Field | Type    | Description                                  |
| ----- | ------- | -------------------------------------------- |
| Pages | array   | Pages on the target receiving inbound links. |
| Count | integer | Number of pages returned.                    |

### Backlink Competitors

Find domains with backlink profiles similar to the target, with similarity and common referring-domain counts.

#### Inputs

| Field       | Type            | Required | Description                                                                                                             |
| ----------- | --------------- | -------- | ----------------------------------------------------------------------------------------------------------------------- |
| Target      | string          | Yes      | The domain, subdomain, or URL whose backlink competitors you want to find.                                              |
| Target Type | select (string) | No       | How Semrush should interpret the target: root domain, subdomain, or URL. Available values: Root Domain, Subdomain, URL. |
| Max Results | integer         | No       | Maximum number of competitors to return (1 to 1000). Default: 10.                                                       |

#### Outputs

| Field       | Type    | Description                                                    |
| ----------- | ------- | -------------------------------------------------------------- |
| Competitors | array   | Domains with similar backlink profiles, ordered by similarity. |
| Count       | integer | Number of competitors returned.                                |

## Important behavior

Actions that create, update, send, or delete data can change the connected service. Review their inputs before running them. A retry can repeat an operation; consider this when configuring retries for actions that change data.

The catalog lists the fields and capabilities available in the supplied provider definition. Availability can also depend on your deployment and organization’s Feature Access settings.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.stackai.com/integrations/catalog/semrush.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
