Website Ranking
A domain's full ranking footprint: countries, distribution, movers, top keywords and pages.
The richest endpoint: total ranking volume and value, country split, keyword position buckets, movement counts, plus the top keywords and pages driving the domain.
/api/v1/website/ranking
$0.02 / request
Use your Seonio API key instantly.
curl -X POST https://seonio.com/api/v1/website/ranking \
-H "Content-Type: application/json" \
-H "X-API-Key: $SEONIO_API_KEY" \
-d '{"domain_name": "moz.com"}'Sample response
{
"country_distribution": {
"CA": 1,
"DE": 1,
"ID": 2,
"IN": 47,
"PK": 11,
"UK": 1,
"US": 34
},
"domain": "moz.com",
"keyword_distribution": {
"pos_11_20": 9,
"pos_1_3": 42,
"pos_20_plus": 11,
"pos_4_10": 38
},
"movers": {
"is_down": 1715,
"is_lost": 0,
"is_new": 3253,
"is_up": 5615
},
"top_country": "IN",
"top_keywords": [
{
"keyword": "websites",
"ranking": 5.95,
"volume": 200273
},
{
"keyword": "conversion optimization",
"ranking": 5.0,
"volume": 29287
},
{
"keyword": "domain authority checker",
"ranking": 1.14,
"volume": 27867
}
],
"top_pages": [
{
"page_url": "https://moz.com/domain-analysis",
"ranking": 1.92,
"volume": 271362
},
{
"page_url": "https://moz.com/link-explorer",
"ranking": 3.1,
"volume": 20091
}
],
"total_value": 7137032,
"total_volume": 1298217
}Request and response
The full contract for /api/v1/website/ranking — what to send and what comes back.
Request body
domain_name
string
required
Bare domain to analyse, e.g. "moz.com".
Response fields
total_volume |
integer |
Combined monthly volume of ranked keywords. |
total_value |
integer |
Estimated traffic value. |
top_country |
string |
Largest country by share. |
country_distribution |
object |
Percentage share per country code. |
keyword_distribution |
object |
Counts by position bucket. |
movers |
object |
is_new, is_up, is_down, is_lost counts. |
top_keywords[] |
object[] |
{ keyword, volume, ranking }. |
top_pages[] |
object[] |
{ page_url, volume, ranking }. |
Code examples
Copy, paste, swap in your API key.
curl -X POST https://seonio.com/api/v1/website/ranking \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"domain_name": "moz.com"}'Playground
Run a real /api/v1/website/ranking request. No key? We show the real sample result so you can still inspect the shape.
Leave the API key empty to load the built-in sample response.
Request
POST /api/v1/website/ranking
What developers build with it
Common ways Website Ranking ends up in production.
Domain overview / competitor analysis screens.
Spotting rising and falling keywords (movers).
Surfacing the pages worth attacking or defending.
Status codes
The same predictable contract on every endpoint.
200 |
Success. The lookup completed and was charged, even if the response is empty. |
401 |
Missing or unknown API key. |
402 |
Not enough balance on the account. |
422 |
Invalid request body (wrong shape or types). |
429 |
Account rate limit exceeded (20 requests per second). |
Other endpoints
Explore the rest of the SEO API.
Keyword Research
/api/v1/keywords/global
Volume, CPC, competition and a 12-month trend for up to 100 keywords in one call.
Keyword Countries
/api/v1/keywords/countries
Top five countries by keyword volume.
Keyword Difficulty
/api/v1/keywords/difficulty
Country-specific ranking difficulty.
Keyword Intent
/api/v1/keywords/intent
Search-intent classification.
Keyword Demographics
/api/v1/keywords/demographics
Age and gender demand distribution.
Keyword Clustering
/api/v1/keywords/clustering
Group a keyword's universe into topic clusters by SERP overlap.
Keyword Suggestions
/api/v1/keywords/suggestions
Up to 100 related keyword ideas — each with full metrics — from one seed keyword.
Keyword Metrics by Country
/api/v1/keywords/country
Localized metrics for up to 1000 keywords in one country.
SERP
/api/v1/serp/country
Google organic results, People Also Ask and related searches for a keyword and country.
SERP Scraper
/api/v1/serp/scraper
Run a Google search and get the top results scraped to clean markdown in one call.
Scraper
/api/v1/scraper
Scrape a supported URL to clean, LLM-ready markdown in one call.
Website Traffic
/api/v1/website/traffic
Monthly organic traffic history for any domain.
Website Category
/api/v1/website/category
Taxonomy classification for a domain.
Website Competitors
/api/v1/website/competitors
Ordered organic competitors.
Similar Websites
/api/v1/website/similar
Traffic-ranked sites in the same category.
URL Stats
/api/v1/url/stats
Page- and domain-level authority metrics for a specific URL.
URL Keywords
/api/v1/url/keywords
Top organic keywords for one URL.
Website Stats
/api/v1/website/stats
Domain-level authority metrics for a bare domain.
Backlink History
/api/v1/backlink/history
Historical backlink counts for a domain.
Backlink Table
/api/v1/backlink/table
Detailed backlinks for a domain or URL.
SEO Page Checker
/api/v1/audit/page-checker
On-page SEO report and response timing.
FAQ
Simple answers for developers using the API.
Pricing & Balance
API & Integration
Start free
$1 testing balance • No card required • Subscribe when ready