# Semrush (/integrations/semrush)





{/* MANUAL-CONTENT-START:intro */}

Use [Semrush](https://www.semrush.com/) to query SEO reports for domains, subdomains, URLs, keywords, and backlinks. Choose a regional database and, where supported, a historical month in `YYYYMM15` format. Domain vs. Domain compares up to five domains.

**Before you start**

Requests authenticate with a `key` query parameter and are billed in **API units**, which are metered separately from your Semrush subscription — line-based reports such as Backlinks and Referring Domains charge per row returned, so set **Limit** deliberately. Reports answer as CSV, and this integration decodes them into structured rows for you. Two API behaviours worth knowing: a rejected request comes back with **HTTP 200** and a body like `ERROR 132 :: API UNITS BALANCE IS ZERO` (surfaced here as a normal tool error), and the API may **omit a requested column** from a response, so treat every field on a row as optional.

**Not covered**

The Semrush **Trends**, **Projects** (Site Audit, Position Tracking), and **Listing Management** APIs are separate products with their own endpoints and subscriptions, and are not part of this block. Three SEO API reports are also excluded: **Comparison by Referring Domains** (`backlinks_matrix`) and **Batch Comparison** (`backlinks_comparison`), whose multi-target array parameters do not fit the shared request builder, and **Subdomain Organic Pages** (`subdomain_organic_unique`), whose documented response format is inconsistent with every other report.

{/* MANUAL-CONTENT-END */}

## Use the block [#usage-instructions]

Query the Semrush SEO API for domain, subdomain, and URL traffic overviews, organic and paid keywords, ad and product listing creatives, competitor sets, keyword research, and backlink profiles. Requires a Semrush subscription with API units.

## Actions [#actions]

### Semrush Domain Overview [#semrush-domain-overview]

Get the Semrush rank plus organic and paid search totals for a domain in one regional database.

<ReferenceDetails>
  #### Input [#input]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |

  #### Output [#output]

  | Parameter | Type | Description |
  | - | - | - |
  | `overview` | json | Organic and paid search overview for the domain |
  | ↳ `domain` | string | Domain name |
  | ↳ `rank` | number | Semrush popularity rating of the target, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords bringing users via the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic brought via the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of the organic keywords |
  | ↳ `paidKeywords` | number | Keywords the target is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic brought via paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget |
</ReferenceDetails>

### Semrush Domain Overview (All Databases) [#semrush-domain-overview-all-databases]

Get organic and paid search totals for a domain across every regional Semrush database.

<ReferenceDetails>
  #### Input [#input-1]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | No | Regional database code to restrict the report to, for example us |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example rk\_asc, or\_desc, or ot\_desc |

  #### Output [#output-1]

  | Parameter | Type | Description |
  | - | - | - |
  | `databases` | array | One row of domain totals per regional database |
  | ↳ `database` | string | Regional database the row belongs to |
  | ↳ `domain` | string | Domain name |
  | ↳ `rank` | number | Semrush popularity rating of the target, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords bringing users via the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic brought via the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of the organic keywords |
  | ↳ `paidKeywords` | number | Keywords the target is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic brought via paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget |
  | ↳ `plaKeywords` | number | Keywords used for product listing ads |
  | ↳ `plaUniques` | number | Number of unique product listing ads |
</ReferenceDetails>

### Semrush Domain Overview History [#semrush-domain-overview-history]

Get the historical trend of a domain rank plus its organic and paid search totals.

<ReferenceDetails>
  #### Input [#input-2]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDaily` | boolean | No | Return daily data points for the last 31 days instead of monthly ones |
  | `displaySort` | string | No | Sort order, for example dt\_desc or dt\_asc |

  #### Output [#output-2]

  | Parameter | Type | Description |
  | - | - | - |
  | `history` | array | Historical data points, in the requested sort order |
  | ↳ `date` | string | Data collection date in YYYYMMDD or YYYYMM format |
  | ↳ `rank` | number | Semrush popularity rating of the target, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords bringing users via the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic brought via the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of the organic keywords |
  | ↳ `paidKeywords` | number | Keywords the target is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic brought via paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget |
</ReferenceDetails>

### Semrush Domain Organic Keywords [#semrush-domain-organic-keywords]

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

<ReferenceDetails>
  #### Input [#input-3]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displayDaily` | boolean | No | Return daily data points for the last 31 days instead of monthly ones |
  | `displaySort` | string | No | Sort order, for example tr\_desc, po\_asc, or nq\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-3]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Organic keywords the domain ranks for |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `previousPosition` | number | Position held at the previous data collection |
  | ↳ `positionDifference` | number | Change between the previous and the current position |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `trafficPercent` | number | Share of the traffic to the target driven by this keyword |
  | ↳ `traffic` | number | Estimated traffic driven by this keyword |
  | ↳ `trafficCost` | number | Share of the traffic cost of the target attributed to this keyword |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
  | ↳ `intents` | array | Keyword intents: 0 commercial, 1 informational, 2 navigational, 3 transactional |
  | ↳ `trends` | array | Relative search interest over the last 12 months |
</ReferenceDetails>

