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
Shopify
- domain
- shopify.com
- main_country
- US
- visits
- 253,067,260
- data_date
- 2026-10-15
- updated_at
- 2026-11-11
29 active endpoints, on 1, 3 and 5 credit tiers.
- POST/semrush/v1/domain_overview3 credits
- POST/semrush/v1/domain_rank3 credits
- POST/semrush/v1/domain_traffic3 credits
- POST/semrush/v1/traffic_by_country3 credits
- POST/semrush/v1/traffic_sources3 credits
- POST/semrush/v1/search_traffic3 credits
- POST/semrush/v1/top_keywords3 credits
- POST/semrush/v1/ai_traffic3 credits
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
Everything Semrush publishes for one website
// 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.
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.
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 the Semrush API works
Semrush is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 694 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and nothing is cached: every call reads the source live.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
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.
100 sites with monthly visits, desktop and mobile share, month-over-month and year-over-year change and main traffic source.
Global, country and category rank, Authority Score and visits, one domain per call.
Engagement, devices, countries, traffic sources, AI-assistant visits, search traffic, top keywords and backlink totals.
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.
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"}'{
"ok": true,
"data": { … },
"meta": {
"api": "semrush",
"endpoint": "domain_overview",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}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.
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.
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.
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.
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.
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).
Median 0.7-0.9 s per domain action.
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.
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_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.
What people build with Semrush
The jobs this data is most often used for.
endpoints
credits per call
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.
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.
- 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
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 -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"])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.
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.
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.
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.