SEO API · Website Ranking

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.

POST /api/v1/website/ranking $0.02 / request

Get API Key

Use your Seonio API key instantly.

Open Playground

curl

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"}'

import requests

resp = requests.post(
    "https://seonio.com/api/v1/website/ranking",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"domain_name": "moz.com"},
)
print(resp.json())

const resp = await fetch("https://seonio.com/api/v1/website/ranking", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
  body: JSON.stringify({"domain_name": "moz.com"}),
});
console.log(await resp.json());

Playground

Run a real /api/v1/website/ranking request. No key? We show the real sample result so you can still inspect the shape.

API key

JSON body

Leave the API key empty to load the built-in sample response.

Request

POST /api/v1/website/ranking

sample mode

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 request completed and was charged.
`401`	Missing or unknown API key.
`402`	Not enough balance on the account.
`422`	Invalid request body (wrong shape or types).
`429`	Rate limit exceeded (default 30 requests / 3 seconds).

Other endpoints

Explore the rest of the SEO API.

Keyword Research

/api/v1/keywords/global

Website Traffic

/api/v1/website/traffic

URL Stats

/api/v1/url/stats

Website Stats

/api/v1/website/stats

API Balance

Add funds once and use them anytime. Your balance never expires. New accounts start with $1 free.

Starter

$10 to spend

$ 10 one-time

Balance never expires.

A first top-up to kick the tires.

Get Started

Pro

$115 to spend

$ 100 one-time

+15% bonus
$100 + $15 free

The sweet spot for steady production traffic.

Get Started

Scale

$1,300 to spend

$ 1,000 one-time

+30% bonus
$1,000 + $300 free

Best rate per dollar for high-volume workloads.

Get Started

FAQ

Simple answers for developers using the API.

Pricing & Balance

Every API endpoint has a fixed price in USD. Your requests are charged directly against your API balance, so you always know what each call costs.

No. Seonio does not use abstract credits for API pricing. You add dollars to your account and spend that balance directly on API usage.

No. Your API balance never expires, so you can use it whenever your workflows need it.

Paid API requests stop until you add more balance. This keeps spend predictable and prevents unexpected charges.

API & Integration

You can create and manage API keys from your account. Use your key to authenticate requests from your app, scripts, or internal tools.

Yes. Your dashboard shows your API usage and remaining balance, so you can track costs while building and running automated workflows.

We currently cover 50 markets. We add new countries regularly.

Algeria Argentina Australia Austria Bangladesh Belgium Brazil Bulgaria Canada Czechia Denmark Egypt Finland France Germany Ghana Greece Hungary India Indonesia Ireland Italy Japan Kenya Malaysia Mexico Morocco Netherlands New Zealand Nigeria Norway Pakistan Philippines Poland Portugal Romania Saudi Arabia Serbia Singapore South Africa Spain Sri Lanka Sweden Switzerland Thailand Turkiye United Arab Emirates United Kingdom United States Vietnam

Our support team responds to email inquiries within 1 business day. We can help with account, billing, and API integration questions.

Start Researching for Free

$1 free balance included • No credit card required • Access all features

Create Free Account