# AhrefsTop API — most visited websites by Ahrefs organic traffic: worldwide top 1000, top 100 per country and category, trending sites, domain traffic history, Domain Rating, linking websites, top keywords and competitors

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

## How to call
- **Endpoint:** `POST https://api.reefapi.com/ahrefstop/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/ahrefstop/v1/top_websites — 1 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.

**Parameters:**
- `country` (enum, optional) — Country list instead of worldwide: slug (united-states), ISO-2 code (us) or English name (United States). 170 countries. [one of: worldwide, 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, zimbabwe]
- `category` (enum, optional) — Category list: slug (shopping) or the name the site prints (Shopping, Online Communities, Entertainment…). 25 categories. [one of: all, 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-transportation]
- `page` (integer, optional, default 1) — Page of 100 (worldwide list only: 1-10 = ranks 1-1000; country and category lists have a single page).

**Returns:** list{country, country_iso2, country_slug, category, category_slug, heading, intro}, period, list_size, rank_change_scope, traffic_scope, websites[]{rank, rank_change, is_new, domain, website_url, ahrefstop_url, category, category_slug, traffic, traffic_display, traffic_change, traffic_change_display, traffic_trend_12m[], favicon_url}, count, page, page_size, total, total_pages, has_more, source_url

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

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

**Parameters:**
- `country` (enum, optional) — Country list instead of worldwide: slug (united-states), ISO-2 code (us) or English name (United States). 170 countries. [one of: worldwide, 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, zimbabwe]
- `category` (enum, optional) — Category list: slug (shopping) or the name the site prints (Shopping, Online Communities, Entertainment…). 25 categories. [one of: all, 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-transportation]
- `direction` (enum, optional) — Only climbers or only fallers (default both). [one of: both, up, down]

**Returns:** list{…}, period, trending_scope_top, trending_text, trending_up[]{rank, rank_change, is_new, domain, website_url, ahrefstop_url, traffic, traffic_display, traffic_change, traffic_change_display}, trending_down[] (same), source_url

**Example request body:**
```json
{
  "country": "united-states"
}
```

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

**Parameters:**
- `domain` (string, required) — 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.

**Returns:** domain, requested_domain, name, description, explicit_content, website_url, ahrefstop_url, competitors_url, favicon_url, period, period_label, latest_history_month, date_modified, ranks{worldwide, country, category}{rank, rank_display, rank_change, is_new, …}, search_traffic{traffic, traffic_display, traffic_exact, traffic_change, traffic_value_usd, traffic_value_exact_usd, traffic_value_change_usd, keywords, summary}, traffic_history[]{month, traffic, traffic_value_usd}, traffic_by_country{countries[]{country, country_iso2, country_slug, traffic, previous_traffic, traffic_change, share_percent, …}}, top_keywords{country, keywords[]{keyword, volume, volume_change, traffic, traffic_change, position, position_change}}, competitors{country, websites[]{position, domain, traffic, traffic_change, pages}}, similarly_ranked{websites[]{domain, traffic, traffic_change, rank, rank_change, is_target}}, backlink_profile{domain_rating, linking_websites, linking_websites_exact, linking_websites_change, period, linking_websites_history[]{month, linking_websites}}

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

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

**Parameters:**
- `domain` (string, required) — 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.

**Returns:** domain, requested_domain, title, description, country, country_iso2, country_slug, ahrefstop_url, target{domain, description, ranks, traffic, traffic_value_usd, pages, pages_note, domain_rating, …}, competitors[]{position, domain, website_url, ahrefstop_url, description, explicit_content, ranks{worldwide, country, category}, traffic, traffic_change, traffic_value_usd, traffic_value_change_usd, pages, domain_rating}, competitor_count, note

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

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

**Parameters:**
- `page` (integer, optional, default 1) — Index page (1-10 today; `total_pages` says how many exist).
- `query` (string, optional) — Keep only domains containing this text (case-insensitive).

**Returns:** page, total_pages, page_updated, domains[] (strings), count, page_total, query, url_template, competitors_url_template, has_more, pages[]{page, lastmod}

**Example request body:**
```json
{
  "page": 1
}
```

### POST https://api.reefapi.com/ahrefstop/v1/filters — 0 credits
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.

**Parameters:** none

**Returns:** countries[]{slug, iso2, name}, categories[]{slug, name, also_accepted[]}, country_count, category_count, list_pages{worldwide, country, category}

## 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=ahrefstop
- Human docs page: https://reefapi.com/docs/ahrefstop
- Overview page: https://reefapi.com/ahrefstop-api
- Every ReefAPI API in one file (for your AI): https://reefapi.com/llms-full.txt
