SEO API · SERP

SERP

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

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.

POST /api/v1/serp/country $0.001 / request

Get API Key

Use your Seonio API key instantly.

Open Playground

curl

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

Sample 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"
  ]
}

Request and response

The full contract for /api/v1/serp/country — what to send and what comes back.

Request body

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".

Response fields

`keyword`	string	The keyword that was searched.
`country`	string	The country locale used for the search. Supported countries `in` India `vn` Vietnam `us` United States `gb` United Kingdom `de` Germany `pk` Pakistan `bd` Bangladesh `ca` Canada `tr` Turkiye `id` Indonesia `fr` France `es` Spain `nl` Netherlands `it` Italy `au` Australia `ae` United Arab Emirates `ph` Philippines `ch` Switzerland `jp` Japan `ng` Nigeria `eg` Egypt `th` Thailand `za` South Africa `mx` Mexico `sg` Singapore `ke` Kenya `at` Austria `ma` Morocco `pl` Poland `dk` Denmark `my` Malaysia `sa` Saudi Arabia `lk` Sri Lanka `ro` Romania `gh` Ghana `fi` Finland `se` Sweden `be` Belgium `br` Brazil `ie` Ireland `bg` Bulgaria `gr` Greece `nz` New Zealand `rs` Serbia `dz` Algeria `no` Norway `hu` Hungary `ar` Argentina `pt` Portugal `cz` Czechia
`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 examples

Copy, paste, swap in your API key.

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

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())

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 /api/v1/serp/country 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/serp/country

sample mode

What developers build with it

Common ways SERP ends up in production.

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 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`	Rate limit exceeded (fixed-window default: 30 requests / 3 seconds).

Other endpoints

Explore the rest of the SEO API.

Keyword Research

/api/v1/keywords/global

Keyword Clustering

/api/v1/keywords/clustering

Keyword Suggestions

/api/v1/keywords/suggestions

Keyword Metrics by Country

/api/v1/keywords/country

SERP Scraper

/api/v1/serp/scraper

Scraper

/api/v1/scraper

Website Traffic

/api/v1/website/traffic

Website Ranking

/api/v1/website/ranking

URL Stats

/api/v1/url/stats

Website Stats

/api/v1/website/stats

Website Backlinks

/api/v1/backlink/website

URL Backlinks

/api/v1/backlink/url

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.

We enforce a global rate limit per API-Key of 10 requests per second across all endpoints to ensure system stability. If you exceed this, our servers will return an HTTP 429 Too Many Requests status code. To handle this seamlessly in production, we recommend building rate-limiting logic or an exponential backoff (briefly pausing before retrying) directly into your application code.

Start Researching for Free

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

Create Free Account