Reef AI: ask for any data. Try it
Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the AhrefsTop API page →
Search & SEO

AhrefsTop API & Scraper

The AhrefsTop API returns ahrefstop.com, Ahrefs' free public ranking of the most visited websites by estimated monthly organic search traffic, as JSON: the worldwide top 1000, the top 100 per country and per category, trending sites, and each domain's traffic history, Domain Rating, linking websites, top keywords and competitors.

6 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 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.

It reads the site logged out. `top_websites` returns the worldwide top 1000 (10 pages of 100), the top 100 of any of 170 countries, the top 100 of any of 25 categories, or a country's top 100 filtered to one category, with each site's rank, rank change against the previous month, category and monthly organic traffic with its change. `trending_websites` returns the 10 biggest climbers and 10 biggest fallers of the same lists. `domain_overview` takes any of the 193,604 domains ahrefstop covers and returns its worldwide, country and category rank, monthly organic traffic and traffic value in US dollars with the full monthly history (up to 137 months, back to June 2015), the number of organic keywords, its top 5 countries with exact traffic and share, its top 5 keywords with volume, traffic and position, up to 5 competitors, 5 similarly ranked sites, Domain Rating and the number of linking websites with their monthly history. `competitors` returns up to 10 organic competitors with rank, traffic, traffic value, pages and Domain Rating. `domain_index` lists every domain ahrefstop has a page for, and `filters` the accepted countries and categories.

Reference

What an AhrefsTop field actually contains

Fields that read differently from how they look. Every row was measured against live ahrefstop.com pages on 2026-11-15 and 2026-11-16.

FieldWhat it holds
traffic, traffic_display, traffic_exactahrefstop prints traffic rounded (40.7M). traffic is that figure expanded, traffic_display the printed text, traffic_exact the unrounded number from the page's own chart for the same month (40,654,334). The exact figure rounded to the printed one on 59 of 59 pages that print traffic.
top_websites traffic in a country listThe site's organic traffic from that country, not worldwide: crunchbase.com shows 239.7K in the Nigeria list and 4.1M on its own page. traffic_scope says which. 84 of 85 country-list rows equalled the traffic from that country on the domain's own page.
rank_change in a country + category listThe list renumbers rank from 1, but the printed change is the site's change in the country ranking (amazon.com: rank 1 in US shopping, "down 1" = US rank 7, down 1). rank_change_scope is country_rank there.
traffic_trend_12mThe last 12 months of the site's traffic scaled from 0 (its lowest month) to 1 (its highest), oldest first. Only the worldwide list prints it; country and category lists return null.
backlink_profile.linking_websitesReferring domains: how many websites link to the domain. Domain Rating and this figure equalled the page's own sentence ("Domain Rating is 92", "linked by 196.5K websites") on 61 of 61 calls. ahrefstop does not publish the backlink count; backlinks is null.
period, latest_history_monthperiod is the data month the domain page prints (October 2026 on 58 of 61 calls). A few pages are older: homedepot.com's page was the August 2026 snapshot. Two small sites print no headline traffic, only the monthly chart, so their traffic is null and their history is returned.
competitors (both actions)Competitor rows carry the figures ahrefstop prints in its competitor lists, which can differ from the competitor's own page: mayoclinic.org showed 133.9M as a competitor of www.nhs.uk and 88.8M on its own page. The domain page's competitor table and the competitors page matched on 122 of 122 rows.
competitors.target.pagesOn the target's own card ahrefstop prints its linking-websites count under "Pages" (26 of 26 measured, e.g. apple.com 4M). The competitor cards print the competitor's pages.
domain (www sites)Most sites are keyed by the bare domain, some by their www host (www.nhs.uk). Both spellings are tried, so nhs.uk and https://www.apple.com/iphone both resolve. A subdomain without its own page (blog.hubspot.com) returns NOT_FOUND.
explicit_contenttrue when ahrefstop shows "Explicit content" in place of the site's description (3 of 61 domain pages).