### Semrush Domain Paid Keywords [#semrush-domain-paid-keywords]

List the keywords a domain buys in Google Ads, with ad position, copy, and traffic share.

<ReferenceDetails>
  #### Input [#input-4]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example po\_asc, tr\_desc, or nq\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-4]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Paid keywords the domain bids on |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `previousPosition` | number | Position held at the previous data collection |
  | ↳ `positionDifference` | number | Change between the previous and the current position |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `visibleUrl` | string | Display URL shown in the ad |
  | ↳ `title` | string | Ad or product title |
  | ↳ `description` | string | Ad text |
  | ↳ `traffic` | number | Estimated traffic driven by this keyword |
  | ↳ `trafficPercent` | number | Share of the traffic to the target driven by this keyword |
  | ↳ `trafficCost` | number | Estimated traffic cost attributed to this keyword |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
</ReferenceDetails>

### Semrush Domain Ad Copies [#semrush-domain-ad-copies]

List the unique Google Ads creatives a domain runs, with title, description, and keyword count.

<ReferenceDetails>
  #### Input [#input-5]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example pc\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Tt\|Co\|sale |

  #### Output [#output-5]

  | Parameter | Type | Description |
  | - | - | - |
  | `ads` | array | Unique ad creatives the domain runs |
  | ↳ `title` | string | Ad or product title |
  | ↳ `description` | string | Ad text |
  | ↳ `visibleUrl` | string | Display URL shown in the ad |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `numberOfKeywords` | number | Number of keywords the ad runs on |
</ReferenceDetails>

### Semrush Domain Ad History [#semrush-domain-ad-history]

List a domain’s past Google Ads placements month by month, with the copy used each time.

<ReferenceDetails>
  #### Input [#input-6]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example dt\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Ph\|Co\|shoes |

  #### Output [#output-6]

  | Parameter | Type | Description |
  | - | - | - |
  | `ads` | array | Historical ad placements, one row per keyword and month |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `date` | string | Data collection date in YYYYMMDD or YYYYMM format |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `trafficPercent` | number | Share of the traffic to the target driven by this keyword |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `title` | string | Ad or product title |
  | ↳ `description` | string | Ad text |
  | ↳ `visibleUrl` | string | Display URL shown in the ad |
</ReferenceDetails>

### Semrush Organic Competitors [#semrush-organic-competitors]

List the domains competing with a target domain in Google organic search results.

<ReferenceDetails>
  #### Input [#input-7]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example np\_desc or cr\_desc |

  #### Output [#output-7]

  | Parameter | Type | Description |
  | - | - | - |
  | `competitors` | array | Competing domains ranked by competitor relevance |
  | ↳ `domain` | string | Domain name |
  | ↳ `competitorRelevance` | number | Competition level based on the total keyword count of each domain |
  | ↳ `commonKeywords` | number | Keywords both domains rank for in the top 100 organic results |
  | ↳ `organicKeywords` | number | Keywords this competing domain ranks for in the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic this competing domain gets from the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of this competing domain organic keywords |
  | ↳ `paidKeywords` | number | Keywords this competing domain is buying in Google Ads |
</ReferenceDetails>

### Semrush Paid Competitors [#semrush-paid-competitors]

List the domains competing with a target domain in Google paid search results.

<ReferenceDetails>
  #### Input [#input-8]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example np\_desc or cr\_desc |

  #### Output [#output-8]

  | Parameter | Type | Description |
  | - | - | - |
  | `competitors` | array | Competing advertisers ranked by competitor relevance |
  | ↳ `domain` | string | Domain name |
  | ↳ `competitorRelevance` | number | Competition level based on the total keyword count of each domain |
  | ↳ `commonKeywords` | number | Keywords both domains rank for in the top 100 organic results |
  | ↳ `paidKeywords` | number | Keywords this competing domain is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic this competing domain gets from paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget of this competing domain |
  | ↳ `organicKeywords` | number | Keywords this competing domain ranks for in the Google top 100 organic results |
</ReferenceDetails>

### Semrush Domain PLA Keywords [#semrush-domain-pla-keywords]

List the keywords that trigger a domain’s product listing ads, with the promoted product and price.

<ReferenceDetails>
  #### Input [#input-9]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example nq\_desc or po\_asc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-9]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Product listing ad keywords for the domain |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `previousPosition` | number | Position held at the previous data collection |
  | ↳ `positionDifference` | number | Change between the previous and the current position |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `shopName` | string | Name of the shop running the product listing ad |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `title` | string | Ad or product title |
  | ↳ `productPrice` | number | Price of the promoted product |
  | ↳ `timestamp` | number | Unix timestamp of the data point |
</ReferenceDetails>

### Semrush Domain PLA Copies [#semrush-domain-pla-copies]

List the unique product listing ads a domain runs, with product title, price, and shop name.

<ReferenceDetails>
  #### Input [#input-10]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domain` | string | Yes | Domain to analyze, for example example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |

  #### Output [#output-10]

  | Parameter | Type | Description |
  | - | - | - |
  | `ads` | array | Unique product listing ads the domain runs |
  | ↳ `title` | string | Ad or product title |
  | ↳ `productPrice` | number | Price of the promoted product |
  | ↳ `shopName` | string | Name of the shop running the product listing ad |
  | ↳ `url` | string | URL of the ranking or advertised page |
