API documentation

Backlinks + authority data via a simple REST API. Every example below is tested and ready to copy-paste into your terminal — just replace YOUR_API_KEY with your key from the dashboard.

Quick start

Paste this in your terminal to verify your key works (returns the global #1 host):

curl 'https://api.seo-backlinks.net/top?limit=1' \
  -H 'X-API-Key: YOUR_API_KEY'

Base URL & auth

Base URL : https://api.seo-backlinks.net
Header   : X-API-Key: sk_live_xxxxxxxxxxxxxxxx

All traffic encrypted via Let's Encrypt TLS. Reverse-proxied through Caddy.

Plans & quota

Plan	API requests / month	Bulk max domains	Referrers / check
free	10	10	10
starter	1,000	100	50
pro	10,000	1,000	100

1 request = 1 quota point (a bulk request with 50 domains counts as 1). Quotas reset monthly.

Drops CSV downloads (/drops/{date}/available-bl.csv and /pend-del.csv) require Starter+ and don't count against your API quota — they're unlimited daily downloads.

Endpoints

GET/check?domain=Xauth: X-API-Key

Get authority score + referring-domain count for a single domain.

Copy-paste curl

curl 'https://api.seo-backlinks.net/check?domain=stackoverflow.com' \
  -H 'X-API-Key: YOUR_API_KEY'

Sample response

{
  "domain": "stackoverflow.com",
  "harmonic_rank": "135",
  "harmonic_centrality": 20455020,
  "pagerank_rank": "276",
  "refdomains_count": "75424",
  "found": true,
  "elapsed_ms": 2,
  "remaining": 998
}

POST/bulkauth: X-API-Key

Look up up to 1,000 domains in one request. Returns the same fields as /check, one row per domain.

Copy-paste curl

curl -X POST 'https://api.seo-backlinks.net/bulk' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "domains": ["github.com","stackoverflow.com","reddit.com"]
  }'

Sample response

{
  "results": [
    { "host": "github.com",        "harmonic_rank": "16",  "refdomains_count": "750824" },
    { "host": "stackoverflow.com", "harmonic_rank": "135", "refdomains_count": "75424"  },
    { "host": "reddit.com",        "harmonic_rank": "533", "refdomains_count": "638460" }
  ],
  "count": 3,
  "elapsed_ms": 2,
  "remaining": 997
}

GET/refs?domain=X&limit=Nauth: X-API-Key

Top referring domains for X, ranked by authority. N is capped by your plan (free: 10, starter: 50, pro: 100).

Copy-paste curl

curl 'https://api.seo-backlinks.net/refs?domain=stackoverflow.com&limit=5' \
  -H 'X-API-Key: YOUR_API_KEY'

Sample response

{
  "domain": "stackoverflow.com",
  "total_referring_domains": 75424,
  "shown": 5,
  "plan": "starter",
  "plan_max": 50,
  "referrers": [
    { "domain": "blogspot.com", "indegree": 4187296, "rank": 1 },
    { "domain": "weebly.com",   "indegree": 548843,  "rank": 2 },
    { "domain": "wixsite.com",  "indegree": 472620,  "rank": 3 },
    { "domain": "webflow.io",   "indegree": 419683,  "rank": 4 },
    { "domain": "github.io",    "indegree": 301454,  "rank": 5 }
  ],
  "elapsed_ms": 3,
  "remaining": 996
}

GET/refs/csv?domain=Xauth: X-API-Key

Same as /refs but returned as a CSV file (rank, referrer_domain, indegree). Pipe to a file to download.

Copy-paste curl

curl 'https://api.seo-backlinks.net/refs/csv?domain=stackoverflow.com' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -o referrers.csv

Sample response

rank,referrer_domain,indegree
1,blogspot.com,4187296
2,weebly.com,548843
3,wixsite.com,472620
4,webflow.io,419683
5,github.io,301454
...

GET/top?limit=Nauth: X-API-Key

