# Semrush API — website traffic, rank, Authority Score, backlinks, AI traffic, competitors, top websites and popular keywords

> 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.
> ReefAPI engine `semrush` · 29 endpoints · clean JSON, no scraping or browsers to manage.

## How to call
- **Endpoint:** `POST https://api.reefapi.com/semrush/v1/<action>` with a JSON body.
- **Auth:** header `x-api-key: <YOUR_REEFAPI_KEY>` — create one free (1,000 credits, no card): https://reefapi.com/signup
- **Response (every call):** `{ ok: boolean, data: ..., meta: { record_count, credits, ... }, error: { code, message } }` — branch on `ok`. Failed calls are free.
- **One key + one shared credit pool** across every ReefAPI API. Per-call credits are listed on each endpoint below.
- **Use it from an AI agent (MCP):** connect `https://api.reefapi.com/mcp` (remote streamable-http). Clients that add connectors by URL, such as ChatGPT and the Claude app, connect with OAuth 2.1 (the user pastes their key once on a ReefAPI page; discovery at `/.well-known/oauth-protected-resource/mcp`). Config files send the key as `Authorization: Bearer <key>`. `?key=<key>` in the URL also works as a last-resort fallback.

## Endpoints

### POST https://api.reefapi.com/semrush/v1/domain_overview — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** domain, brand_name, semrush_url, favicon, main_country, categories[], rank{global{rank, change_direction}, country{rank, change_direction, country_code, country_name}, category{rank, category_slug, category_name, change}}, authority_score, visits, site_health, data_date, updated_at, no_index, related_domains{previous, next}, page_title, page_description, traffic{…}, traffic_by_device{…}, traffic_by_country{…}, traffic_sources{…}, ai_traffic{…}, search_traffic{…}, top_keywords{…}, backlinks{…}, competitors{…}, site_audit (null when Semrush has not audited it)

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/domain_rank — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** domain, brand_name, semrush_url, favicon, main_country, categories[], rank{global, country, category}, authority_score, visits, site_health, data_date, updated_at, no_index

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/domain_traffic — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** headline fields + traffic{date, visits, visits_change_percent, pages_per_visit, avg_visit_duration_seconds, bounce_rate_percent (+ _change_percent each), visits_history[]{date, visits}} + traffic_by_device{date, visits, desktop_visits, mobile_visits, desktop_share_percent, mobile_share_percent, history[]}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/traffic_by_country — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** headline fields + date + countries[]{country_code, country_name, country_slug, visits, share_percent, desktop_share_percent, mobile_share_percent}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/traffic_sources — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** headline fields + date + device (desktop) + incoming[]{source, domain, channel, share_percent, visits, previous_visits, semrush_url, hosts[]} + outgoing[]{same}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/search_traffic — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** headline fields + search_traffic{date, organic_visits, organic_change_percent, paid_visits, paid_change_percent, history[]{date, organic_visits, paid_visits, total_visits}}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/top_keywords — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** headline fields + date + database (country code) + keywords[]{keyword, position, search_volume, cpc_usd, intents[], intent_codes, traffic_share_percent}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/ai_traffic — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** headline fields + date + platforms[]{domain, name, visits, share_percent, history[]{date, visits}} + ai_visits_listed + non_ai_visits + non_ai_share_percent

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/backlinks_overview — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** headline fields + backlinks{date, authority_score, backlinks, backlinks_change_percent, referring_domains, referring_domains_change_percent, google_penalty_risk, backlinks_history[], referring_domains_history[]}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/competitors — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** site{profile} + competitors[]{position, domain, brand_name, semrush_url, favicon, description, main_country, rank{global{rank, change}, country{rank, change, country_code}, category{rank, change}}, authority_score, visits, visits_change_percent, pages_per_visit, avg_visit_duration_seconds, bounce_rate_percent, share_of_group_visits_percent, relevance_percent, data_date}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/related_domains — 3 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** headline fields + related_domains{previous{domain, name, semrush_url}, next{…}} + competitors{date, competitors[]{domain, relevance_percent, visits, favicon, semrush_url}}

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/top_websites — 3 credits
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.