</ReferenceDetails>

### Semrush Domain vs. Domain [#semrush-domain-vs-domain]

Compare up to five domains on the keywords they rank for, returning each domain’s position side by side.

<ReferenceDetails>
  #### Input [#input-11]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `domains` | string | Yes | Comma-separated list of up to five domains to compare |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `competitionType` | string | No | Which keyword set to compare: or for organic or ad for paid |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example nq\_desc or cp\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-11]

  | Parameter | Type | Description |
  | - | - | - |
  | `domains` | array | The compared domains, in the order their positions appear |
  | `keywords` | array | Keywords with each compared domain’s position |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `positions` | json | Position of each compared domain, keyed by domain, where 0 means not ranked |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
</ReferenceDetails>

### Semrush Subdomain Overview [#semrush-subdomain-overview]

Get the organic and paid search totals for a subdomain in one regional database.

<ReferenceDetails>
  #### Input [#input-12]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `subdomain` | string | Yes | Subdomain to analyze, for example blog.example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |

  #### Output [#output-12]

  | Parameter | Type | Description |
  | - | - | - |
  | `overview` | json | Organic and paid search overview for the subdomain |
  | ↳ `domain` | string | Domain name |
  | ↳ `rank` | number | Semrush popularity rating of the target, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords bringing users via the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic brought via the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of the organic keywords |
  | ↳ `paidKeywords` | number | Keywords the target is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic brought via paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget |
</ReferenceDetails>

### Semrush Subdomain Overview (All Databases) [#semrush-subdomain-overview-all-databases]

Get organic and paid search totals for a subdomain across every regional Semrush database.

<ReferenceDetails>
  #### Input [#input-13]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `subdomain` | string | Yes | Subdomain to analyze, for example blog.example.com |
  | `database` | string | No | Regional database code to restrict the report to, for example us |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example rk\_asc or ot\_desc |

  #### Output [#output-13]

  | Parameter | Type | Description |
  | - | - | - |
  | `databases` | array | One row of subdomain totals per regional database |
  | ↳ `database` | string | Regional database the row belongs to |
  | ↳ `domain` | string | Domain name |
  | ↳ `rank` | number | Semrush popularity rating of the target, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords bringing users via the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic brought via the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of the organic keywords |
  | ↳ `paidKeywords` | number | Keywords the target is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic brought via paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget |
  | ↳ `plaKeywords` | number | Keywords used for product listing ads |
  | ↳ `plaUniques` | number | Number of unique product listing ads |
</ReferenceDetails>

### Semrush Subdomain Overview History [#semrush-subdomain-overview-history]

Get the historical trend of a subdomain’s organic and paid search totals.

<ReferenceDetails>
  #### Input [#input-14]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `subdomain` | string | Yes | Subdomain to analyze, for example blog.example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDaily` | boolean | No | Return daily data points for the last 31 days instead of monthly ones |
  | `displaySort` | string | No | Sort order, for example dt\_desc or dt\_asc |

  #### Output [#output-14]

  | Parameter | Type | Description |
  | - | - | - |
  | `history` | array | Historical data points, in the requested sort order |
  | ↳ `date` | string | Data collection date in YYYYMMDD or YYYYMM format |
  | ↳ `rank` | number | Semrush popularity rating of the target, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords bringing users via the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic brought via the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of the organic keywords |
  | ↳ `paidKeywords` | number | Keywords the target is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic brought via paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget |
</ReferenceDetails>

### Semrush Subdomain Organic Keywords [#semrush-subdomain-organic-keywords]

List the keywords a subdomain ranks for in Google organic search.

<ReferenceDetails>
  #### Input [#input-15]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `subdomain` | string | Yes | Subdomain to analyze, for example blog.example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displayDaily` | boolean | No | Return daily data points for the last 31 days instead of monthly ones |
  | `displaySort` | string | No | Sort order, for example tr\_desc, po\_asc, or nq\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-15]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Organic keywords the subdomain ranks for |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `previousPosition` | number | Position held at the previous data collection |
  | ↳ `positionDifference` | number | Change between the previous and the current position |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `trafficPercent` | number | Share of the traffic to the target driven by this keyword |
  | ↳ `traffic` | number | Estimated traffic driven by this keyword |
  | ↳ `trafficCost` | number | Share of the traffic cost of the target attributed to this keyword |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
  | ↳ `intents` | array | Keyword intents: 0 commercial, 1 informational, 2 navigational, 3 transactional |
  | ↳ `trends` | array | Relative search interest over the last 12 months |
</ReferenceDetails>

### Semrush Subdomain Paid Keywords [#semrush-subdomain-paid-keywords]

List the keywords a subdomain buys in Google Ads.

