Semrush API

Any website's traffic, rank, Authority Score and competitors from Semrush, as JSON

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.

endpoints
29
credits per call
1–5

3 credits per call≈ $3/1,000 calls1,000 free credits, no card

POST/semrush/v1/domain_overview200
brand_name

Shopify

authority_score85
domain
shopify.com
main_country
US
visits
253,067,260
data_date
2026-10-15
updated_at
2026-11-11
Real result, captured Nov 15, 2026
Try it live

Run the call yourself, on the real endpoint

Change a parameter and press Try it. The response on the right is what your code will receive.

Semrush API

7 of 29 endpoints, ready to run

View docs ↗

Everything Semrush publishes for one website

3 credits1 required · 0 optional
POST/semrush/v1/domain_overview
idle
// Press "Try it" and this pane shows exactly what the
// live site returned this second — including an empty
// result, if that is the truth. No key, no account.

Try every endpoint in the playground

Endpoints

What Semrush endpoints does ReefAPI ship?

29 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.

29 endpoints

domain_overview

3 cr

Everything Semrush publishes for one website in one call.

required
domain
optional
—

domain_rank

3 cr

A website's headline numbers.

required
domain
optional
—

domain_traffic

3 cr

A website's monthly visits with month-over-month change, pages per visit, average visit durat…

required
domain
optional
—

traffic_by_country

3 cr

The top 5 countries sending visits to a website.

required
domain
optional
—

traffic_sources

3 cr

Where a website's DESKTOP visitors come from (Direct, Google organic, referring sites, AI ass…

required
domain
optional
—

search_traffic

3 cr

A website's organic and paid search traffic this month, the month-over-month change of each,…

required
domain
optional
—

top_keywords

3 cr

The organic keywords sending a website the most traffic in its main country's database (Semru…

required
domain
optional
—

ai_traffic

3 cr