**Parameters:**
- `country` (enum, optional, default "global") — `global` (worldwide) or a 2-letter country code; 240 values, the list `top_website_countries` returns. [one of: ad, ae, af, ag, ai, al, am, ao, aq, ar, as, at, au, aw, ax, az, ba, bb, bd, be, bf, bg, bh, bi, bj, bl, bm, bn, bo, bq, br, bs, bt, bv, bw, by, bz, ca, cc, cd, cf, cg, ch, ci, ck, cl, cm, cn, co, cr, cv, cw, cx, cy, cz, de, dj, dk, dm, do, dz, ec, ee, eg, eh, er, es, et, fi, fj, fk, fm, fo, fr, ga, gb, gd, ge, gf, gg, gh, gi, gl, gm, gn, gp, gq, gr, gs, gt, gu, gw, gy, hk, hm, hn, hr, ht, hu, id, ie, il, im, in, io, iq, is, it, je, jm, jo, jp, ke, kg, kh, ki, km, kn, kr, kw, ky, kz, la, lb, lc, li, lk, lr, ls, lt, lu, lv, ma, mc, md, me, mf, mg, mh, mk, ml, mn, mo, mp, mq, mr, ms, mt, mu, mv, mw, mx, my, mz, na, nc, ne, nf, ng, ni, nl, no, np, nr, nu, nz, om, pa, pe, pf, pg, ph, pk, pl, pm, pr, ps, pt, pw, py, qa, re, ro, rs, ru, rw, sa, sb, sc, se, sg, sh, si, sj, sk, sl, sm, sn, so, sr, ss, st, sv, sx, sz, tc, td, tg, th, tj, tk, tl, tm, tn, to, tr, tt, tv, tw, tz, ua, ug, us, uy, uz, va, vc, ve, vg, vi, vn, vu, wf, ws, global, ye, yt, za, zm, zw]
- `category` (enum, optional, default "all") — `all` or one of Semrush's 110 industries by slug (`online-services`, `retail`, `travel-and-tourism`, …; the list `top_website_categories` returns). [one of: accounting-and-auditing, adult, advertising-and-marketing, aerospace-and-defense, agriculture, airlines, apparel-and-fashion, architecture, automotive, banking, beauty-and-cosmetics, biotech, ceramics-and-pottery, chemicals, civil-engineering, comics-and-animation, computer-and-video-games, computer-hardware, computer-software-and-development, computers-and-electronics, construction-and-maintenance, consulting, consumer-electronics, crafts, customer-services, design, distance-learning, ecology-and-environment, education, entertainment, equipment-and-supplies, events-services, facilities-services, farms-and-ranches, finance, fishery, food-and-beverages, foreign-language, furniture, gambling, government, graphic-design, healthcare, hospitality, human-resources, import-and-export, information-technology, insurance, investment, jewelry-and-luxury-products, legal, libraries, machinery, mail-and-package-delivery, manufacturing, maritime, market-research, mass-media, medical-devices-and-equipment, mental-health, metals-and-mining, military, museums, music, nanotechnology, newspapers, nonprofit-organizations, oil-and-gas, online-services, outsourcing, packaging-and-containers, performing-arts, pharmaceuticals, photography, plastics-and-polymers, political-organizations, printing, public-policy, public-relations, public-safety, public-utility, publishing, real-estate, recreational-facilities, recruitment-and-staffing, reference, religion-and-belief, renewable-energy, restaurants, retail, science, security-products-and-services, social-and-charitable-organizations, sporting-goods, sports, telecom, textiles-and-nonwovens, tobacco, training-and-certification, transportation-and-logistics, travel-and-tourism, tv-and-movies, venture-capital, veterinary, visual-art, warehousing, wellness, wholesalers-and-liquidators, wine-and-spirits, writing-and-editing-services, all]
- `sort` (enum, optional, default "rank") — Row order. `rank` is Semrush's ranking (by visits); the others re-sort the same 100 rows like the site's sortable columns. `rank` stays on every row. [one of: rank, visits_desc, mom_desc, mom_asc, yoy_desc, yoy_asc, desktop_share_desc, mobile_share_desc]

**Returns:** country, country_name, category, category_name, category_id, semrush_url, date, market{visits, yoy_change_percent, complexity, history[]{date, visits}}, websites[]{rank, domain, semrush_url, visits, desktop_visits, mobile_visits, desktop_share_percent, mobile_share_percent, mom_change_percent, yoy_change_percent, top_traffic_source} + count + sort

**Example request body:**
```json
{
  "country": "us",
  "category": "all"
}
```

### POST https://api.reefapi.com/semrush/v1/top_website_categories — 1 credit
Every industry `top_websites` accepts: slug and display name (111 incl. `all`).

**Parameters:** none

**Returns:** categories[]{slug, name, semrush_url} + count

### POST https://api.reefapi.com/semrush/v1/top_website_countries — 1 credit
Every country `top_websites` accepts: 2-letter code and name (240 incl. `global`).

**Parameters:** none

**Returns:** countries[]{country, name, semrush_url} + count

### POST https://api.reefapi.com/semrush/v1/popular_keywords — 3 credits
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.

