Reef AI: ask for any data. Try it
AhrefsTop API

The most visited websites by country and category, with each domain's traffic, Domain Rating and competitors

endpoints
6
credits per call
0–3

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.

/ahrefstop/v1

  • POST/ahrefstop/v1/top_websites1 credit
  • POST/ahrefstop/v1/trending_websites1 credit
  • POST/ahrefstop/v1/domain_overview1 credit
  • POST/ahrefstop/v1/competitors1 credit
  • POST/ahrefstop/v1/domain_index3 credits
  • POST/ahrefstop/v1/filters0 credits
6 active endpoints, on 0, 1 and 3 credit tiers.Every parameter ↓OpenAPI 3.0 spec ↗

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

Get a free API key
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.

AhrefsTop API

4 of 6 endpoints, ready to run

View docs ↗

Top websites worldwide, by country or by category

1 credit0 required · 3 optional
POST/ahrefstop/v1/top_websites
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 AhrefsTop endpoints does ReefAPI ship?

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

  • top_websites

    1 cr

    Ahrefs' ranking of the most visited websites by estimated monthly organic search traffic.

    required
    —
    optional
    country, category, page
  • trending_websites

    1 cr

    The sites that moved most within a ranking this month, as ahrefstop prints them.

    required
    —
    optional
    country, category, direction
  • domain_overview

    1 cr

    Everything ahrefstop publishes for one domain.

    required
    domain
    optional
    —
  • competitors

    1 cr

    A domain's organic competitors as ahrefstop lists them (sites ranking in Google's top 10 for…

    required
    domain
    optional
    —
  • domain_index

    3 cr

    ahrefstop's own index of every domain it has a page for (its sitemap).

    required
    —
    optional
    page, query
  • filters

    0 cr

    The values the list actions accept.

    required
    —
    optional
    —

Every parameter, every allowed value →

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

How the AhrefsTop API works

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

Authenticate01
x-api-key header

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

Call02
POST /ahrefstop/v1/…

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

Pay03
0 or 1 or 3 credits per call

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

Read04
{ ok, data, meta, error }

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

Recipe

From a country's top sites to one domain's traffic and competitors

List the leading sites of a market, open one, then see who it competes with.

01top_websites?country=us&category=shopping
GET/ahrefstop/v1/top_websites?country=us&category=shopping

The 7 shopping sites in the United States top 100 (amazon.com, walmart.com, ebay.com, target.com, etsy.com, bestbuy.com, costco.com) with their US organic traffic and rank change.

02domain_overview?domain=amazon.com
GET/ahrefstop/v1/domain_overview?domain=amazon.com

Worldwide, country and category rank, monthly traffic and traffic value back to 2015, top 5 countries and keywords, Domain Rating and linking websites.

03competitors?domain=amazon.com
GET/ahrefstop/v1/competitors?domain=amazon.com

Up to 10 organic competitors with rank, traffic, traffic value, pages and Domain Rating.

A market's leading sites, one site's full traffic and link profile, and the competitors to compare it with.

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

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.

Coverage

AhrefsTop coverage, measured

Every number below was read from live ahrefstop.com pages on 2026-11-15 and 2026-11-16.

Lists

46 of 46 list calls answered: the worldwide top 1000 (ranks 1 to 1000 across 10 pages, no gap or repeat), 16 country lists of 100, 11 category lists of 100 and 8 country + category lists of 4 to 13 sites. 170 countries and 25 categories are available.

Domains

61 of 61 domain_overview calls answered on 52 domains, from rank 1 to sites outside the top 1000; 27 of 27 competitors calls. ahrefstop's index holds 193,604 domains.

Accuracy

Domain Rating, linking websites and traffic equalled the page's own sentences on 181 of 181 checks; exact traffic rounded to the printed figure on 59 of 59 pages; country-list traffic equalled the domain page's traffic from that country on 84 of 85 rows (the other domain page was an older month).

History

Monthly organic traffic and traffic value back to June 2015 (122 to 137 months on 58 of 61 pages) and the monthly linking-websites series (google.com: from April 2015).

Per domain

Top 5 countries, top 5 keywords, up to 5 competitors and 5 similarly ranked sites on the domain page; up to 10 competitors on the competitors page.

Limits

No backlink count, no countries or keywords beyond the top 5, no weekly or daily figures and no site search; ahrefstop does not publish them logged out. Country and category lists stop at 100 sites, the worldwide list at 1000.

Use cases

What people build with AhrefsTop

The jobs this data is most often used for.

01

Build a list of the 1000 most visited websites, or the top 100 of a country or category, with monthly organic traffic.

02

Track which sites climbed or fell most this month in a country or category.

03

Pull a domain's 11-year monthly organic traffic and traffic-value history for a report.

04

Check Domain Rating and linking websites for a list of prospects or link partners.

6

endpoints

0/1/3

credits per call

Pricing

What AhrefsTop data costs

The cheapest call here is 0 credits, 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.

$0.67–$1.50 / 1,000 credits
Full pricing →
  • 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/ahrefstop/v1/top_websites \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"country":"us"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/ahrefstop/v1/top_websites",
    headers={"x-api-key": REEF_KEY},
    json={
        "country": "us"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up AhrefsTop.

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.

Same key

16 Search & SEO APIs on the same key

One key, one credit pool, one response envelope. If you are pulling AhrefsTop, 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.