Visits a website receives from AI assistants (ChatGPT, Claude, Gemini, Perplexity, Copilot an…

required
domain
optional
—

backlinks_overview

3 cr

A website's backlink profile.

required
domain
optional
—

competitors

3 cr

A website and its closest competitors (the sites its audience also visits), each with global…

required
domain
optional
—

related_domains

3 cr

The neighbouring domains Semrush links from a website's page (previous / next in its index, u…

required
domain
optional
—

top_websites

3 cr

Semrush's Top 100 most-visited websites for a country (or worldwide) and an industry.

required
—
optional
country, category, sort

top_website_categories

1 cr

Every industry top_websites accepts.

required
—
optional
—

top_website_countries

1 cr

Every country top_websites accepts.

required
—
optional
—

popular_keywords

3 cr

Semrush's 'Most Popular' lists.

required
category
optional
sort, offset, limit

autocomplete

1 cr

Semrush's search-bar suggestions.

required
query
optional
type

organic_summary

1 cr

A domain's Google organic search summary in Semrush's US database.

required
domain
optional
—

backlink_counts

1 cr

How many backlinks Semrush's live backlink index has for one exact URL, for its hostname and…

required
url
optional
—

keyword_overview

5 cr

Semrush Keyword Overview for any keyword in one country database.

required
keyword
optional
database

keyword_volume

5 cr

Semrush Keyword Search Volume Checker.

required
keyword
optional
database

keyword_ideas

5 cr

Semrush Keyword Magic ideas for a seed keyword.

required
keyword
optional
database

keyword_serp

5 cr

The Google results page Semrush recorded for a keyword in one country database, grouped by SE…

required
keyword
optional
database

keyword_rank

5 cr

Where a domain ranks on Google for a keyword in one country database.

required
domain, keyword
optional
database

backlinks

5 cr

A domain's backlink totals (backlinks, referring domains, Authority Score, dofollow share) an…

required
domain
optional
—

authority_score

5 cr

A domain's Authority Score with its monthly change and 12+ months of history, backlinks and r…

required
domain
optional
—

organic_competitors

5 cr

A domain's organic search competitors in one country database.

required
domain
optional
database

ai_traffic_report

5 cr

Semrush AI Traffic report for a domain.

required
domain
optional
—

ai_visibility

5 cr

Semrush AI Visibility for a domain.

required
domain
optional
—

seo_audit

5 cr

Semrush SEO Checker for one page.

required
url
optional
—

Every parameter, every allowed value →

Missing a Semrush endpoint, or need a source we don't have yet?Contact us real people · same-day reply.
How it works

How the Semrush API works

Semrush is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.

01
Authenticate
x-api-key header

No OAuth app, no request signing, no per-site account. One key covers all 694 engines.

02
Call
POST /semrush/v1/…

Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.

03
Pay
1 or 3 or 5 credits per call

Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.

04
Read
{ ok, data, meta, error }

One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.

Recipe

From an industry to each site's traffic and competitors

List the biggest sites in an industry, then read each one's traffic profile and competitors.

01top_websites?country=us&category=retail
GET/semrush/v1/top_websites?country=us&category=retail

100 sites with monthly visits, desktop and mobile share, month-over-month and year-over-year change and main traffic source.

02domain_rank?domain=ebay.com
GET/semrush/v1/domain_rank?domain=ebay.com

Global, country and category rank, Authority Score and visits, one domain per call.

03domain_overview?domain=temu.com
GET/semrush/v1/domain_overview?domain=temu.com

Engagement, devices, countries, traffic sources, AI-assistant visits, search traffic, top keywords and backlink totals.

04competitors?domain=temu.com
GET/semrush/v1/competitors?domain=temu.com

Up to 7 competing sites with ranks, rank movement, visits and engagement.

A monthly market map: the leading sites of an industry, how much traffic each gets and from where, and who they compete with.

request
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"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "semrush",
    "endpoint": "domain_overview",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

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.

FieldWhat 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_directiondomain_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.changePlaces moved in the category ranking, the same number on the overview and competitors pages (29 of 29 domains).
traffic_sourcesDesktop 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.platformsVisits 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[].intentsSearch intent: commercial, informational, navigational, transactional; a keyword can have two. An empty list means Semrush published no intent code for it.
*_percentAlways a percentage: 45.28 means 45.28 %. *_change_percent is month over month.
site_audit, site_healthFilled 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_urlCounts 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.

Coverage

Semrush coverage, measured

The first six rows were read from live semrush.com pages on 2026-11-15, in two runs of 416 and 434 calls; the last two rows were measured on 2026-11-16.

Success

Second run: every action answered on every call (352 of 352 domain calls over 32 domains, 22 of 22 top_websites lists, 25 of 25 autocomplete calls); all 12 error cases returned the expected error code.

Accuracy

292 of 292 values the Semrush page prints (ranks, Authority Score, visits, engagement, country rows, keyword rows, competitor visits) matched the API on 12 domains. top_websites rows and the same domains' own pages carried identical visits on 7 of 7 domains with a page.

Domains

Root domains with a Semrush page: 32 of 32 well-known sites tested had one. Subdomains, low-traffic domains and adult sites return NOT_FOUND.

Top websites

240 countries plus worldwide × 111 industries; up to 100 sites per list (worldwide, all industries: 215.6 billion visits a month for the listed market; US retail: 3.66 billion).

Speed

Median 0.7-0.9 s per domain action.

Limits

Top keywords stop at 5 per site, country rows at 5, competitors at 7, autocomplete at 10. Popular keyword lists were last refreshed by Semrush in March 2026.

Organic summary and backlink counts

150 of 150 calls answered over five rounds in 11 hours (2026-11-15 22:02 to 2026-11-16 09:37 UTC), 0.4-0.6 s median. organic_summary keyword and traffic numbers were identical to Semrush's own Competitor Finder for 10 of 10 domains. 1 credit each.

Keyword, backlink and audit tools (beta)

keyword_overview, keyword_volume, keyword_ideas, keyword_serp, keyword_rank, backlinks, authority_score, organic_competitors, ai_traffic_report, ai_visibility and seo_audit run as a limited capacity beta: a successful call costs 5 credits and returns the full report, a busy answer (RATE_LIMITED) is free. 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; keyword_volume, backlinks, authority_score and seo_audit were not accepted in those rounds.

Use cases

What people build with Semrush

The jobs this data is most often used for.

29

endpoints

1/3/5

credits per call

01

Size a competitor's monthly traffic, engagement and traffic countries before entering a market.

02

Track how much traffic a site gets from ChatGPT, Claude, Gemini and Perplexity month by month.

03

Enrich a list of company domains with Authority Score, visits and global rank.

04

Build a list of the 100 most visited sites for an industry in a country.

Pricing

What Semrush data costs

The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.

Full pricing →
$0.67–$1.50 / 1,000 credits
  • 1,000 free credits on signup, no card
  • One key, all 694 APIs, one credit pool
  • Failed and blocked calls are never charged
  • Credits roll over and never expire
no credit card1,000 free credits · instant API key · pay by card or crypto
Quickstart

Call it in two lines

Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.

curl
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"}'
python
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"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Semrush.

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.

Same key

16 Search & SEO APIs on the same key

One key, one credit pool, one response envelope. If you are pulling Semrush, you are one call away from the rest of the category — no second contract, no second integration.

Contact

Need something this API does not do?

Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.

0/4000

No account needed · we reply from [email protected]

Try it on your own data before you pay anything

The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 693 APIs, and the same envelope everywhere.

Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-11-16.