**Parameters:**
- `category` (enum, required) — Which list. [one of: books, people, foods, beer-brands, board-games]
- `sort` (enum, optional, default "rank") — Row order (the site's own table columns). [one of: rank, volume_desc, kd_desc, kd_asc, cpc_desc]
- `offset` (integer, optional, default 0) — Rows to skip (after sorting).
- `limit` (integer, optional, default 500) — Rows to return; the default returns the whole list.

**Returns:** category, name_singular, name_plural, title, description, semrush_url, date, next_refresh_date, total_searches, total, keywords[]{rank, keyword, search_volume, keyword_difficulty, cpc_usd} + count + offset + limit + has_more + sort

**Example request body:**
```json
{
  "category": "books"
}
```

### POST https://api.reefapi.com/semrush/v1/autocomplete — 1 credit
Semrush's search-bar suggestions: 10 keywords (or 10 domains) starting with what you type.

**Parameters:**
- `query` (string, required) — The text typed so far.
- `type` (enum, optional, default "keywords") — Suggest keywords or domains. [one of: keywords, domains]

**Returns:** query, type, suggestions[]{keyword} | suggestions[]{domain, semrush_url} + count

**Example request body:**
```json
{
  "query": "nike",
  "type": "keywords"
}
```

### POST https://api.reefapi.com/semrush/v1/organic_summary — 1 credit
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.

**Parameters:**
- `domain` (string, required) — A domain (github.com), any subdomain or link to the site. Semrush rolls a subdomain up to its registrable domain (blog.hubspot.com → hubspot.com); the answer's `domain` says which one was counted.

**Returns:** domain, query, database ('us'), organic_keywords, organic_traffic, organic_traffic_cost_usd, semrush_rank, source

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/backlink_counts — 1 credit
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).

**Parameters:**
- `url` (string, required) — Any web page, host or domain as a URL. Semrush counts per EXACT URL: http:// and https:// are different URLs (https://www.nike.com/ ≈ 3.41 M vs http://www.nike.com/ ≈ 1.58 M backlinks, measured), and so are www / non-www. Without a scheme https:// is used. The hostname and root-domain totals are the same for every URL on that host.

**Returns:** url, hostname, root_domain, backlinks_to_url, backlinks_to_hostname, backlinks_to_root_domain, query, source

**Example request body:**
```json
{
  "url": "https://www.nike.com/"
}
```

### POST https://api.reefapi.com/semrush/v1/keyword_overview — 5 credits
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.

**Parameters:**
- `keyword` (string, required) — The keyword, as you would type it into Google (up to 200 characters).
- `database` (string, optional, default "us") — Semrush country database, a 2-letter code: us, uk, de, fr, es, it, br, in, ca, au, tr, jp … (the United Kingdom is `uk`; `gb` is sent as `uk`).

**Returns:** keyword, country, search_volume, keyword_difficulty_index, intent[], cpc, results, global_volume_data[]{country, search_volume}, serp_data[]{position, url, domain, ascore, domains_num, backlinks_num, url_keywords, search_traffic}, grouped_serp_data{<feature>: [{…, position_type, serp_features[]}]}, ai_overview_present, related_keywords[]{keyword, search_volume, keyword_difficulty_index, cpc, intent}, task_uid

**Example request body:**
```json
{
  "keyword": "running shoes"
}
```

### POST https://api.reefapi.com/semrush/v1/keyword_volume — 5 credits
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.

**Parameters:**
- `keyword` (string, required) — The keyword, as you would type it into Google (up to 200 characters).
- `database` (string, optional, default "us") — Semrush country database, a 2-letter code: us, uk, de, fr, es, it, br, in, ca, au, tr, jp … (the United Kingdom is `uk`; `gb` is sent as `uk`).

**Returns:** keyword, country, search_volume, keyword_difficulty_index, intent[], cpc, global_volume_data[], grouped_serp_data{}, ai_overview_present, related_keywords[], task_uid

**Example request body:**
```json
{
  "keyword": "running shoes"
}
```

### POST https://api.reefapi.com/semrush/v1/keyword_ideas — 5 credits
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.

**Parameters:**
- `keyword` (string, required) — The keyword, as you would type it into Google (up to 200 characters).
- `database` (string, optional, default "us") — Semrush country database, a 2-letter code: us, uk, de, fr, es, it, br, in, ca, au, tr, jp … (the United Kingdom is `uk`; `gb` is sent as `uk`).

**Returns:** keyword, country, keyword_data[]{keyword_phrase, search_volume, keyword_difficulty_index, cpc, intent}, keyword_metrics{related_keywords, combined_search_volume, low_competition_keywords, related_keywords_limit_reached}, task_uid

**Example request body:**
```json
{
  "keyword": "running shoes"
}
```

### POST https://api.reefapi.com/semrush/v1/keyword_serp — 5 credits
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.

