RankReady

API Reference

Programmatic access to RankReady's domain database. Requires a Premium subscription.

Authentication

Generate an API key from your account page. Pass it in the Authorization header:

Authorization: Bearer dw_your_api_key_here
Rate limit: 100 requests per minute. Remaining quota returned in X-RateLimit-Remaining header.

Base URL

https://rankreadydomains.com/api/v1
GET

/domains

Search and filter domains. Returns paginated results with AI insights.

Parameters

q
string
Search domain names. e.g. 'shop', 'tech'
tier
string
Quality tier filter. Comma-separated: S, A, B, C
tld
string
TLD filter. Comma-separated: com, net, org, io
niche
string
Niche tag filter. Comma-separated: saas, fintech, health
minScore
number
Minimum overall score (0-100)
maxScore
number
Maximum overall score (0-100)
available
boolean
Filter by availability. 'true' for available only
source
string
Domain source: dropped, expiring, both
sort
string
Sort column: overall_score, page_rank, domain_age_years, organic_traffic, referring_domains, first_seen_date, domain
order
string
Sort direction: asc or desc (default: desc)
page
number
Page number (default: 1)
limit
number
Results per page, max 100 (default: 25)

Example

Request
curl "https://rankreadydomains.com/api/v1/domains?tier=S,A&tld=com&available=true&minScore=60&limit=5" \
  -H "Authorization: Bearer dw_your_key"
Response
{
  "domains": [
    {
      "domain": "example.com",
      "name": "example",
      "tld": "com",
      "qualityTier": "S",
      "overallScore": 85,
      "pageRank": 3.2,
      "domainAgeYears": 12.5,
      "organicTraffic": 1200,
      "organicKeywords": 340,
      "waybackSnapshots": 890,
      "wasRealSite": true,
      "referringDomains": 156,
      "available": true,
      "isForSale": false,
      "source": "dropped",
      "firstSeenDate": "2026-03-20",
      "expiryDate": null,
      "opportunityScore": 78,
      "businessUseCases": "[\"SaaS landing page\", \"Tech blog\"]",
      "opportunityReasons": "Strong backlink profile with...",
      "nicheTags": "[\"saas\", \"devtools\"]"
    }
  ],
  "total": 2847,
  "page": 1,
  "pages": 570
}
GET

/domains/:domain

Get full details for a specific domain including all metrics and AI insights.

Request
curl "https://rankreadydomains.com/api/v1/domains/example.com" \
  -H "Authorization: Bearer dw_your_key"
Response
{
  "domain": "example.com",
  "name": "example",
  "tld": "com",
  "qualityTier": "S",
  "overallScore": 85,
  "qualityScore": 82,
  "qualityReasons": "Short memorable name, .com TLD...",
  "pageRank": 3.2,
  "organicTraffic": 1200,
  "organicKeywords": 340,
  "waybackSnapshots": 890,
  "waybackFirst": "2008-03-15",
  "waybackLast": "2025-11-20",
  "wasRealSite": true,
  "domainAgeYears": 12.5,
  "referringDomains": 156,
  "referringDomainsActive": 89,
  "available": true,
  "isForSale": false,
  "source": "dropped",
  "firstSeenDate": "2026-03-20",
  "scoreReasons": "High domain age, strong backlinks...",
  "insights": {
    "opportunityScore": 78,
    "businessUseCases": "[\"SaaS landing page\", \"Tech blog\"]",
    "opportunityReasons": "Strong backlink profile with...",
    "historyNarrative": "Previously operated as a...",
    "nicheTags": "[\"saas\", \"devtools\"]"
  }
}

Use cases

Find high-authority domains in a niche

curl "https://rankreadydomains.com/api/v1/domains?niche=fintech&available=true&minScore=50&sort=referring_domains&order=desc&limit=10" \
  -H "Authorization: Bearer dw_your_key"

Monitor new drops daily

# Run daily in a cron job
curl "https://rankreadydomains.com/api/v1/domains?tier=S,A&tld=com&available=true&sort=first_seen_date&order=desc&limit=50" \
  -H "Authorization: Bearer dw_your_key"

Build a domain comparison tool

# Get details for specific domains
curl "https://rankreadydomains.com/api/v1/domains/example.com" \
  -H "Authorization: Bearer dw_your_key"

curl "https://rankreadydomains.com/api/v1/domains/another.com" \
  -H "Authorization: Bearer dw_your_key"

Python script

python
import requests

API_KEY = "dw_your_key"
BASE = "https://rankreadydomains.com/api/v1"

headers = {"Authorization": f"Bearer {API_KEY}"}

# Search for available .com domains with backlinks
resp = requests.get(f"{BASE}/domains", headers=headers, params={
    "tld": "com",
    "available": "true",
    "minScore": "60",
    "sort": "referring_domains",
    "order": "desc",
    "limit": "25"
})

for d in resp.json()["domains"]:
    print(f"{d['domain']} — Score: {d['overallScore']}, RD: {d['referringDomains']}")

Errors

StatusMeaning
401Invalid or missing API key
403Active premium subscription required
404Domain not found (detail endpoint)
429Rate limit exceeded (100 req/min)

API keys are managed on your account page. Questions? Email us at support@rankreadydomains.com.