<ReferenceDetails>
  #### Input [#input-16]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `subdomain` | string | Yes | Subdomain to analyze, for example blog.example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example po\_asc, tr\_desc, or nq\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-16]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Paid keywords the subdomain bids on |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `previousPosition` | number | Position held at the previous data collection |
  | ↳ `positionDifference` | number | Change between the previous and the current position |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `visibleUrl` | string | Display URL shown in the ad |
  | ↳ `title` | string | Ad or product title |
  | ↳ `description` | string | Ad text |
  | ↳ `traffic` | number | Estimated traffic driven by this keyword |
  | ↳ `trafficPercent` | number | Share of the traffic to the target driven by this keyword |
  | ↳ `trafficCost` | number | Estimated traffic cost attributed to this keyword |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
</ReferenceDetails>

### Semrush Subdomain Ad Copies [#semrush-subdomain-ad-copies]

List the unique Google Ads creatives a subdomain runs.

<ReferenceDetails>
  #### Input [#input-17]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `subdomain` | string | Yes | Subdomain to analyze, for example blog.example.com |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example pc\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Tt\|Co\|sale |

  #### Output [#output-17]

  | Parameter | Type | Description |
  | - | - | - |
  | `ads` | array | Unique ad creatives the subdomain runs |
  | ↳ `title` | string | Ad or product title |
  | ↳ `description` | string | Ad text |
  | ↳ `visibleUrl` | string | Display URL shown in the ad |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `numberOfKeywords` | number | Number of keywords the ad runs on |
</ReferenceDetails>

### Semrush URL Overview [#semrush-url-overview]

Get the organic and paid search totals for a single URL in one regional database.

<ReferenceDetails>
  #### Input [#input-18]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `url` | string | Yes | Full URL to analyze, for example [https://example.com/pricing](https://example.com/pricing) |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |

  #### Output [#output-18]

  | Parameter | Type | Description |
  | - | - | - |
  | `overview` | json | Organic and paid search overview for the URL |
  | ↳ `domain` | string | Domain name |
  | ↳ `rank` | number | Semrush popularity rating of the target, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords bringing users via the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic brought via the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of the organic keywords |
  | ↳ `paidKeywords` | number | Keywords the target is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic brought via paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget |
</ReferenceDetails>

### Semrush URL Overview (All Databases) [#semrush-url-overview-all-databases]

Get organic and paid search totals for a single URL across every regional Semrush database.

<ReferenceDetails>
  #### Input [#input-19]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `url` | string | Yes | Full URL to analyze, for example [https://example.com/pricing](https://example.com/pricing) |
  | `database` | string | No | Regional database code to restrict the report to, for example us |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example rk\_asc or ot\_desc |

  #### Output [#output-19]

  | Parameter | Type | Description |
  | - | - | - |
  | `databases` | array | One row of URL totals per regional database |
  | ↳ `database` | string | Regional database the row belongs to |
  | ↳ `domain` | string | Domain name |
  | ↳ `rank` | number | Semrush popularity rating of the target, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords bringing users via the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic brought via the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of the organic keywords |
  | ↳ `paidKeywords` | number | Keywords the target is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic brought via paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget |
  | ↳ `plaKeywords` | number | Keywords used for product listing ads |
  | ↳ `plaUniques` | number | Number of unique product listing ads |
</ReferenceDetails>

### Semrush URL Overview History [#semrush-url-overview-history]

Get the historical trend of a URL’s organic and paid search totals.

<ReferenceDetails>
  #### Input [#input-20]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `url` | string | Yes | Full URL to analyze, for example [https://example.com/pricing](https://example.com/pricing) |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDaily` | boolean | No | Return daily data points for the last 31 days instead of monthly ones |
  | `displaySort` | string | No | Sort order, for example dt\_desc or dt\_asc |

  #### Output [#output-20]

  | Parameter | Type | Description |
  | - | - | - |
  | `history` | array | Historical data points, in the requested sort order |
  | ↳ `date` | string | Data collection date in YYYYMMDD or YYYYMM format |
  | ↳ `rank` | number | Semrush popularity rating of the target, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords bringing users via the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic brought via the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of the organic keywords |
  | ↳ `paidKeywords` | number | Keywords the target is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic brought via paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget |
</ReferenceDetails>

### Semrush URL Organic Keywords [#semrush-url-organic-keywords]

List the keywords a single URL ranks for in Google organic search.

<ReferenceDetails>
  #### Input [#input-21]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `url` | string | Yes | Full URL to analyze, for example [https://example.com/pricing](https://example.com/pricing) |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example tr\_desc, po\_asc, or nq\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-21]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Organic keywords the URL ranks for |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `previousPosition` | number | Position held at the previous data collection |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
  | ↳ `trafficPercent` | number | Share of the traffic to the target driven by this keyword |
  | ↳ `traffic` | number | Estimated traffic driven by this keyword |
  | ↳ `trafficCost` | number | Estimated traffic cost attributed to this keyword |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `intents` | array | Keyword intents: 0 commercial, 1 informational, 2 navigational, 3 transactional |
  | ↳ `trends` | array | Relative search interest over the last 12 months |
</ReferenceDetails>

### Semrush URL Paid Keywords [#semrush-url-paid-keywords]

