Semrush API & Scraper
The Semrush API returns the website data Semrush publishes on its public pages as JSON, without a Semrush account: monthly visits, rank, Authority Score, backlink totals, AI-assistant visits and competitors for any root domain, plus the Top 100 websites per country and industry.
🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.
Give `domain_overview` a root domain and one call returns Semrush's estimate for the latest month: monthly visits with the month-over-month change, pages per visit, visit duration, bounce rate, desktop and mobile visits with 6 months of history, the global, country and category rank, Authority Score, backlinks and referring domains with 6 months of history, the top 5 countries, where desktop visitors come from and go next, visits from ChatGPT, Claude, Gemini, Perplexity and other AI sites, organic and paid search traffic, the top organic keywords with volume, CPC and intent, and the closest competitors. The same data is also split into smaller actions (domain_rank, domain_traffic, traffic_by_country, traffic_sources, search_traffic, top_keywords, ai_traffic, backlinks_overview, related_domains). `competitors` returns the full profile of up to 7 competing sites with how many places each moved in the rankings. `top_websites` returns the 100 most visited sites for any of 240 countries (or worldwide) and 111 industries. `organic_summary` returns a domain's US Google organic numbers (keywords it ranks for, monthly organic traffic, what that traffic would cost in Google Ads, Semrush Rank), and `backlink_counts` returns how many backlinks Semrush's live index has for one exact URL, its host and its root domain; both cost 1 credit. `popular_keywords` returns Semrush's lists of the most-searched books, people, foods, beer brands and board games, and `autocomplete` Semrush's search-bar suggestions. Semrush's keyword, backlink, authority, competitor, AI and SEO-audit tools (keyword_overview, keyword_volume, keyword_ideas, keyword_serp, keyword_rank, backlinks, authority_score, organic_competitors, ai_traffic_report, ai_visibility, seo_audit) are available as a limited capacity beta: a successful call costs 5 credits and returns the full report, a busy answer is free and should be retried later. On 2026-11-16 one call per tool succeeded for 0 of 11 tools at 12:32 UTC, 4 of 11 at 13:08 and 5 of 11 at 13:45.
What a Semrush field actually contains
Fields that read differently from how they look. Every row was measured against live semrush.com pages on 2026-11-15.
| Field | What it holds |
|---|---|
| visits, traffic.* | Semrush's estimate for one month (data_date; October 2026 on 2026-11-15). The numbers the Semrush page prints for the same domain matched the API on 292 of 292 checked values across 12 domains. |
| rank.global.change_direction | domain_overview tells only the direction of the global and country rank movement (-1 down, 0 same, 1 up). competitors returns the number of places moved: shopify.com global -66, country -43 for October 2026. |
| rank.category.change | Places moved in the category ranking, the same number on the overview and competitors pages (29 of 29 domains). |
| traffic_sources | Desktop visitors only, as the Semrush page labels it. source keeps Semrush's label; channel is Direct, Google organic or Google paid; a plain domain is a referring site (incoming) or the next site visited (outgoing). |
| ai_traffic.platforms | Visits from AI assistants: ChatGPT appeared for 32 of 32 sites, Gemini 31, Claude 25, Perplexity 19. non_ai_share_percent is all other traffic (99.677 % for shopify.com). |
| top_keywords.keywords[].intents | Search intent: commercial, informational, navigational, transactional; a keyword can have two. An empty list means Semrush published no intent code for it. |
| *_percent | Always a percentage: 45.28 means 45.28 %. *_change_percent is month over month. |
| site_audit, site_health | Filled only when Semrush's domain page carries audit figures; on 2026-11-15 it did for none of the 32 sites measured. |
| organic_summary.* | Semrush's US database only (the source takes no country). organic_keywords and organic_traffic were identical to Semrush's own Competitor Finder for 10 of 10 domains on 2026-11-16. A subdomain is counted as its registrable domain: blog.hubspot.com returns hubspot.com. |
| backlink_counts.backlinks_to_url | Counts for that exact URL: https://www.nike.com/ had 3,407,253, http://www.nike.com/ 1,575,011. Without a scheme https:// is used. The index is live, so the root-domain total runs ahead of the monthly backlinks_overview (shopify.com 1,578,516,111 vs 1,530,385,538 for October). |
Semrush keeps a page for root domains with enough traffic. A subdomain, a domain without enough traffic and adult sites (even when they rank in top_websites) return NOT_FOUND.
Real request and response JSON
Captured from the indexed primary action, domain_overview, on .
{
"method": "POST",
"url": "https://api.reefapi.com/semrush/v1/domain_overview",
"headers": {
"x-api-key": "$REEF_KEY",
"content-type": "application/json"
},
"body": {
"domain": "shopify.com"
}
}{
"ok": true,
"meta": {
"api": "semrush",
"endpoint": "domain_overview",
"mode": "live",
"latency_ms": 535.5,
"record_count": 1,
"bytes": 455116,
"cache_hit": false,
"data_date": "2026-10-15",
"upstream_requests": 1,
"charged_credits": 3,
"version": "0.2.0",
"request_id": "1f76bfaa97ae4f45",
"queue_ms": 1,
"fetched_at": "2026-11-15T18:52:17.641Z"
},
"data": {
"domain": "shopify.com",
"brand_name": "Shopify",
"semrush_url": "https://www.semrush.com/website/shopify.com/overview/",
"favicon": "https://static.semrush.com/power-pages/media/favicons/shopify-com-favicon-4243a4e2.jpg",
"main_country": "US",
"categories": [
{
"slug": "computer-software-and-development",
"name": "Computer Software and Development"
},
{
"slug": "online-services",
"name": "Online Services"
}
],
"rank": {
"global": {
"rank": 132,
"change": null,
"change_direction": -1
},
"country": {
"rank": 114,
"country_code": "US",
"country_name": "United States",
"country_slug": "united-states",
"change": null,
"change_direction": -1
},
"category": {
"rank": 38,
"category_slug": "online-services",
"category_name": "Online Services",
"change": 4
}
},
"authority_score": 85,
"visits": 253067260,
"site_health": null,
"data_date": "2026-10-15",
"updated_at": "2026-11-11",
"no_index": false,
"related_domains": {
"previous": {
"domain": "shopifyacademy.com",
"name": "shopifyacademy.com",
"semrush_url": "https://www.semrush.com/website/shopifyacademy.com/overview/"
},
"next": {
"domain": "shopify.dev",
"name": "shopify.dev",
"semrush_url": "https://www.semrush.com/website/shopify.dev/overview/"
}
},
"page_title": "shopify.com Website Traffic, Ranking, Analytics [October 2026]",
"page_description": "shopify.com is ranked #114 in US with 253.07M Traffic. Categories: Computer Software and Development, Online Services. Learn more about website traffic, market share, and more!",
"traffic": {
"date": "2026-10-01",
"visits": 253067260,
"visits_change_percent": -49.22,
"pages_per_visit": 9.17,
"pages_per_visit_change_percent": null,
"avg_visit_duration_seconds": 1041,
"avg_visit_duration_change_percent": null,
"bounce_rate_percent": 45.28,
"bounce_rate_change_percent": null,
"visits_history": [
{
"date": "2026-10-01",
"visits": 253067260
},
{
"date": "2026-09-01",
"visits": 498343165
},
{
"date": "2026-08-01",
"visits": 422836071
}
]
},
"traffic_by_device": {
"date": "2026-10-01",
"visits": 253067260,
"desktop_visits": 162962161,
"mobile_visits": 90105099,
"desktop_share_percent": 64.39,
"mobile_share_percent": 35.61,
"history": [
{
"date": "2026-10-01",
"visits": 253067260,
"desktop_visits": 162962161,
"mobile_visits": 90105099
},
{
"date": "2026-09-01",
"visits": 498343165,
"desktop_visits": 316741327,
"mobile_visits": 181601838
},
{
"date": "2026-08-01",
"visits": 422836071,
"desktop_visits": 242462879,
"mobile_visits": 180373192
}
]
},
"traffic_by_country": {
"date": "2026-10-01",
"countries": [
{
"country_code": "US",
"country_name": "United States",
"country_slug": "united-states",
"visits": 65467711,
"share_percent": 25.87,
"desktop_share_percent": 58.12,
"mobile_share_percent": 41.88
},
{
"country_code": "IN",
"country_name": "India",
"country_slug": "india",
"visits": 29029472,
"share_percent": 11.47,
"desktop_share_percent": 55.89,
"mobile_share_percent": 44.11
},
{
"country_code": "GB",
"country_name": "United Kingdom",
"country_slug": "united-kingdom",
"visits": 18933514,
"share_percent": 7.48,
"desktop_share_percent": 42.66,
"mobile_share_percent": 57.34
}
]
},
"traffic_sources": {
"date": "2026-10-15",
"device": "desktop",
"incoming_total": null,
"incoming": [
{
"source": "Direct",
"domain": null,
"channel": "Direct",
"share_percent": 46.909,
"visits": 76443853,
"previous_visits": 75801445,
"semrush_url": null,
"hosts": [
"[trimmed-depth]"
]
},
{
"source": "google.com__Google organic",
"domain": "google.com",
"channel": "Google organic",
"share_percent": 3.7456,
"visits": 6103926,
"previous_visits": 6073294,
"semrush_url": null,
"hosts": [
"[trimmed-depth]"
]
},
{
"source": "mail.google.com",
"domain": "mail.google.com",
"channel": null,
"share_percent": 1.2786,
"visits": 2083628,
"previous_visits": 2166133,
"semrush_url": null,
"hosts": [
"[trimmed-depth]"
]
}
],
"outgoing_total": null,
"outgoing": [
{
"source": "google.com",
"domain": "google.com",
"channel": null,
"share_percent": 5.7279,
"visits": 1031220,
"previous_visits": 1043656,
"semrush_url": "https://www.semrush.com/website/google.com/overview/",
"hosts": [
"[trimmed-depth]"
]
},
{
"source": "paypal.com",
"domain": "paypal.com",
"channel": null,
"share_percent": 5.0862,
"visits": 915700,
"previous_visits": 958062,
"semrush_url": "https://www.semrush.com/website/paypal.com/overview/",
"hosts": [
"[trimmed-depth]"
]
},
{
"source": "storage.googleapis.com",
"domain": "storage.googleapis.com",
"channel": null,
"share_percent": 4.2267,
"visits": 760947,
"previous_visits": 678874,
"semrush_url": null,
"hosts": [
"[trimmed-depth]"
]
}
],
"hosts": [
"shopify.com"
]
},
"ai_traffic": {
"date": "2026-10-01",
"platforms": [
{
"domain": "chatgpt.com",
"name": "ChatGPT",
"visits": 205119,
"share_percent": 0.134,
"history": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
]
},
{
"domain": "claude.ai",
"name": "Claude",
"visits": 132135,
"share_percent": 0.086,
"history": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
]
},
{
"domain": "buildyourstore.ai",
"name": null,
"visits": 60786,
"share_percent": 0.04,
"history": [
"[trimmed-depth]",
"[trimmed-depth]",
"[trimmed-depth]"
]
}
],
"ai_visits_listed": 456642,
"non_ai_visits": 153042648,
"non_ai_share_percent": 99.677
},
"search_traffic": {
"date": "2026-10-15",
"organic_visits": 9184169,
"organic_change_percent": -7.48,
"paid_visits": 711012,
"paid_change_percent": -38.31,
"history": [
{
"date": "2026-10-15",
"organic_visits": 9184169,
"paid_visits": 711012,
"total_visits": 9895181
},
{
"date": "2026-09-15",
"organic_visits": 9926779,
"paid_visits": 1152520,
"total_visits": 11079299
},
{
"date": "2026-08-15",
"organic_visits": 9428288,
"paid_visits": 1661988,
"total_visits": 11090276
}
]
},
"top_keywords": {
"date": "2026-10-15",
"database": "US",
"keywords": [
{
"keyword": "shopify",
"position": 1,
"search_volume": 1220000,
"cpc_usd": 8.02,
"intents": [
"[trimmed-depth]"
],
"intent_codes": "1",
"traffic_share_percent": 33.68
},
{
"keyword": "shopify login",
"position": 1,
"search_volume": 246000,
"cpc_usd": 1.45,
"intents": [],
"intent_codes": null,
"traffic_share_percent": 6.79
},
{
"keyword": "shopify admin",
"position": 1,
"search_volume": 40500,
"cpc_usd": 3.64,
"intents": [
"[trimmed-depth]"
],
"intent_codes": "2",
"traffic_share_percent": 1.11
}
]
},
"backlinks": {
"date": "2026-10-01",
"authority_score": 85,
"backlinks": 1530385538,
"backlinks_change_percent": 13.08,
"referring_domains": 4785673,
"referring_domains_change_percent": 0.29,
"google_penalty_risk": "Low",
"backlinks_history": [
{
"date": "2026-10-01",
"backlinks": 1530385538
},
{
"date": "2026-09-01",
"backlinks": 1353424662
},
{
"date": "2026-08-01",
"backlinks": 1199919767
}
],
"referring_domains_history": [
{
"date": "2026-10-01",
"referring_domains": 4785673
},
{
"date": "2026-09-01",
"referring_domains": 4771781
},
{
"date": "2026-08-01",
"referring_domains": 4863722
}
]
},
"competitors": {
"date": "2026-10-15",
"competitors": [
{
"domain": "hulkapps.com",
"relevance_percent": 10,
"visits": 79084,
"favicon": null,
"semrush_url": "https://www.semrush.com/website/hulkapps.com/overview/"
},
{
"domain": "shopify.dev",
"relevance_percent": 8,
"visits": 1245333,
"favicon": null,
"semrush_url": "https://www.semrush.com/website/shopify.dev/overview/"
},
{
"domain": "gempages.net",
"relevance_percent": 7,
"visits": 282258,
"favicon": null,
"semrush_url": "https://www.semrush.com/website/gempages.net/overview/"
}
]
},
"site_audit": null
}
}What the Semrush API does
| Action | Description | Concrete use case | Key params |
|---|---|---|---|
| domain_overview | Everything Semrush publishes for one website in one call: global / country / category rank, Authority Score, monthly visits with month-over-month change, pages per visit, visit duration, bounce rate, 3-month visits, desktop vs mobile with 6-month history, top 5 countries, where desktop visitors come from and go next, visits from AI assistants (ChatGPT, Claude, Gemini, …) with 6-month history, organic vs paid search traffic with history, top organic keywords (volume, CPC, intent, position), backlinks and referring domains with 6-month history, the 3 closest competitors, Semrush's site audit when it has one, and the neighbouring domains Semrush links to. | SEO teams call domain_overview to get everything Semrush publishes for one website in one call. | domain |
| domain_rank | A website's headline numbers: global rank, country rank (in its main country), category rank with its monthly change, Authority Score, monthly visits, categories and brand name (the site description is on `competitors`). Data is Semrush's monthly estimate for the latest month it publishes (`data_date`); the same page also feeds `domain_overview`, which returns every block at once. | Content strategists call domain_rank to get a website's headline numbers. | domain |
| domain_traffic | A website's monthly visits with month-over-month change, pages per visit, average visit duration (seconds), bounce rate, the last 3 months of visits, and desktop vs mobile visits with 6 months of history. Data is Semrush's monthly estimate for the latest month it publishes (`data_date`); the same page also feeds `domain_overview`, which returns every block at once. | Rank trackers call domain_traffic to get a website's monthly visits with month-over-month change, pages per visit, average visit durat…. | domain |
| traffic_by_country | The top 5 countries sending visits to a website: visits, share of all visits, and the desktop / mobile split within each country. Data is Semrush's monthly estimate for the latest month it publishes (`data_date`); the same page also feeds `domain_overview`, which returns every block at once. | AI answer-monitoring tools call traffic_by_country to get the top 5 countries sending visits to a website. | domain |
| traffic_sources | Where a website's DESKTOP visitors come from (Direct, Google organic, referring sites, AI assistants) and where they go next: share, visits this month and last month. Data is Semrush's monthly estimate for the latest month it publishes (`data_date`); the same page also feeds `domain_overview`, which returns every block at once. | SEO teams call traffic_sources to get where a website's DESKTOP visitors come from (Direct, Google organic, referring sites, AI ass…. | domain |
| search_traffic | A website's organic and paid search traffic this month, the month-over-month change of each, and 6 months of history. Data is Semrush's monthly estimate for the latest month it publishes (`data_date`); the same page also feeds `domain_overview`, which returns every block at once. | Content strategists call search_traffic to get a website's organic and paid search traffic this month, the month-over-month change of each,…. | domain |
| top_keywords | The organic keywords sending a website the most traffic in its main country's database (Semrush publishes the top 4-5): Google position, monthly search volume, CPC in USD, search intent and the keyword's share of the site's organic traffic. Data is Semrush's monthly estimate for the latest month it publishes (`data_date`); the same page also feeds `domain_overview`, which returns every block at once. | Rank trackers call top_keywords to get the organic keywords sending a website the most traffic in its main country's database (Semru…. | domain |
| ai_traffic | Visits a website receives from AI assistants (ChatGPT, Claude, Gemini, Perplexity, Copilot and smaller AI sites): visits and share of all traffic per platform, with 6 months of history, plus the remaining non-AI traffic. Data is Semrush's monthly estimate for the latest month it publishes (`data_date`); the same page also feeds `domain_overview`, which returns every block at once. | AI answer-monitoring tools call ai_traffic to get visits a website receives from AI assistants (ChatGPT, Claude, Gemini, Perplexity, Copilot an…. | domain |
| backlinks_overview | A website's backlink profile: total backlinks and referring domains with their monthly change, Authority Score, and 6 months of history for both. Data is Semrush's monthly estimate for the latest month it publishes (`data_date`); the same page also feeds `domain_overview`, which returns every block at once. | SEO teams call backlinks_overview to get a website's backlink profile. | domain |
| competitors | A website and its closest competitors (the sites its audience also visits), each with global / country / category rank and the real monthly rank movement, Authority Score, visits with month-over-month change, pages per visit, visit duration, bounce rate, brand and description; plus each one's share of the group's visits and, for the top 3, Semrush's audience-overlap relevance. | Content strategists call competitors to get a website and its closest competitors (the sites its audience also visits), each with global…. | domain |
| related_domains | The neighbouring domains Semrush links from a website's page (previous / next in its index, usually the same brand's other sites) and the 3 closest competitors with their audience-overlap relevance and visits. Data is Semrush's monthly estimate for the latest month it publishes (`data_date`); the same page also feeds `domain_overview`, which returns every block at once. | Rank trackers call related_domains to get the neighbouring domains Semrush links from a website's page (previous / next in its index, u…. | domain |
| top_websites | Semrush's Top 100 most-visited websites for a country (or worldwide) and an industry: rank, monthly visits, desktop and mobile visits and share, month-over-month and year-over-year change and the main traffic source, plus the whole market's monthly visits for the last 12 months. Can be re-sorted like the site's own table. | AI answer-monitoring tools call top_websites to get semrush's Top 100 most-visited websites for a country (or worldwide) and an industry. | country, category, sort |
| top_website_categories | Every industry `top_websites` accepts: slug and display name (111 incl. `all`). | SEO teams call top_website_categories to get every industry `top_websites` accepts. | none |
| top_website_countries | Every country `top_websites` accepts: 2-letter code and name (240 incl. `global`). | Content strategists call top_website_countries to get every country `top_websites` accepts. | none |
| popular_keywords | Semrush's 'Most Popular' lists: the most-Googled books, people, foods, beer brands or board games worldwide, each with monthly search volume, keyword difficulty (0-100), CPC in USD and rank, plus the list's total monthly searches and Semrush's own refresh dates. The whole list (340-440 keywords) comes in one response; `offset` / `limit` page through it. | Rank trackers call popular_keywords to get semrush's 'Most Popular' lists. | category, sort, offset, limit |
| autocomplete | Semrush's search-bar suggestions: 10 keywords (or 10 domains) starting with what you type. | AI answer-monitoring tools call autocomplete to get semrush's search-bar suggestions. | query, type |
| organic_summary | A domain's Google organic search summary in Semrush's US database: how many keywords it ranks for, its estimated monthly organic traffic, what that traffic would cost in Google Ads (USD), and its Semrush Rank (domains ordered by US organic traffic; 1 = most). Live from Semrush's public SEOquake endpoint, one small request (~190 bytes). The keyword and traffic numbers are the same Semrush shows in its own Organic Research / Competitor Finder (measured 2026-11-16: 10 of 10 domains identical to the unit). US database only — the endpoint takes no country. A subdomain is counted as its registrable domain. | SEO teams call organic_summary to get a domain's Google organic search summary in Semrush's US database. | domain |
| backlink_counts | How many backlinks Semrush's live backlink index has for one exact URL, for its hostname and for its root domain. Live from Semrush's public SEOquake endpoint, one small request (~260 bytes), so it works for any page, not only for domains with a Semrush website page. Counts only: no referring-domain count, Authority Score or link list (those are in `backlinks_overview`, from the monthly domain page). The index is live, so the root-domain total runs ahead of the monthly snapshot in `backlinks_overview` (shopify.com: 1 578 516 111 here on 2026-11-16 vs 1 573 209 887 in Semrush's Authority Checker for November and 1 530 385 538 on the October domain page). | Content strategists call backlink_counts to get how many backlinks Semrush's live backlink index has for one exact URL, for its hostname and…. | url |
| keyword_overview | Semrush Keyword Overview for any keyword in one country database: monthly search volume, keyword difficulty (0-100), CPC (USD), search intent, number of results, search volume in the top countries, whether Google shows an AI Overview, the Google top results (URL, domain, Authority Score, referring domains, backlinks, the URL's own keyword count and estimated traffic) grouped by SERP feature, and related keywords with their volume, KD, CPC and intent. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | Rank trackers call keyword_overview to get semrush Keyword Overview for any keyword in one country database. | keyword, database |
| keyword_volume | Semrush Keyword Search Volume Checker: monthly volume, KD, CPC, intent and volume by country for one keyword, with the Google results grouped by SERP feature and related keywords. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | AI answer-monitoring tools call keyword_volume to get semrush Keyword Search Volume Checker. | keyword, database |
| keyword_ideas | Semrush Keyword Magic ideas for a seed keyword: 25 related keywords with search volume, KD, CPC and intent, plus how many related keywords Semrush knows in total, their combined volume and how many have low competition. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | SEO teams call keyword_ideas to get semrush Keyword Magic ideas for a seed keyword. | keyword, database |
| keyword_serp | The Google results page Semrush recorded for a keyword in one country database, grouped by SERP feature (organic, AI Overview, video, People also ask, forums …) with each URL's Authority Score, backlinks, referring domains and traffic, the number of results, and 30 days of SERP volatility. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | Content strategists call keyword_serp to get the Google results page Semrush recorded for a keyword in one country database, grouped by SE…. | keyword, database |
| keyword_rank | Where a domain ranks on Google for a keyword in one country database: its position, ranking URL and that URL's traffic, Authority Score, backlinks and referring domains; the keyword's volume, KD and CPC; the domain's other top keywords; and the full results page by SERP feature. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | Rank trackers call keyword_rank to get where a domain ranks on Google for a keyword in one country database. | domain, keyword, database |
| backlinks | A domain's backlink totals (backlinks, referring domains, Authority Score, dofollow share) and its top backlinks as Semrush lists them: source URL, page title, anchor, target URL, page score, nofollow, new / lost flags. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | AI answer-monitoring tools call backlinks to get a domain's backlink totals (backlinks, referring domains, Authority Score, dofollow share) an…. | domain |
| authority_score | A domain's Authority Score with its monthly change and 12+ months of history, backlinks and referring domains with history, organic traffic, the score's breakdown (link power, natural profile, organic traffic), the most-linked pages and the top competitors by Authority Score. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | SEO teams call authority_score to get a domain's Authority Score with its monthly change and 12+ months of history, backlinks and r…. | domain |
| organic_competitors | A domain's organic search competitors in one country database: each competitor's common keywords, organic keywords, organic traffic and Semrush's competition level. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | Content strategists call organic_competitors to get a domain's organic search competitors in one country database. | domain, database |
| ai_traffic_report | Semrush AI Traffic report for a domain: estimated visits from AI assistants and their share of traffic, AI citations, AI Overview positions and their traffic with history, traffic by AI platform, traffic by channel, the pages AI sends visitors to, and mentions / cited pages per AI platform. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | Rank trackers call ai_traffic_report to get semrush AI Traffic report for a domain. | domain |
| ai_visibility | Semrush AI Visibility for a domain: its AI visibility score and trend, mentions and citations per AI engine, estimated AI audience, competitors' visibility, the pages AI cites, and the topics where the brand performs best. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | AI answer-monitoring tools call ai_visibility to get semrush AI Visibility for a domain. | domain |
| seo_audit | Semrush SEO Checker for one page: overall, on-page, technical, off-page and social scores, every on-page and technical check with its message, the issues found, the domain's top keywords, top pages, competitors and top backlinks, and its social profiles. LIMITED CAPACITY (BETA): this report sits behind Semrush's reCAPTCHA Enterprise score, so a call may return a free busy/blocked error (RATE_LIMITED, retryable, never charged) — retry later. Measured acceptance: 2026-11-15 13:00-19:00 UTC 30 of 31 calls through a warmed browser page, then 0 of 7 pages after 19:05; 2026-11-16 through captcha-solver tokens (3 per call, no browser): 0 of 11 calls at 12:32 UTC, 4 of 11 at 13:08, 5 of 11 at 13:45 (keyword_volume, backlinks, authority_score and seo_audit not yet accepted in those rounds). A call that does succeed returns the full report. | SEO teams call seo_audit to get semrush SEO Checker for one page. | url |
Call domain_overview from your stack
curl -X POST https://api.reefapi.com/semrush/v1/domain_overview \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"domain":"shopify.com"}'import os
import requests
REEF_KEY = os.environ["REEF_KEY"]
r = requests.post(
"https://api.reefapi.com/semrush/v1/domain_overview",
headers={"x-api-key": REEF_KEY},
json={
"domain": "shopify.com"
},
timeout=90,
)
print(r.json()["data"])const res = await fetch("https://api.reefapi.com/semrush/v1/domain_overview", {
method: "POST",
headers: {
"x-api-key": process.env.REEF_KEY,
"content-type": "application/json",
},
body: JSON.stringify({
"domain": "shopify.com"
}),
});
const { ok, data, meta, error } = await res.json();Ask your MCP-connected assistant: call reefapi.semrush.domain_overview with {"domain":"shopify.com"}.Who uses this API and why
- Size a competitor's monthly traffic, engagement and traffic countries before entering a market.
- Track how much traffic a site gets from ChatGPT, Claude, Gemini and Perplexity month by month.
- Enrich a list of company domains with Authority Score, visits and global rank.
- Build a list of the 100 most visited sites for an industry in a country.
- Compare a site with its closest competitors on rank movement, visits and bounce rate.
Questions developers ask before integrating
Is there a Semrush API without a Semrush subscription?
Yes. The semrush API on ReefAPI returns any root domain's monthly visits, global, country and category rank, Authority Score, backlink totals, traffic by country, AI-assistant visits, top keywords and competitors as JSON, read from semrush.com's public pages, with no Semrush account or API units.
Do I need a Semrush account or API units?
No. The data is what semrush.com publishes on its public website pages, read logged out.
Which month is the data for?
The latest month Semrush publishes on its public pages: on 2026-11-15 that was October 2026 (data_date), updated by Semrush on 2026-11-11 (updated_at).
What keyword data does it return?
top_keywords returns volume, CPC and intent for the 4-5 keywords sending a site the most organic traffic. popular_keywords returns Semrush's lists of the most-searched books, people, foods, beer brands and board games (368-499 keywords each). autocomplete returns up to 10 keyword suggestions for what you type. For any keyword you choose, keyword_overview, keyword_volume and keyword_ideas return volume, keyword difficulty, CPC and intent as a limited capacity beta (5 credits per successful call, busy answers free).
How many competitors does competitors return?
Up to 7, as Semrush lists them: 19 of 32 sites measured had 7, the smallest list had 1. Each comes with ranks, Authority Score, visits, engagement and its share of the group's visits; the 3 closest also carry Semrush's audience-overlap relevance.
Which countries and industries does top_websites cover?
240 countries plus worldwide and 111 industries (including all), listed by top_website_countries and top_website_categories. A list holds up to 100 sites; a small country and niche can hold fewer (Tuvalu, gambling: 2).
What does backlinks_overview return?
The backlink totals Semrush publishes on the domain page: backlinks, referring domains and Authority Score, each with 6 months of history. For one exact page or host, backlink_counts returns the live backlink count of the URL, its host and its root domain.
Why did a keyword call return RATE_LIMITED?
The keyword, backlink and audit tools are a limited capacity beta: Semrush serves these reports to only part of the requests, and the share changes by the hour (on 2026-11-16, 0 of 11 tools at 12:32 UTC, 5 of 11 at 13:45). A busy answer is not charged; retry a little later. A successful call costs 5 credits.
How fresh are the popular keyword lists?
As Semrush publishes them: on 2026-11-15 the lists were dated 19-20 March 2026, and the response carries date and next_refresh_date.
What is the Semrush API?
Semrush API is a ReefAPI endpoint group for website traffic, rank, authority score, backlink totals, ai-assistant visits and competitors for any root domain, plus the top 100 websites per country and industry. It returns live JSON through POST requests under /semrush/v1.
Is the Semrush API free to try?
Yes. ReefAPI starts with 1,000 free credits, no card required. Semrush calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Semrush login or account?
No login to Semrush is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Semrush data?
The page example is captured from a live domain_overview call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Semrush API use?
Semrush actions currently cost 1-5 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.