The N highest-authority hosts in the index, ordered by harmonic rank (best first). Max 500.

Copy-paste curl

curl 'https://api.seo-backlinks.net/top?limit=5' \
  -H 'X-API-Key: YOUR_API_KEY'

Sample response

{
  "results": [
    { "host": "www.facebook.com",         "harmonic_rank": "1" },
    { "host": "fonts.googleapis.com",     "harmonic_rank": "2" },
    { "host": "www.googletagmanager.com", "harmonic_rank": "3" },
    { "host": "www.google.com",           "harmonic_rank": "4" },
    { "host": "www.instagram.com",        "harmonic_rank": "5" }
  ]
}

GET/drops/recent?limit=Nno auth required

Recently dropped/expired domains harvested daily from CZDS zone diffs. Public — no API key required.

Copy-paste curl

curl 'https://api.seo-backlinks.net/drops/recent?limit=3'

Sample response

{
  "days": [
    {
      "date": "2026-07-02",
      "count": 358111,
      "tlds": [
        { "tld": "top",  "count": 119228 },
        { "tld": "org",  "count": 23750 },
        { "tld": "shop", "count": 21624 }
      ]
    }
  ]
}

GET/drops/{date}.csvno auth required

Full-day CSV of all domains dropped on a given date (all TLDs combined). Public — huge file (~9MB for busy days). Date format: YYYY-MM-DD.

Copy-paste curl

curl 'https://api.seo-backlinks.net/drops/2026-07-02.csv' -o drops-today.csv

Sample response

domain,tld
00252.one,one
00365.one,one
...
(358,111 rows)

GET/drops/{date}/{tld}.csvno auth required

Same as above, filtered to one TLD (e.g. top, org, xyz). Public. Handy if you only care about one extension.

Copy-paste curl

curl 'https://api.seo-backlinks.net/drops/2026-07-02/org.csv' -o drops-org.csv

Sample response

domain
188betlinkvao.org
2dmaterialsweb.org
...
(23,750 rows)

GET/drops/{date}/top-bl-previewno auth required

Top 15 drops of the day by backlink count (mixed AVAILABLE + PEND-DEL, sorted DESC). Public preview — full lists behind /available-bl.csv and /pend-del.csv.

Copy-paste curl

curl 'https://api.seo-backlinks.net/drops/2026-07-02/top-bl-preview'

Sample response

{
  "date": "2026-07-02",
  "total": 4880,
  "preview": [
    { "rank": 1, "domain": "juliecash.online",    "backlinks": 4254 },
    { "rank": 2, "domain": "aeriessteele.online", "backlinks": 4103 },
    { "rank": 3, "domain": "avilove.online",      "backlinks": 4007 }
  ]
}

GET/drops/{date}/available-bl-previewno auth required

Top 15 AVAILABLE domains (registerable NOW) with backlinks, sorted DESC. Public.

Copy-paste curl

curl 'https://api.seo-backlinks.net/drops/2026-07-02/available-bl-preview'

Sample response

{
  "date": "2026-07-02",
  "total": 320,
  "preview": [
    { "rank": 1, "domain": "theproxy.ink",      "backlinks": 261 },
    { "rank": 2, "domain": "idisemarangkab.org","backlinks": 133 },
    { "rank": 3, "domain": "idisalatigakab.org","backlinks": 133 }
  ]
}

GET/drops/{date}/available-bl.csvauth: X-API-Key

Full CSV of ALL AVAILABLE-with-backlinks drops for the date. Requires Starter+ plan (attach your API key).

Copy-paste curl

curl 'https://api.seo-backlinks.net/drops/2026-07-02/available-bl.csv' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -o available-bl.csv

Sample response

rank,domain,backlinks
1,theproxy.ink,261
2,idisemarangkab.org,133
3,idisalatigakab.org,133
...
(320 rows total)

GET/drops/{date}/pend-del-previewno auth required