List the keywords a single URL is advertised on in Google Ads, with the ad copy used.

<ReferenceDetails>
  #### Input [#input-22]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `url` | string | Yes | Full URL to analyze, for example [https://example.com/pricing](https://example.com/pricing) |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example tr\_desc, po\_asc, or nq\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-22]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Paid keywords the URL is advertised on |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `traffic` | number | Estimated traffic driven by this keyword |
  | ↳ `trafficPercent` | number | Share of the traffic to the target driven by this keyword |
  | ↳ `trafficCost` | number | Estimated traffic cost attributed to this keyword |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `trends` | array | Relative search interest over the last 12 months |
  | ↳ `title` | string | Ad or product title |
  | ↳ `description` | string | Ad text |
</ReferenceDetails>

### Semrush Keyword Overview [#semrush-keyword-overview]

Get search volume, CPC, competition, difficulty, and intent for a single keyword.

<ReferenceDetails>
  #### Input [#input-23]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrase` | string | Yes | Keyword to analyze |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |

  #### Output [#output-23]

  | Parameter | Type | Description |
  | - | - | - |
  | `overview` | json | Keyword metrics in the selected database |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
  | ↳ `intents` | array | Keyword intents: 0 commercial, 1 informational, 2 navigational, 3 transactional |
  | ↳ `trends` | array | Relative search interest over the last 12 months |
</ReferenceDetails>

### Semrush Keyword Overview (All Databases) [#semrush-keyword-overview-all-databases]

Get search volume, CPC, and competition for a keyword across every regional Semrush database.

<ReferenceDetails>
  #### Input [#input-24]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrase` | string | Yes | Keyword to analyze |
  | `database` | string | No | Regional database code to restrict the report to, for example us |

  #### Output [#output-24]

  | Parameter | Type | Description |
  | - | - | - |
  | `databases` | array | One row of keyword metrics per regional database |
  | ↳ `date` | string | Data collection date in YYYYMMDD or YYYYMM format |
  | ↳ `database` | string | Regional database the row belongs to |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `intents` | array | Keyword intents: 0 commercial, 1 informational, 2 navigational, 3 transactional |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
</ReferenceDetails>

### Semrush Batch Keyword Overview [#semrush-batch-keyword-overview]

Get search volume, CPC, competition, difficulty, and intent for up to 100 keywords at once.

<ReferenceDetails>
  #### Input [#input-25]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrases` | string | Yes | Semicolon-separated list of keywords, for example ebay;seo |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |

  #### Output [#output-25]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Keyword metrics, one row per submitted keyword |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
  | ↳ `intents` | array | Keyword intents: 0 commercial, 1 informational, 2 navigational, 3 transactional |
  | ↳ `trends` | array | Relative search interest over the last 12 months |
</ReferenceDetails>

### Semrush Keyword Difficulty [#semrush-keyword-difficulty]

Get the Keyword Difficulty Index for up to 100 keywords at once.

<ReferenceDetails>
  #### Input [#input-26]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrases` | string | Yes | Semicolon-separated list of keywords, for example ebay;seo |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |

  #### Output [#output-26]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Keyword difficulty scores, one row per submitted keyword |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
</ReferenceDetails>

### Semrush Related Keywords [#semrush-related-keywords]

Find keywords semantically related to a seed keyword, with volume, difficulty, and relevance.

<ReferenceDetails>
  #### Input [#input-27]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrase` | string | Yes | Keyword to analyze |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example nq\_desc or kd\_asc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-27]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Related keyword ideas for the seed keyword |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
  | ↳ `relatedRelevance` | number | Relevance of the result keyword to the seed keyword |
  | ↳ `keywordSerpFeatures` | array | IDs of all SERP features triggered by the keyword |
  | ↳ `intents` | array | Keyword intents: 0 commercial, 1 informational, 2 navigational, 3 transactional |
  | ↳ `trends` | array | Relative search interest over the last 12 months |
</ReferenceDetails>

### Semrush Broad Match Keywords [#semrush-broad-match-keywords]

Find broad-match and phrase-match variations of a seed keyword, with volume and difficulty.

<ReferenceDetails>
  #### Input [#input-28]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrase` | string | Yes | Keyword to analyze |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example nq\_desc or kd\_asc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-28]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Broad match keyword variations of the seed keyword |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
  | ↳ `keywordSerpFeatures` | array | IDs of all SERP features triggered by the keyword |
  | ↳ `intents` | array | Keyword intents: 0 commercial, 1 informational, 2 navigational, 3 transactional |
  | ↳ `trends` | array | Relative search interest over the last 12 months |
</ReferenceDetails>

### Semrush Keyword Questions [#semrush-keyword-questions]

Find question-form keywords containing a seed keyword, with volume and difficulty.

