Domain Ranking API
Composite domain ranking from Tranco, Majestic, and CrUX sources with confidence scoring.
Endpoints
| Method | Path | Description |
|---|---|---|
| GET | /api/v1/rank/{domain} | Look up composite rank for a domain |
| POST | /api/v1/rank/bulk | Batch rank lookup (up to 1000 domains) |
| GET | /api/v1/rank/{domain}/history | Rank history (up to 365 days) |
| GET | /api/v1/rank/top/list | Browse top-ranked domains |
Try It
Example Request
bash
curl -H "X-API-Key: wxa_yourkey" https://wxaintel.wxapros.com/api/v1/rank/google.com
Example Response
json
{
"domain": "google.com",
"rank": 1,
"confidence": 0.45,
"sources": {
"tranco": { "rank": 1 },
"majestic": { "rank": 4237 },
"crux": { "rank": 500 }
}
}Bulk Request
bash
curl -X POST -H "X-API-Key: wxa_yourkey" -H "Content-Type: application/json" \
-d '{"domains": ["google.com", "github.com", "example.com"]}' \
https://wxaintel.wxapros.com/api/v1/rank/bulkHistory Request
bash
curl -H "X-API-Key: wxa_yourkey" \ "https://wxaintel.wxapros.com/api/v1/rank/google.com/history?days=90"
Response Codes
| Status | Description |
|---|---|
| 200 | Success |
| 401 | Missing or invalid API key |
| 403 | Key doesn't have required scope |
| 429 | Rate limit exceeded |
| 502 | Backend service unavailable |
Code Examples
python
import requests
# Single domain lookup
response = requests.get(
"https://wxaintel.wxapros.com/api/v1/rank/google.com",
headers={"X-API-Key": "wxa_yourkey"}
)
data = response.json()
print(f"{data['domain']} is ranked #{data['rank']} (confidence: {data['confidence']})")
# Bulk lookup
response = requests.post(
"https://wxaintel.wxapros.com/api/v1/rank/bulk",
headers={"X-API-Key": "wxa_yourkey"},
json={"domains": ["google.com", "github.com"]}
)
for result in response.json()["results"]:
print(f" {result['domain']}: #{result['rank']}")javascript
// Single domain lookup
const response = await fetch(
"https://wxaintel.wxapros.com/api/v1/rank/google.com",
{ headers: { "X-API-Key": "wxa_yourkey" } }
);
const data = await response.json();
console.log(`${data.domain} is ranked #${data.rank}`);
// Bulk lookup
const bulkRes = await fetch(
"https://wxaintel.wxapros.com/api/v1/rank/bulk",
{
method: "POST",
headers: { "X-API-Key": "wxa_yourkey", "Content-Type": "application/json" },
body: JSON.stringify({ domains: ["google.com", "github.com"] })
}
);
const bulkData = await bulkRes.json();
bulkData.results.forEach(r => console.log(` ${r.domain}: #${r.rank}`));