Top 15 PEND-DEL domains (drop in 5-7 days — backorder via NameJet/SnapNames/DropCatch) with backlinks, sorted DESC. Public.

Copy-paste curl

curl 'https://api.seo-backlinks.net/drops/2026-07-02/pend-del-preview'

Sample response

{
  "date": "2026-07-02",
  "total": 4560,
  "preview": [
    { "rank": 1, "domain": "juliecash.online",   "backlinks": 4254, "expires": "2026-05-21" },
    { "rank": 2, "domain": "aeriessteele.online","backlinks": 4103, "expires": "2026-05-21" }
  ]
}

GET/drops/{date}/pend-del.csvauth: X-API-Key

Full CSV of ALL pending-delete drops (with expiration dates). Requires Starter+ plan.

Copy-paste curl

curl 'https://api.seo-backlinks.net/drops/2026-07-02/pend-del.csv' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -o pend-del.csv

Sample response

rank,domain,backlinks,expires
1,juliecash.online,4254,2026-05-21
2,aeriessteele.online,4103,2026-05-21
...
(4,560 rows total)

Common recipes

Check 50 domains in one call and save as CSV

curl -s -X POST 'https://api.seo-backlinks.net/bulk' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"domains":["google.com","facebook.com","github.com","stackoverflow.com"]}' \
  | python3 -c "
import sys, json
d = json.load(sys.stdin)
print('domain,harmonic_rank,referring_domains')
for r in d['results']:
    print(f\"{r['host']},{r.get('harmonic_rank','')},{r.get('refdomains_count','')}\")
" > report.csv

open report.csv  # Mac: opens in Numbers/Excel

Download referrers for many domains in parallel

# Adjust the list below — saves one file per domain in ./reports/
mkdir -p reports
for d in github.com stackoverflow.com reddit.com; do
  curl -s "https://api.seo-backlinks.net/refs/csv?domain=$d" \
    -H 'X-API-Key: YOUR_API_KEY' \
    -o "reports/$d.csv"
done

Single domain quick check

curl 'https://api.seo-backlinks.net/check?domain=yoursite.com' \
  -H 'X-API-Key: YOUR_API_KEY' \
  | python3 -m json.tool

Auto-download today's AVAILABLE-with-backlinks drops (Starter+)

DATE=$(date +%Y-%m-%d)

# Grab all AVAILABLE domains that have inbound backlinks — register the best via Porkbun
curl -s 'https://api.seo-backlinks.net/drops/'$DATE'/available-bl.csv' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -o "avail-bl-$DATE.csv"

# Preview top 10 by backlinks
head -11 "avail-bl-$DATE.csv" | column -t -s,

Monitor upcoming drops (PEND-DEL) daily — backorder pipeline

# Pipe to your NameJet / SnapNames / DropCatch backorder queue
DATE=$(date +%Y-%m-%d)

curl -s 'https://api.seo-backlinks.net/drops/'$DATE'/pend-del.csv' \
  -H 'X-API-Key: YOUR_API_KEY' \
  | awk -F, 'NR>1 && $3+0 > 100 {print $2}' > backorder-candidates.txt

# Now feed backorder-candidates.txt to your favorite drop-catcher
echo "Candidates: $(wc -l < backorder-candidates.txt)"

Discover the biggest expired domain in today's drops (public — no key needed)

curl -s 'https://api.seo-backlinks.net/drops/'$(date +%Y-%m-%d)'/top-bl-preview' \
  | python3 -m json.tool

Error codes

HTTP	Meaning
200	Success
400	Bad request — missing or invalid params
401	Missing or invalid API key
403	Your plan doesn't include this feature (e.g. Drops CSV needs Starter+)
404	Domain not in our index (try a more popular site)
429	Quota exhausted — upgrade or wait for monthly reset
500	Server error — please retry with backoff

Ready to start?

Free plan: 10 queries/month, no card. Upgrade anytime for higher quotas + CSV exports.

Open dashboard See pricing