<ReferenceDetails>
  #### Input [#input-29]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrase` | string | Yes | Keyword to analyze |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example nq\_desc or kd\_asc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Nq\|Gt\|1000 |

  #### Output [#output-29]

  | Parameter | Type | Description |
  | - | - | - |
  | `keywords` | array | Question keywords containing the seed keyword |
  | ↳ `keyword` | string | Keyword phrase |
  | ↳ `searchVolume` | number | Average monthly searches for the keyword |
  | ↳ `cpc` | number | Average cost per click in USD (Google Ads) |
  | ↳ `competition` | number | Competitive density of advertisers bidding on the keyword (0-1) |
  | ↳ `numberOfResults` | number | Total organic results returned for the keyword |
  | ↳ `keywordDifficulty` | number | Estimated difficulty of ranking for the keyword (0-100) |
  | ↳ `intents` | array | Keyword intents: 0 commercial, 1 informational, 2 navigational, 3 transactional |
  | ↳ `trends` | array | Relative search interest over the last 12 months |
</ReferenceDetails>

### Semrush Organic Results [#semrush-organic-results]

List the domains and URLs ranking in Google organic search results for a keyword.

<ReferenceDetails>
  #### Input [#input-30]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrase` | string | Yes | Keyword to analyze |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |

  #### Output [#output-30]

  | Parameter | Type | Description |
  | - | - | - |
  | `results` | array | Ranking pages for the keyword, in SERP order |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `positionType` | string | Whether the position is a regular organic result or a SERP feature |
  | ↳ `domain` | string | Domain name |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `keywordSerpFeatures` | array | IDs of all SERP features triggered by the keyword |
  | ↳ `serpFeatures` | array | IDs of the SERP features the domain appears in for the keyword |
</ReferenceDetails>

### Semrush Paid Results [#semrush-paid-results]

List the domains and URLs advertising on a keyword in Google paid search results.

<ReferenceDetails>
  #### Input [#input-31]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrase` | string | Yes | Keyword to analyze |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |

  #### Output [#output-31]

  | Parameter | Type | Description |
  | - | - | - |
  | `results` | array | Advertisers appearing for the keyword |
  | ↳ `domain` | string | Domain name |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `visibleUrl` | string | Display URL shown in the ad |
</ReferenceDetails>

### Semrush Keyword Ad History [#semrush-keyword-ad-history]

List which domains advertised on a keyword month by month, with the copy each one used.

<ReferenceDetails>
  #### Input [#input-32]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `phrase` | string | Yes | Keyword to analyze |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |

  #### Output [#output-32]

  | Parameter | Type | Description |
  | - | - | - |
  | `ads` | array | Historical advertisers for the keyword, one row per domain and month |
  | ↳ `domain` | string | Domain name |
  | ↳ `date` | string | Data collection date in YYYYMMDD or YYYYMM format |
  | ↳ `position` | number | Position in the Google top 100 results, where 0 means not ranked |
  | ↳ `url` | string | URL of the ranking or advertised page |
  | ↳ `title` | string | Ad or product title |
  | ↳ `description` | string | Ad text |
  | ↳ `visibleUrl` | string | Display URL shown in the ad |
</ReferenceDetails>

### Semrush Winners and Losers [#semrush-winners-and-losers]

List the domains that gained or lost the most organic and paid search visibility in a database.

<ReferenceDetails>
  #### Input [#input-33]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displaySort` | string | No | Sort order, for example om\_desc or tm\_desc |

  #### Output [#output-33]

  | Parameter | Type | Description |
  | - | - | - |
  | `domains` | array | Domains ranked by change in search visibility |
  | ↳ `domain` | string | Domain name |
  | ↳ `rank` | number | Semrush popularity rating of this domain, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords this domain ranks for in the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic this domain gets from the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of this domain organic keywords |
  | ↳ `paidKeywords` | number | Keywords this domain is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic this domain gets from paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget of this domain |
  | ↳ `organicKeywordsDifference` | number | Change in organic keyword count since the previous month |
  | ↳ `organicTrafficDifference` | number | Change in organic traffic since the previous month |
  | ↳ `organicCostDifference` | number | Change in organic cost since the previous month |
  | ↳ `paidKeywordsDifference` | number | Change in paid keyword count since the previous month |
  | ↳ `paidTrafficDifference` | number | Change in paid traffic since the previous month |
  | ↳ `paidCostDifference` | number | Change in paid cost since the previous month |
</ReferenceDetails>

### Semrush Top Domains [#semrush-top-domains]

List the highest-ranked domains in a regional database by Semrush rank.

<ReferenceDetails>
  #### Input [#input-34]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `database` | string | Yes | Regional database code, for example us, uk, de, or fr |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displayDate` | string | No | Historical month in YYYYMM15 format |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|Or\|Gt\|100000 |

  #### Output [#output-34]

  | Parameter | Type | Description |
  | - | - | - |
  | `domains` | array | Top-ranked domains in the database |
  | ↳ `domain` | string | Domain name |
  | ↳ `rank` | number | Semrush popularity rating of this domain, based on organic traffic |
  | ↳ `organicKeywords` | number | Keywords this domain ranks for in the Google top 100 organic results |
  | ↳ `organicTraffic` | number | Traffic this domain gets from the Google top 100 organic results |
  | ↳ `organicCost` | number | Estimated Google Ads price of this domain organic keywords |
  | ↳ `paidKeywords` | number | Keywords this domain is buying in Google Ads |
  | ↳ `paidTraffic` | number | Traffic this domain gets from paid search results |
  | ↳ `paidCost` | number | Estimated monthly Google Ads budget of this domain |
