Reef AI: ask for any data. Try it
Ahrefs Free SEO Tools API

Ahrefs' free SEO tools as one API: links, traffic, keywords, SERPs and AI visibility

This API returns what Ahrefs' free SEO tools on ahrefs.com show, without an Ahrefs account.

endpoints
13
credits per call
0–3

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

13 active endpoints, on 0 and 3 credit tiers.

  • POST/ahrefs/v1/website_authority3 credits
  • POST/ahrefs/v1/backlinks3 credits
  • POST/ahrefs/v1/broken_links3 credits
  • POST/ahrefs/v1/traffic3 credits
  • POST/ahrefs/v1/sitemap3 credits
  • POST/ahrefs/v1/keyword_ideas3 credits
  • POST/ahrefs/v1/keyword_difficulty3 credits
  • POST/ahrefs/v1/serp3 credits
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.

Ahrefs Free SEO Tools API

5 of 13 endpoints, ready to run

View docs ↗

Domain Rating, backlink counts and the top 20 backlinks

3 credits1 required · 1 optional
POST/ahrefs/v1/backlinks
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 Ahrefs Free SEO Tools endpoints does ReefAPI ship?

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

13 endpoints

website_authority

3 cr

Ahrefs' Website Authority Checker for a domain or URL.

required
target
optional
—

backlinks

3 cr

Ahrefs' Backlink Checker.

required
target
optional
mode

broken_links

3 cr

Ahrefs' Broken Link Checker.

required
target
optional
mode

traffic

3 cr

Ahrefs' Website Traffic Checker.

required
target
optional
mode, country

sitemap

3 cr

Ahrefs' XML Sitemap Generator.

required
target
optional
—

keyword_ideas

3 cr

Ahrefs' Keyword Generator (Google).

required
keyword
optional
country, include_questions

keyword_difficulty

3 cr

Ahrefs' Keyword Difficulty Checker.

required
keyword
optional
country

serp

3 cr

Ahrefs' SERP Checker.

required
keyword
optional
country

keyword_rank

3 cr

Ahrefs' Keyword Rank Checker.

required
keyword, target
optional
country

ai_visibility

3 cr

Ahrefs' AI Visibility Checker for a brand.

required
brand
optional
—

ai_overviews

3 cr

Ahrefs' AI Overviews Tracker for a brand.

required
brand
optional
—

ai_mode

3 cr

Ahrefs' AI Mode Tracker for a brand.

required
brand
optional
—

filters

0 cr

The values the other actions accept.

required
—
optional
—

Every parameter, every allowed value →

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

How the Ahrefs Free SEO Tools API works

Ahrefs Free SEO Tools 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 /ahrefs/v1/…

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

03
Pay
0 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.

04
Read
{ ok, data, meta, error }

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

Recipe

From a keyword to who ranks, how strong they are and where you stand

Size a keyword, see the pages ranking for it, then check a site's links and position.

01keyword_difficulty?keyword=seo%20tools&country=us
GET/ahrefs/v1/keyword_difficulty?keyword=seo%20tools&country=us

Keyword Difficulty 79, about 329 referring domains needed for the top 10, and the 10 results with an AI Overview, People Also Ask and the first 3 organic pages' Domain Rating, backlinks and traffic.

02backlinks?target=stackoverflow.com
GET/ahrefs/v1/backlinks?target=stackoverflow.com

Domain Rating 92, about 157.5 million backlinks from 165,265 referring domains, and the top 20 backlinks with anchor text and linking-page Domain Rating.

03keyword_rank?keyword=backlink%20checker&target=ahrefs.com&country=us
GET/ahrefs/v1/keyword_rank?keyword=backlink%20checker&target=ahrefs.com&country=us

Position 2 with the ranking page https://ahrefs.com/backlink-checker and its metrics.

How hard a keyword is, who ranks for it, how strong their links are and where a given site stands.

request
curl -X POST https://api.reefapi.com/ahrefs/v1/backlinks \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"target":"github.com"}'
response envelope
{
  "ok": true,
  "data": { … },
  "meta": {
    "api": "ahrefs",
    "endpoint": "backlinks",
    "mode": "live",
    "latency_ms": …,
    "record_count": …
  },
  "error": null
}
Fields

