SEO API

SERP

Google organic results, People Also Ask and related searches for a keyword and country.

Start free Try it

POST /api/v1/serp/country$0.001 / requestAuth: X-API-Key header

seonio / rest apiFrom the API docs

RequestPOST /api/v1/serp/country

curl -X POST https://seonio.com/api/v1/serp/country \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $SEONIO_API_KEY" \
  -d '{"country": "us", "keyword": "seo tools"}'

Response200 OK

{
  "keyword": "seo tools",
  "country": "us",
  "organic": [
    {
      "position": 1,
      "title": "24 best SEO tools I'm using in 2026 (free + paid) - Marketer Milk",
      "link": "https://www.marketermilk.com/blog/best-seo-tools",
      "snippet": "24 best SEO tools I've personally tested in 2026 · 1. Surfer · 2. Gumloop · 3. Ahrefs · 4. Semrush ...",
      "date": "Jul 13, 2025"
    },
    {
      "position": 4,
      "title": "Semrush SEO Toolkit: Check Website SEO with Analysis Tools",
      "link": "https://www.semrush.com/seo/",
      "snippet": "From research to reporting, take your SEO to the next level with Semrush tools.",
      "date": null
    },
    {
      "position": 6,
      "title": "Free SEO Tools by Moz | Try Premium SEO Checkers for Free",
      "link": "https://moz.com/free-seo-tools",
      "snippet": "Try the best free SEO tools for link building and analysis, keyword research ...",
      "date": null
    }
  ],
  "people_also_ask": [
    {
      "question": "What are the SEO tools?",
      "title": "Free SEO Tools for Beginners and Pros",
      "link": "https://www.seo.com/tools/",
      "snippet": "Online SEO tools are the essential software applications that provide the data and insights ..."
    }
  ],
  "related_searches": [
    "seo tools free",
    "seo tools YouTube",
    "seo tools list",
    "Best seo tools",
    "seo tools AI"
  ]
}

Contract

What to send and what comes back

Send a keyword and country code and get back the Google results page: ranked organic listings with title, link and snippet, plus People Also Ask and related searches. Ideal for rank tracking, SERP analysis and competitor monitoring.

Request body

Request body
Field	Type	Required	Description
`keyword`	string	required	The search query to look up. Billed per request.
`country`	string	required	Two-letter country code for the search locale, e.g. "us". 50 supported countries `dz`Algeria`ar`Argentina`au`Australia`at`Austria`bd`Bangladesh`be`Belgium`br`Brazil`bg`Bulgaria`ca`Canada`cz`Czechia`dk`Denmark`eg`Egypt`fi`Finland`fr`France`de`Germany`gh`Ghana`gr`Greece`hu`Hungary`in`India`id`Indonesia`ie`Ireland`it`Italy`jp`Japan`ke`Kenya`my`Malaysia`mx`Mexico`ma`Morocco`nl`Netherlands`nz`New Zealand`ng`Nigeria`no`Norway`pk`Pakistan`ph`Philippines`pl`Poland`pt`Portugal`ro`Romania`sa`Saudi Arabia`rs`Serbia`sg`Singapore`za`South Africa`es`Spain`lk`Sri Lanka`se`Sweden`ch`Switzerland`th`Thailand`tr`Turkiye`ae`United Arab Emirates`gb`United Kingdom (also `uk`, returned as gb)`us`United States`vn`Vietnam

Response

Response fields
Field	Type	Description
`keyword`	string	The keyword that was searched.
`country`	string	The country locale used for the search.
`organic[]`	object[]	Ranked organic results, top to bottom, each as { position, title, link, snippet, date }.
`organic[].position`	integer	Rank on the results page (1 = top).
`people_also_ask[]`	object[]	{ question, title, link, snippet }.
`related_searches[]`	string[]	Related query suggestions.

Code

Copy, paste, add your key

The same request in cURL, Python and Node.js.

cURL

curl -X POST https://seonio.com/api/v1/serp/country \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"country": "us", "keyword": "seo tools"}'

Python

import requests

resp = requests.post(
    "https://seonio.com/api/v1/serp/country",
    headers={"X-API-Key": "YOUR_API_KEY"},
    json={"country": "us", "keyword": "seo tools"},
)
print(resp.json())

Node.js

const resp = await fetch("https://seonio.com/api/v1/serp/country", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": "YOUR_API_KEY",
  },
  body: JSON.stringify({"country": "us", "keyword": "seo tools"}),
});
console.log(await resp.json());