</ReferenceDetails>

### Semrush Backlinks Overview [#semrush-backlinks-overview]

Get the Authority Score and backlink profile totals for a domain, subdomain, or URL.

<ReferenceDetails>
  #### Input [#input-35]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `target` | string | Yes | Root domain, subdomain, or URL to analyze |
  | `targetType` | string | No | Scope of the target: root\_domain, domain, or url. Defaults to root\_domain |

  #### Output [#output-35]

  | Parameter | Type | Description |
  | - | - | - |
  | `overview` | json | Backlink profile totals for the target |
  | ↳ `authorityScore` | number | Semrush Authority Score (0-100) |
  | ↳ `total` | number | Total number of backlinks |
  | ↳ `domainsNum` | number | Number of referring domains |
  | ↳ `urlsNum` | number | Number of referring URLs |
  | ↳ `ipsNum` | number | Number of referring IPs |
  | ↳ `ipClassCNum` | number | Number of referring class C subnets |
  | ↳ `followsNum` | number | Number of followed backlinks |
  | ↳ `nofollowsNum` | number | Number of nofollow backlinks |
  | ↳ `sponsoredNum` | number | Number of backlinks marked rel="sponsored" |
  | ↳ `ugcNum` | number | Number of backlinks marked rel="ugc" |
  | ↳ `textsNum` | number | Number of text backlinks |
  | ↳ `imagesNum` | number | Number of image backlinks |
  | ↳ `formsNum` | number | Number of form backlinks |
  | ↳ `framesNum` | number | Number of frame backlinks |
</ReferenceDetails>

### Semrush Backlinks [#semrush-backlinks]

List the backlinks pointing at a domain, subdomain, or URL, with source page, anchor, and authority.

<ReferenceDetails>
  #### Input [#input-36]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `target` | string | Yes | Root domain, subdomain, or URL to analyze |
  | `targetType` | string | No | Scope of the target: root\_domain, domain, or url. Defaults to root\_domain |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example page\_ascore\_desc or last\_seen\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|type\|\|newlink |

  #### Output [#output-36]

  | Parameter | Type | Description |
  | - | - | - |
  | `backlinks` | array | Backlinks pointing at the target |
  | ↳ `pageAuthorityScore` | number | Authority Score of the source page |
  | ↳ `sourceTitle` | string | Title of the linking page |
  | ↳ `sourceUrl` | string | URL of the linking page |
  | ↳ `targetUrl` | string | URL the backlink points to |
  | ↳ `anchor` | string | Anchor text of the backlink |
  | ↳ `nofollow` | string | Raw rel="nofollow" flag as returned by the API |
  | ↳ `externalLinksNum` | number | External links on the source page |
  | ↳ `internalLinksNum` | number | Internal links on the source page |
  | ↳ `firstSeen` | number | Unix timestamp when the link was first seen |
  | ↳ `lastSeen` | number | Unix timestamp when the link was last seen |
</ReferenceDetails>

### Semrush Referring Domains [#semrush-referring-domains]

List the domains linking to a target, with Authority Score, backlink count, and country.

<ReferenceDetails>
  #### Input [#input-37]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `target` | string | Yes | Root domain, subdomain, or URL to analyze |
  | `targetType` | string | No | Scope of the target: root\_domain, domain, or url. Defaults to root\_domain |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example backlinks\_num\_desc or domain\_ascore\_desc |
  | `displayFilter` | string | No | Semrush display\_filter expression, for example +\|zone\|\|com |

  #### Output [#output-37]

  | Parameter | Type | Description |
  | - | - | - |
  | `domains` | array | Domains linking to the target |
  | ↳ `domainAuthorityScore` | number | Authority Score of the referring domain |
  | ↳ `domain` | string | Domain name |
  | ↳ `backlinksNum` | number | Number of backlinks |
  | ↳ `ip` | string | IP address |
  | ↳ `country` | string | Country of the referring domain |
  | ↳ `firstSeen` | number | Unix timestamp when the link was first seen |
  | ↳ `lastSeen` | number | Unix timestamp when the link was last seen |
</ReferenceDetails>

### Semrush Referring IPs [#semrush-referring-ips]

List the IP addresses linking to a target, with the domain and backlink counts behind each one.

<ReferenceDetails>
  #### Input [#input-38]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `target` | string | Yes | Root domain, subdomain, or URL to analyze |
  | `targetType` | string | No | Scope of the target: root\_domain, domain, or url. Defaults to root\_domain |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example domains\_num\_desc or backlinks\_num\_desc |

  #### Output [#output-38]

  | Parameter | Type | Description |
  | - | - | - |
  | `ips` | array | IP addresses linking to the target |
  | ↳ `ip` | string | IP address |
  | ↳ `country` | string | Country of the referring domain |
  | ↳ `domainsNum` | number | Number of referring domains |
  | ↳ `backlinksNum` | number | Number of backlinks |
  | ↳ `firstSeen` | number | Unix timestamp when the link was first seen |
  | ↳ `lastSeen` | number | Unix timestamp when the link was last seen |