What an Ahrefs field actually contains

Fields that read differently from how they look. Every row was measured against live ahrefs.com answers on 2026-11-19.

FieldWhat it holds
domain_rating, backlinks, referring_domainsThe same numbers ahrefs.com's Backlink Checker shows: compared with the tool in a browser on 7 domains, Domain Rating and both dofollow shares were equal on 7 of 7 and the counts within 2 %. Counts move a little from one minute to the next (github.com read 5.57 to 5.60 billion backlinks within one hour); Domain Rating does not.
dofollow_backlinks_percent, dofollow_referring_domains_percentPercent (0-100) of backlinks and of referring domains that are dofollow, as the tool prints "53% dofollow".
modesubdomains (default) counts the whole site, domain leaves out subdomains, prefix counts every URL under a path, exact one URL. prefix and exact match the host literally: www.bbc.co.uk/news returned 8,367,145 backlinks, bbc.co.uk/news returned 0.
traffic.all_trafficAll channels: visits, unique visitors and page views of the last full month (October 2026 on 2026-11-19) and the month before, 6 months of visits, the top 5 channels, countries and pages. null when Ahrefs has no data for the site.
traffic.organic and countryOrganic search only: the monthly organic traffic and its value in US dollars, 6 months of history, top 5 pages, countries and keywords. country changes only the top pages and top keywords (ahrefs.com's backlink-checker page: 900,159 visits in the US list, 4,454 in the German one); without it Ahrefs uses the site's own top country. Totals and history are worldwide.
volume_printed, volume_at_leastKeyword ideas carry a volume band, not an exact volume: the tool prints ">1000", ">10,000", ">100K" and so on; volume_at_least is the lower bound (1000). difficulty_printed is Easy, Medium, Hard or N/A (224 of 420 measured ideas were N/A).
results[].metricsAhrefs page metrics (Domain Rating, URL Rating, backlinks, referring domains, traffic, traffic value, keywords, top keyword, word count, Ahrefs Rank) are on the first 3 organic results only: 47 of 47 measured SERPs had them on positions 1-3 and none below, as on the free tool.
results[].typeThe Google block at that position: organic, ai_overview, questions (People Also Ask), paids (ads), organic_shopping, local_pack, top_stories, image_pack, discussions, knowledge_card, knowledge_panel. 11 types seen across 47 SERPs.
keyword_rank.positionThe best position Ahrefs has stored for the site; is_ranking false and position null when it has none. Matched the position in keyword_difficulty's top 10 on 10 of 10 checks.
broken_links.outbound_errorFor the very largest sites Ahrefs returns only the inbound half; the outbound half is null and this field says so (bbc.co.uk, github.com, nytimes.com).

Traffic and traffic value are Ahrefs' estimates; traffic value is what that traffic would cost in ads, in US dollars. AI citation counts come from Ahrefs' own tracking of AI answers.

Coverage

Ahrefs free tools coverage, measured

Every number below was read from live ahrefs.com answers on 2026-11-19.

Tools

12: Website Authority Checker, Backlink Checker, Broken Link Checker, Website Traffic Checker, XML Sitemap Generator, Keyword Generator, Keyword Difficulty Checker, SERP Checker, Keyword Rank Checker, AI Visibility Checker, AI Overviews Tracker, AI Mode Tracker.

Reliability

133 of 136 live calls answered. All 3 misses were broken_links on wikipedia.org and nytimes.com, where Ahrefs' own checker did not finish; every other action answered on every call.

Accuracy

Against the Backlink Checker in a browser on 7 domains: Domain Rating 7 of 7 equal, dofollow shares 14 of 14 equal, counts within 2 %, 134 of 140 top backlinks identical. keyword_rank equalled the position in the top 10 on 10 of 10 checks.

Countries

217 countries for keyword ideas, keyword difficulty, SERP, rank checks and traffic top lists.

Per answer

20 backlinks; up to 10 broken backlinks and 8 pages with broken outgoing links; 20 keyword ideas and 20 questions; the Google top 10; up to 1000 sitemap URLs; top 5 pages, countries, keywords, topics and cited domains; 6 months of traffic and AI-citation history.

Limits

No pages beyond what the free tools show. Ahrefs page metrics on the first 3 organic results only. Keyword volume is a band (>1000), not an exact number. Google keyword ideas only. Very large sites may not finish in broken_links.

Use cases

What people build with Ahrefs Free SEO Tools

The jobs this data is most often used for.

13

endpoints

0/3

credits per call

01

Check Domain Rating, backlinks and referring domains for a list of prospects, link partners or competitors.

02

Pull the top 20 backlinks of a competitor with anchor text and linking-page Domain Rating.

03

Find broken backlinks pointing at a site to reclaim them.

04

Research keyword ideas, question keywords and keyword difficulty in any of 217 countries before writing.

Pricing

What Ahrefs Free SEO Tools 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.

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/ahrefs/v1/backlinks \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"target":"github.com"}'
python
import os
import requests