Traffic is Ahrefs' estimate of monthly organic search visits; traffic value is its estimate in US dollars of what that traffic would cost in ads. Ranks come from the same estimate.

Live example

Real request and response JSON

Captured from the indexed primary action, top_websites, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/ahrefstop/v1/top_websites",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "country": "us"
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "ahrefstop",
    "endpoint": "top_websites",
    "mode": "live",
    "latency_ms": 704.7,
    "record_count": 100,
    "bytes": 891881,
    "cache_hit": false,
    "upstream_requests": 1,
    "charged_credits": 1,
    "version": "0.1.0",
    "request_id": "450df71ff9434710",
    "queue_ms": 1.2,
    "fetched_at": "2026-11-15T22:38:35.117Z"
  },
  "data": {
    "list": {
      "country": "United States",
      "country_iso2": "US",
      "country_slug": "united-states",
      "category": null,
      "category_slug": null,
      "heading": "Top Websites in United States",
      "intro": "The top 100 most visited websites in United States by Ahrefs organic search traffic estimates. Updated monthly."
    },
    "period": "2026-10",
    "list_size": 100,
    "rank_change_scope": "this_list",
    "traffic_scope": "from United States",
    "websites": [
      {
        "rank": 1,
        "rank_change": 2,
        "is_new": false,
        "domain": "reddit.com",
        "website_url": "https://reddit.com",
        "ahrefstop_url": "https://ahrefstop.com/websites/reddit.com",
        "traffic": 858200000,
        "traffic_display": "858.2M",
        "traffic_change": 383000000,
        "traffic_change_display": "+383M",
        "category": "Online Communities",
        "category_slug": "social-networks",
        "traffic_trend_12m": null,
        "favicon_url": "https://www.google.com/s2/favicons?domain=reddit.com&sz=64"
      },
      {
        "rank": 2,
        "rank_change": 2,
        "is_new": false,
        "domain": "youtube.com",
        "website_url": "https://youtube.com",
        "ahrefstop_url": "https://ahrefstop.com/websites/youtube.com",
        "traffic": 763200000,
        "traffic_display": "763.2M",
        "traffic_change": 407000000,
        "traffic_change_display": "+407M",
        "category": "Entertainment",
        "category_slug": "arts-and-entertainment",
        "traffic_trend_12m": null,
        "favicon_url": "https://www.google.com/s2/favicons?domain=youtube.com&sz=64"
      },
      {
        "rank": 3,
        "rank_change": 2,
        "is_new": false,
        "domain": "facebook.com",
        "website_url": "https://facebook.com",
        "ahrefstop_url": "https://ahrefstop.com/websites/facebook.com",
        "traffic": 556500000,
        "traffic_display": "556.5M",
        "traffic_change": 261100000,
        "traffic_change_display": "+261.1M",
        "category": "Online Communities",
        "category_slug": "social-networks",
        "traffic_trend_12m": null,
        "favicon_url": "https://www.google.com/s2/favicons?domain=facebook.com&sz=64"
      }
    ],
    "count": 100,
    "page": 1,
    "page_size": 100,
    "total": 100,
    "total_pages": 1,
    "has_more": false,
    "source_url": "https://ahrefstop.com/websites/united-states"
  }
}
Actions

What the AhrefsTop API does