**Parameters:**
- `keyword` (string, required) — The keyword, as you would type it into Google (up to 200 characters).
- `database` (string, optional, default "us") — Semrush country database, a 2-letter code: us, uk, de, fr, es, it, br, in, ca, au, tr, jp … (the United Kingdom is `uk`; `gb` is sent as `uk`).

**Returns:** keyword, country, positions_type, serp_data{<feature>: [{position, url, domain, ascore, domains_num, backlinks_num, url_keywords, position_type, serp_features[], search_traffic}]}, results, volatility_data[]{display_date, rank}, task_uid

**Example request body:**
```json
{
  "keyword": "running shoes"
}
```

### POST https://api.reefapi.com/semrush/v1/keyword_rank — 5 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.
- `keyword` (string, required) — The keyword, as you would type it into Google (up to 200 characters).
- `database` (string, optional, default "us") — Semrush country database, a 2-letter code: us, uk, de, fr, es, it, br, in, ca, au, tr, jp … (the United Kingdom is `uk`; `gb` is sent as `uk`).

**Returns:** keyword, domain, country, domain_position{position, url, traffic, ascore, backlinks, ref_domains, url_keywords}, keyword_overview{search_volume, keyword_difficulty_index, cpc}, domain_keywords[]{keyword, position, url, traffic, search_volume}, serp_data{<feature>: []}, task_uid

**Example request body:**
```json
{
  "domain": "shopify.com",
  "keyword": "running shoes"
}
```

### POST https://api.reefapi.com/semrush/v1/backlinks — 5 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** domain, display_date, backlinks_overview{total, ascore, domains_num, dofollow_percent}, backlinks_list[]{link, link_title, anchor, target_link, page_score, nofollow, newlink, lostlink}, task_uid

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/authority_score — 5 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** domain, display_date, authority_score{value, value_diff_percent}, backlinks{}, referring_domains{}, traffic_organic{}, authority_score_history[], backlinks_history[], referring_domains_history[], backlink_score_metrics{…}, backlink_indexed_pages[], top_pages_by_backlinks[], top_competitors_by_authority_score[], task_uid

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/organic_competitors — 5 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.
- `database` (string, optional, default "us") — Semrush country database, a 2-letter code: us, uk, de, fr, es, it, br, in, ca, au, tr, jp … (the United Kingdom is `uk`; `gb` is sent as `uk`).

**Returns:** website, country, domain_data[]{competitor_domain, competitor_relevance, common_keywords, organic_keywords, organic_traffic}, task_uid

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/ai_traffic_report — 5 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** domain, display_date, country, summary{estimated_ai_traffic, ai_traffic_share, ai_citations, ai_overview_positions}, ai_traffic_by_platform{}, ai_traffic_history{}, traffic_by_channel{}, ai_overviews{}, top_pages{}, ai_search_visibility{}, task_uid

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/ai_visibility — 5 credits
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.

**Parameters:**
- `domain` (string, required) — A root domain (shopify.com, amazon.co.uk), any link to the site, or a semrush.com/website/<domain>/ link. Semrush keeps a page for root domains with enough traffic only: a subdomain (help.shopify.com), `www.` is dropped for you, and a domain Semrush has no page for returns NOT_FOUND.

**Returns:** domain, AI_visibility_score, visibility_score_trend[], citations, audience, mentions{total, breakdown}, mentions_by_engine[], citations_by_engine[], competitors[], top_cited_pages[], best_performing_topics[], …, task_uid

**Example request body:**
```json
{
  "domain": "shopify.com"
}
```

### POST https://api.reefapi.com/semrush/v1/seo_audit — 5 credits
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.

**Parameters:**
- `url` (string, required) — The page to audit: a full http(s) URL.

**Returns:** url, domain, status, overview{total_score, on_page_seo, technical_seo, off_page_seo, social_media}, on_page_seo{}, technical_seo{}, off_page_seo{}, social_media{}, issues[], keyword_ranking[], top_pages[], competitors_data[], top_backlinks[], page_performance, complete, task_uid

**Example request body:**
```json
{
  "url": "https://www.python.org/"
}
```

## At scale
- **Volume:** 5M+ requests a day, measured at 60 requests a second across the fleet with no
  central bottleneck. Per-key limits are raised for high-volume accounts; volume pricing on request.
- **Missing a source:** tell us a site we do not cover and it becomes an engine. A customer asked
  for bestprice.gr on 21 Sep 2026 and it was in the catalog on 22 Sep.
- **Support:** 2 minute median time from a question in the live chat to the first answer. Setup
  help included, no support tier to buy.
- **One key, one credit pool** across every API. No per-site plans, no separate subscriptions.

## More
- Try it live, no code: https://reefapi.com/playground?engine=semrush
- Human docs page: https://reefapi.com/docs/semrush
- Overview page: https://reefapi.com/semrush-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
