SERP

The SERP service returns the full ranked organic results page for a keyword, in a region, on a device — scraped live by our own crawler.

Submit a task

curl -X POST https://api.seo-checker.com.ua/v1/serp/tasks \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{"keyword":"best running shoes","region":"us","device":"desktop","depth":1}'

Field	Required	Description
keyword	yes	The search query.
region	yes	A code from GET /v1/regions.
device	no	desktop (default), mobile, or tablet.
depth	no	Result pages to crawl, 1–5 (10 results/page). Default 1.

You get back a task_id; poll GET /v1/serp/tasks/{id} until it’s done. See Task lifecycle.

Result

{
  "keyword": "best running shoes",
  "region": "us",
  "device": "desktop",
  "total_results": 1010,
  "items": [
    { "position": 1, "url": "https://example.com/best-running-shoes",
      "title": "Best Running Shoes — 2026 Guide", "snippet": "…",
      "displayed_url": "example.com" }
  ]
}

Organic results only — no ads, knowledge panels, or “people also ask”. For the full field list, see the API Reference.

Billing

1 credit per keyword (per task), charged on create — see Credits & billing.