</ReferenceDetails>

### Semrush Backlink TLD Distribution [#semrush-backlink-tld-distribution]

Break a target’s backlink profile down by the top-level domain of its referring domains.

<ReferenceDetails>
  #### Input [#input-39]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `target` | string | Yes | Root domain, subdomain, or URL to analyze |
  | `targetType` | string | No | Scope of the target: root\_domain, domain, or url. Defaults to root\_domain |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example domains\_num\_desc or backlinks\_num\_desc |

  #### Output [#output-39]

  | Parameter | Type | Description |
  | - | - | - |
  | `zones` | array | Referring domain and backlink counts per top-level domain |
  | ↳ `zone` | string | Top-level domain zone |
  | ↳ `domainsNum` | number | Number of referring domains |
  | ↳ `backlinksNum` | number | Number of backlinks |
</ReferenceDetails>

### Semrush Backlink Country Distribution [#semrush-backlink-country-distribution]

Break a target’s backlink profile down by the country of its referring domains.

<ReferenceDetails>
  #### Input [#input-40]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `target` | string | Yes | Root domain, subdomain, or URL to analyze |
  | `targetType` | string | No | Scope of the target: root\_domain, domain, or url. Defaults to root\_domain |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example domains\_num\_desc or backlinks\_num\_desc |

  #### Output [#output-40]

  | Parameter | Type | Description |
  | - | - | - |
  | `countries` | array | Referring domain and backlink counts per country |
  | ↳ `country` | string | Country of the referring domain |
  | ↳ `domainsNum` | number | Number of referring domains |
  | ↳ `backlinksNum` | number | Number of backlinks |
</ReferenceDetails>

### Semrush Backlink Anchors [#semrush-backlink-anchors]

List the anchor texts used in backlinks to a target, with domain and backlink counts.

<ReferenceDetails>
  #### Input [#input-41]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `target` | string | Yes | Root domain, subdomain, or URL to analyze |
  | `targetType` | string | No | Scope of the target: root\_domain, domain, or url. Defaults to root\_domain |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example backlinks\_num\_desc or domains\_num\_desc |

  #### Output [#output-41]

  | Parameter | Type | Description |
  | - | - | - |
  | `anchors` | array | Anchor text distribution for the backlink profile |
  | ↳ `anchor` | string | Anchor text of the backlink |
  | ↳ `domainsNum` | number | Number of referring domains |
  | ↳ `backlinksNum` | number | Number of backlinks |
  | ↳ `firstSeen` | number | Unix timestamp when the link was first seen |
  | ↳ `lastSeen` | number | Unix timestamp when the link was last seen |
</ReferenceDetails>

### Semrush Indexed Pages [#semrush-indexed-pages]

List the pages of a target that attract backlinks, with response code and link counts.

<ReferenceDetails>
  #### Input [#input-42]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `target` | string | Yes | Root domain, subdomain, or URL to analyze |
  | `targetType` | string | No | Scope of the target: root\_domain, domain, or url. Defaults to root\_domain |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |
  | `displaySort` | string | No | Sort order, for example domains\_num\_desc or backlinks\_num\_desc |

  #### Output [#output-42]

  | Parameter | Type | Description |
  | - | - | - |
  | `pages` | array | Indexed pages of the target and the links they attract |
  | ↳ `sourceUrl` | string | URL of the linking page |
  | ↳ `sourceTitle` | string | Title of the linking page |
  | ↳ `responseCode` | number | HTTP status code the page returned when last crawled |
  | ↳ `backlinksNum` | number | Number of backlinks |
  | ↳ `domainsNum` | number | Number of referring domains |
  | ↳ `lastSeen` | number | Unix timestamp when the link was last seen |
  | ↳ `externalLinksNum` | number | External links on the source page |
  | ↳ `internalLinksNum` | number | Internal links on the source page |
</ReferenceDetails>

### Semrush Backlink Competitors [#semrush-backlink-competitors]

List domains with a backlink profile similar to the target, ranked by shared referring domains.

<ReferenceDetails>
  #### Input [#input-43]

  | Parameter | Type | Required | Description |
  | - | - | - | - |
  | `apiKey` | string | Yes | Semrush API key |
  | `target` | string | Yes | Root domain, subdomain, or URL to analyze |
  | `targetType` | string | No | Scope of the target: root\_domain, domain, or url. Defaults to root\_domain |
  | `limit` | number | No | Maximum number of rows to return, capped at 100,000 |
  | `offset` | number | No | Number of rows to skip, for pagination |

  #### Output [#output-43]

  | Parameter | Type | Description |
  | - | - | - |
  | `competitors` | array | Domains with backlink profiles similar to the target |
  | ↳ `authorityScore` | number | Semrush Authority Score (0-100) |
  | ↳ `domain` | string | Domain name |
  | ↳ `similarity` | number | Backlink profile similarity to the target |
  | ↳ `commonRefdomains` | number | Referring domains shared with the target |
  | ↳ `domainsNum` | number | Number of referring domains |
  | ↳ `backlinksNum` | number | Number of backlinks |
</ReferenceDetails>