REEF_KEY = os.environ["REEF_KEY"]

r = requests.post(
    "https://api.reefapi.com/ahrefs/v1/backlinks",
    headers={"x-api-key": REEF_KEY},
    json={
        "target": "github.com"
    },
    timeout=90,
)
print(r.json()["data"])
FAQ

Have a question? We got answers.

The questions people actually ask before wiring up Ahrefs Free SEO Tools.

Do I need an Ahrefs account?▾

No. The API returns what Ahrefs' free tools on ahrefs.com show logged out. Site Explorer and the other paid Ahrefs reports are not included.

How many backlinks does the backlinks action return?▾

The top 20, the same 20 the free Backlink Checker shows (134 of 140 rows were identical to a browser run of the tool on 7 domains), plus the total backlink and referring-domain counts and Domain Rating.

Which countries are supported for keywords and SERPs?▾

217 countries, given as an ISO-2 code (de) or a name (Germany). The filters action lists them. A supported country can still have no data for a keyword: that answers NOT_FOUND for keyword_difficulty, serp and keyword_rank, and 0 ideas for keyword_ideas.

Are YouTube, Amazon and Bing keyword ideas available?▾

No. Ahrefs shows those three tools as "under maintenance" and they return no ideas, so the API offers Google keyword ideas only.

How much traffic history do I get?▾

6 months of all-channel visits and 6 months of organic search traffic, as the free Website Traffic Checker shows. For monthly organic history back to 2015 use the ahrefstop API.

How long does a call take?▾

Measured medians: 2.2 s for keyword ideas and SERP, 3.2 s for keyword difficulty, 4.1 s for traffic, 5.9 s for backlinks, 7.6 s for website_authority; AI visibility calls up to 17 s. broken_links on the very largest sites can take 36 s or not finish (wikipedia.org did not); checking a section with mode prefix is faster.

What do I get for a domain Ahrefs knows nothing about?▾

A normal answer with Domain Rating 0, zero counts and has_data false (all_traffic null for traffic), the same as the free tools show. A brand with no AI mentions returns 0 citations and empty lists.

How does this differ from the ahrefstop API?▾

ahrefstop reads Ahrefs' public top-websites site: rankings of the most visited sites and per-domain pages with long traffic history. This API reads the free tools: backlinks, broken links, keywords, SERPs, rank checks, sitemaps and AI visibility.

What is the Ahrefs Free SEO Tools API?▾

Ahrefs Free SEO Tools API is a ReefAPI endpoint group for ahrefs' free seo tools as json: domain rating, backlinks and the top 20 backlinks, broken links, website traffic, keyword ideas, keyword difficulty, serp and rank checks, xml sitemap and ai visibility for a brand. It returns live JSON through POST requests under /ahrefs/v1.

Is the Ahrefs Free SEO Tools API free to try?▾

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

Do I need an Ahrefs Free SEO Tools login or account?▾

No login to Ahrefs Free SEO Tools 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 Ahrefs Free SEO Tools data?▾

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

How many credits does the Ahrefs Free SEO Tools API use?▾

Ahrefs Free SEO Tools 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 Ahrefs Free SEO Tools from an AI assistant or MCP client?▾

Yes. Connect ReefAPI once through MCP and your assistant can call ahrefs 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 Ahrefs Free SEO Tools, 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-19.