ActionDescriptionConcrete use caseKey params
top_websitesAhrefs' ranking of the most visited websites by estimated monthly organic search traffic: worldwide (top 1000, 10 pages of 100), per country (top 100, 170 countries), per category (top 100, 25 categories) or country + category (the country's top 100 filtered to one category, e.g. 7 shopping sites in the United States). Each row: rank, rank change vs the previous month (or NEW), domain, category, monthly organic traffic and its change (in a country list: the traffic from that country, `traffic_scope`); worldwide rows also carry the last 12 months of traffic as a 0-1 trend line (country / category lists print none). Country and category lists are one page; only the worldwide list has pages 2-10. In a country + category list the printed rank change is the site's change in the country ranking.SEO teams call top_websites to get ahrefs' ranking of the most visited websites by estimated monthly organic search traffic.country, category, page
trending_websitesThe sites that moved most within a ranking this month, as ahrefstop prints them: the 10 biggest climbers and the 10 biggest fallers within the worldwide top 1000, a country's top 100 or a category's top 100, with rank, positions gained/lost and monthly organic traffic.Content strategists call trending_websites to get the sites that moved most within a ranking this month, as ahrefstop prints them.country, category, direction
domain_overviewEverything ahrefstop publishes for one domain: worldwide / country / category traffic rank with change, monthly organic search traffic and traffic value (USD) with change and the full monthly history (122-137 months measured, back to June 2015), number of organic keywords, the top 5 countries with exact traffic, previous month and share, the top 5 keywords (volume, traffic, position, changes) in the country the page shows, up to 5 organic competitors, the 5 similarly ranked sites, Domain Rating (0-100), linking websites (referring domains) with change and monthly history, the site's name and description, and the page's own data month (`period`; most pages are the latest month, a few are older). Rounded figures are also returned exact where the page's own chart data carries them. The backlink count is not published on ahrefstop.Rank trackers call domain_overview to get everything ahrefstop publishes for one domain.domain
competitorsA domain's organic competitors as ahrefstop lists them (sites ranking in Google's top 10 for the same keywords; up to 10 measured): for the target and each competitor the description, worldwide / country / category rank with change, monthly organic traffic and traffic value (USD) with changes, pages and Domain Rating. Competitor figures are the ones this list prints and can differ from the competitor's own domain page.AI answer-monitoring tools call competitors to get a domain's organic competitors as ahrefstop lists them (sites ranking in Google's top 10 for….domain
domain_indexahrefstop's own index of every domain it has a page for (its sitemap): about 193,600 domains in 10 pages of up to 20,000 (the last page is shorter), in the site's own order (not alphabetical). Optional `query` keeps only domains containing that text. Use it to find which domains domain_overview / competitors can answer.SEO teams call domain_index to get ahrefstop's own index of every domain it has a page for (its sitemap).page, query
filtersThe values the list actions accept: the 170 countries (slug, ISO-2 code, name) and 25 categories (slug, name as the site prints it, other accepted names). No upstream request.Content strategists call filters to get the values the list actions accept.none
Code samples

Call top_websites from your stack

curl -X POST https://api.reefapi.com/ahrefstop/v1/top_websites \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"country":"us"}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.ahrefstop.top_websites with {"country":"us"}.
Use cases

Who uses this API and why

  • Build a list of the 1000 most visited websites, or the top 100 of a country or category, with monthly organic traffic.
  • Track which sites climbed or fell most this month in a country or category.
  • Pull a domain's 11-year monthly organic traffic and traffic-value history for a report.
  • Check Domain Rating and linking websites for a list of prospects or link partners.
  • Find a domain's organic competitors and compare their traffic, pages and Domain Rating.
FAQ

Questions developers ask before integrating

Is there an AhrefsTop API?

Yes. The ahrefstop API on ReefAPI returns ahrefstop.com's top-website lists and domain pages (traffic history, Domain Rating, linking websites, top keywords, competitors) as JSON, read from Ahrefs' free public site logged out, no Ahrefs account needed.

How many websites can I rank?

The worldwide list is the top 1000 in 10 pages of 100; pages 1 to 10 returned ranks 1 to 1000 with no gap or repeat. Each of the 170 countries and 25 categories has a top 100 on one page. A country + category list is that country's top 100 filtered to the category, so it is short: 7 shopping sites in the United States, 12 news sites in Germany, 4 finance sites in the United Kingdom.

Which domains does domain_overview cover?

The 193,604 domains in ahrefstop's own index (domain_index lists them in 10 pages). 61 of 61 calls on 52 of those domains answered, from youtube.com to small sites outside the top 1000. A domain that is not in the index returns NOT_FOUND.

How far back does the traffic history go?

Monthly, back to June 2015: 58 of 61 domain pages had 122 to 137 months, younger sites fewer. Weekly and daily figures are not published.

How many countries and keywords per domain?

The top 5 countries with exact traffic, previous month and share, and the top 5 keywords with volume, traffic and position, in the country the page shows. ahrefstop keeps the rest behind an Ahrefs login, so the API returns those 5.

Is the backlink count included?

No. ahrefstop publishes Domain Rating and the number of linking websites (referring domains) with their monthly history, but not the backlink count.

How many competitors does a domain get?

domain_overview returns the 5 the domain page shows; competitors returns up to 10 with rank, traffic, traffic value, pages and Domain Rating. 23 of 27 domains measured had 10, two had 9, google.com 2 and one small site 1.

How fresh is the data?

ahrefstop updates its lists monthly; on 2026-11-16 the lists and 58 of 61 domain pages were the October 2026 month. Each answer carries the month it describes.

What is the AhrefsTop API?

AhrefsTop API is a ReefAPI endpoint group for ahrefs' public ranking of the most visited websites: worldwide top 1000, top 100 per country and category, trending sites, and per-domain traffic history, domain rating, linking websites, top keywords and competitors. It returns live JSON through POST requests under /ahrefstop/v1.

Is the AhrefsTop API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. AhrefsTop calls use the same shared credit balance as every other ReefAPI engine.

Do I need an AhrefsTop login or account?

No login to AhrefsTop 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 AhrefsTop data?

The page example is captured from a live top_websites call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the AhrefsTop API use?

AhrefsTop actions currently cost 1-3 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call AhrefsTop from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call ahrefstop actions with the same key, credit pool and JSON envelope used by normal REST requests.

docs / ahrefstop

AhrefsTop

Ahrefs' public ranking of the most visited websites: worldwide top 1000, top 100 per country and category, trending sites, and per-domain traffic history, Domain Rating, linking websites, top keywords and competitors.

base /ahrefstop/v16 endpoints
post/ahrefstop/v1/top_websites1 credit

Ahrefs' ranking of the most visited websites by estimated monthly organic search traffic: worldwide (top 1000, 10 pages of 100), per country (top 100, 170 countries), per category (top 100, 25 categories) or country + category (the country's top 100 filtered to one category, e.g. 7 shopping sites in the United States). Each row: rank, rank change vs the previous month (or NEW), domain, category, monthly organic traffic and its change (in a country list: the traffic from that country, `traffic_scope`); worldwide rows also carry the last 12 months of traffic as a 0-1 trend line (country / category lists print none). Country and category lists are one page; only the worldwide list has pages 2-10. In a country + category list the printed rank change is the site's change in the country ranking.