Playground

Run a real request

Send this request from your browser with your API key, or leave the key empty to see the sample response.

API key

JSON body

A successful run costs $0.001 / request. With no key, you see the sample response and nothing is charged.

POST /api/v1/serp/countrySample response

{
  "country": "us",
  "keyword": "seo tools",
  "organic": [
    {
      "date": "Jul 13, 2025",
      "link": "https://www.marketermilk.com/blog/best-seo-tools",
      "position": 1,
      "snippet": "24 best SEO tools I\u0027ve personally tested in 2026 \u00b7 1. Surfer \u00b7 2. Gumloop \u00b7 3. Ahrefs \u00b7 4. Semrush ...",
      "title": "24 best SEO tools I\u0027m using in 2026 (free + paid) - Marketer Milk"
    },
    {
      "date": null,
      "link": "https://www.semrush.com/seo/",
      "position": 4,
      "snippet": "From research to reporting, take your SEO to the next level with Semrush tools.",
      "title": "Semrush SEO Toolkit: Check Website SEO with Analysis Tools"
    },
    {
      "date": null,
      "link": "https://moz.com/free-seo-tools",
      "position": 6,
      "snippet": "Try the best free SEO tools for link building and analysis, keyword research ...",
      "title": "Free SEO Tools by Moz | Try Premium SEO Checkers for Free"
    }
  ],
  "people_also_ask": [
    {
      "link": "https://www.seo.com/tools/",
      "question": "What are the SEO tools?",
      "snippet": "Online SEO tools are the essential software applications that provide the data and insights ...",
      "title": "Free SEO Tools for Beginners and Pros"
    }
  ],
  "related_searches": [
    "seo tools free",
    "seo tools YouTube",
    "seo tools list",
    "Best seo tools",
    "seo tools AI"
  ]
}

Use cases

What developers build with it

Rank tracking and SERP monitoring for target keywords.
Competitor analysis of who owns the top positions.
Mining People Also Ask and related searches for content ideas.

Status codes

The same contract on every endpoint

Error responses are JSON with a "detail" field. It is a message string unless the row above says otherwise.

Status codes
Code	When
`200`	Success. The lookup completed and was charged, even if the response is empty. /keywords/global charges only the keywords it looked up.
`401`	Missing or unknown API key.
`402`	Not enough balance. "detail" is an object with "error", "message", "balance_required" and "balance_available". Requests still running hold their price until they finish, so a retry can succeed once they do.
`403`	The account is not verified yet, or it is locked.
`422`	Invalid request (wrong shape or types, a keyword over 200 characters, a URL the page checker cannot audit, a domain that does not exist, or a bare public suffix such as co.uk that groups many websites) — never charged. "detail" is usually a list of validation errors; an answer that retrying cannot change (such as a domain without a DNS record) is a message string with an X-Outcome header naming it: missing, unsupported, too_large or refused_input.
`429`	Rate limit exceeded, never charged. Requests per second per account by plan: 5 on a free account, 10 on Starter, 15 on Pro and 20 on Business; retry after the Retry-After header. Also the page checker's provider limit.
`503`	A data provider failed or timed out (X-Outcome: temporary). Nothing was charged; retry after the seconds in the Retry-After header.

Related endpoints

More endpoints to use with the same API key. Every one draws on the same balance.

All 21 endpoints

$0.001 / request + $0.002 / scraped URL

SERP Scraper

Run a Google search and get the top results scraped to clean markdown in one call.

View docs

$0.002 / request

Scraper

Scrape a supported URL to clean, LLM-ready markdown in one call.

View docs

$0.01 / request

Website Traffic

Monthly organic traffic history for any domain.

View docs

FAQ

Questions, answered

Simple answers for developers using the API.

Every endpoint has a published USD price or formula. Requests draw from the same testing, included and Extra Usage balance as website and MCP actions: testing first, then included usage, then Extra Usage expiring soonest.

API actions require a verified account with a free $1 balance or an active subscription balance. Create and manage API keys from your account, then send the key in the X-API-Key header.

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

REST API and MCP requests per second depend on your plan: 5 on a free account, 10 on Starter, 15 on Pro and 20 on Business. Website data requests from the same account count toward the same second. Requests above the limit return HTTP 429 with a Retry-After header and are not charged; wait a second and retry.

Free $1 to test · No card required

Turn search insights into measurable growth

Start your SEO research in seconds.

Get started for free See pricing

SEO researchREST APIMCP