API Documentation
Rankeez offers a free, unauthenticated JSON API to look up a domain's rank.
Endpoint
GET https://rankeez.com/api/{domain}.json
Example request
curl https://rankeez.com/api/google.com.json
Example response
{
"google.com": 1,
"history": {
"2025-02": 1,
"2026-07": 1
}
}
Notes
- No API key required.
- Response is empty JSON if the domain isn't found in our database — check the HTTP body length, not just status code.
historymaps"YYYY-MM"to the rank recorded that month, oldest first. Only months where a snapshot exists are included, so it may be sparse for a domain we've only recently started tracking.- Please cache results on your side. Ranks only change every month (see Methodology), there's no need to poll more often than that.
- Automated bulk scraping outside this API (e.g. crawling
/topor/site/pages at high volume) may be rate-limited.
Top domains
GET https://rankeez.com/api.php?action=top&limit=1000
limit is optional, default 100, max 1000.
curl "https://rankeez.com/api.php?action=top&limit=3"
{
"top": [
{"domain": "google.com", "rank": 1},
{"domain": "facebook.com", "rank": 2},
{"domain": "youtube.com", "rank": 4}
],
"count": 3
}
Categories
Domains are categorized by Similars.net's AI classifier. List all categories with how many domains fall in each:
GET https://rankeez.com/api.php?action=categories
Top-ranked domains within one category:
GET https://rankeez.com/api.php?action=category&name=Gaming&limit=50
name must match a category from the list above exactly. limit is optional, default 50, max 200.
curl "https://rankeez.com/api.php?action=category&name=Gaming&limit=3"
{
"category": "Gaming",
"domains": [
{"domain": "discord.gg", "rank": 85, "subcategory": null},
{"domain": "roblox.com", "rank": 96, "subcategory": null},
{"domain": "discord.com", "rank": 118, "subcategory": null}
],
"count": 3
}
top, categories and category are quota-free and not subject to any per-domain limits.