ParameterAllowed / rangeDescription
countryoptionalworldwide · afghanistan · albania · algeria · andorra · angola · antigua-and-barbuda · argentina · armenia · australia · austria · azerbaijan · bahamas · bahrain · bangladesh · belarus · belgium · belize · benin · bhutan · bolivia · bosnia-and-herzegovina · botswana · brazil · brunei-darussalam · bulgaria · burkina-faso · burundi · cambodia · cameroon · canada · cape-verde · central-african-republic · chad · chile · colombia · congo · congo-democratic-republic · costa-rica · cote-divoire · croatia · cyprus · czech-republic · denmark · djibouti · dominican-republic · ecuador · egypt · el-salvador · estonia · ethiopia · fiji · finland · france · gabon · gambia · georgia · germany · ghana · gibraltar · greece · greenland · guadeloupe · guatemala · guernsey · guyana · haiti · honduras · hong-kong · hungary · iceland · india · indonesia · iraq · ireland · isle-of-man · israel · italy · jamaica · japan · jersey · jordan · kazakhstan · kenya · kuwait · kyrgyzstan · lao-peoples-democratic-republic · latvia · lebanon · lesotho · libyan-arab-jamahiriya · liechtenstein · lithuania · luxembourg · madagascar · malawi · malaysia · maldives · mali · malta · mauritius · mexico · moldova · mongolia · montenegro · morocco · mozambique · myanmar · namibia · nepal · netherlands · new-zealand · nicaragua · niger · nigeria · north-macedonia · norway · oman · pakistan · palestine · panama · papua-new-guinea · paraguay · peru · philippines · poland · portugal · puerto-rico · qatar · romania · russian-federation · rwanda · saint-vincent-and-grenadines · saudi-arabia · senegal · serbia · seychelles · sierra-leone · singapore · slovakia · slovenia · somalia · south-africa · korea · spain · sri-lanka · suriname · sweden · switzerland · taiwan · tajikistan · tanzania · thailand · timor-leste · togo · trinidad-and-tobago · tunisia · turkey · turkmenistan · uganda · ukraine · united-arab-emirates · united-kingdom · united-states · uruguay · uzbekistan · venezuela · vietnam · virgin-islands-us · zambia · zimbabweCountry list instead of worldwide: slug (united-states), ISO-2 code (us) or English name (United States). 170 countries.
categoryoptionalall · arts-and-entertainment · autos-and-vehicles · beauty-and-fitness · books-and-literature · business · computers-and-electronics · finance · food-and-drink · games · health · hobbies-and-leisure · home-and-garden · internet-and-telecom · jobs-and-education · law-and-government · news · social-networks · people-and-society · pets-and-animals · real-estate · reference · science · shopping · sports · travel-and-transportationCategory list: slug (shopping) or the name the site prints (Shopping, Online Communities, Entertainment…). 25 categories.
page = 1optional1–10Page of 100 (worldwide list only: 1-10 = ranks 1-1000; country and category lists have a single page).
Try in playground →
post/ahrefstop/v1/domain_overview1 credit

Everything ahrefstop publishes for one domain: worldwide / country / category traffic rank with change, monthly organic search traffic and traffic value (USD) with change and the full monthly history (122-137 months measured, back to June 2015), number of organic keywords, the top 5 countries with exact traffic, previous month and share, the top 5 keywords (volume, traffic, position, changes) in the country the page shows, up to 5 organic competitors, the 5 similarly ranked sites, Domain Rating (0-100), linking websites (referring domains) with change and monthly history, the site's name and description, and the page's own data month (`period`; most pages are the latest month, a few are older). Rounded figures are also returned exact where the page's own chart data carries them. The backlink count is not published on ahrefstop.

ParameterAllowed / rangeDescription
domainrequired—Domain or any link on it (https://www.apple.com/iphone). ahrefstop has pages for ~193,600 of the most visited domains; most are keyed by the bare domain, some by their www host (www.nhs.uk) — both forms are tried.
Try in playground →
post/ahrefstop/v1/competitors1 credit

A domain's organic competitors as ahrefstop lists them (sites ranking in Google's top 10 for the same keywords; up to 10 measured): for the target and each competitor the description, worldwide / country / category rank with change, monthly organic traffic and traffic value (USD) with changes, pages and Domain Rating. Competitor figures are the ones this list prints and can differ from the competitor's own domain page.

ParameterAllowed / rangeDescription
domainrequired—Domain or any link on it (https://www.apple.com/iphone). ahrefstop has pages for ~193,600 of the most visited domains; most are keyed by the bare domain, some by their www host (www.nhs.uk) — both forms are tried.
Try in playground →
post/ahrefstop/v1/domain_index3 credits

ahrefstop's own index of every domain it has a page for (its sitemap): about 193,600 domains in 10 pages of up to 20,000 (the last page is shorter), in the site's own order (not alphabetical). Optional `query` keeps only domains containing that text. Use it to find which domains domain_overview / competitors can answer.

ParameterAllowed / rangeDescription
page = 1optional1–50Index page (1-10 today; `total_pages` says how many exist).
queryoptional—Keep only domains containing this text (case-insensitive).
Try in playground →
post/ahrefstop/v1/filtersfree

The values the list actions accept: the 170 countries (slug, ISO-2 code, name) and 25 categories (slug, name as the site prints it, other accepted names). No upstream request.

Try in playground →
Built for volume
5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?
We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support
2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance
Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.