Collect organic SERP SEO evidence

Run one live organic SERP check for SEO optimization evidence, including target visibility, competitor domains, rich SERP features, normalized per-result checks, People Also Ask context, AI Overview presence, and optional pixel ranking data.

Pricing — $ · min $0.01

Minimum 10 credits ($0.01) per call. Records returned above the minimum bill 1 credit ($0.001) each.

Authorization

bearerAuth

AuthorizationBearer <token>

UnifAPI API key. Provider credentials are managed by UnifAPI.

In: header

Header Parameters

Unifapi-Version?"2026-07-01"

Pin the API version an integration was built against (date-based, e.g. 2026-07-01). Omit to use the current version. Public URL paths stay stable and unversioned; breaking changes ship under a new dated version and are announced with Deprecation and Sunset response headers. The served version is echoed in every response's Unifapi-Version header. Policy: https://unifapi.com/versioning.md

Default"2026-07-01"

Value in

"2026-07-01"

Idempotency-Key?string

Client-supplied unique key that makes a write request safe to retry. If a request with the same key was already processed, the original response is replayed (with Idempotency-Replayed: true) instead of executing — and billing — again. Send a fresh UUID per logical operation. Best-effort with a 24h window.

Lengthlength <= 255

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*string

Search query to inspect.

Length1 <= length <= 700

target?string

Optional domain or URL to mark in the results, such as example.com or https://example.com/page.

Length1 <= length

location?|

Search location as a country code/name, DataForSEO location code, full location name, or latitude,longitude,radius coordinate string. Defaults to us.

language?string

Search language as an ISO code or full language name. Defaults to en.

Length2 <= length <= 80

device?string

SERP device type. Defaults to desktop.

Value in

"desktop"
"mobile"

os?string

Value in

"windows"
"macos"
"android"
"ios"

page?integer

1-based Google result page to start from. Defaults to 1. Implemented with Google's start parameter and ranks are adjusted to global SERP positions.

Range1 <= value <= 20

depth?integer

Organic result depth to crawl from the requested page. Defaults to 10. DataForSEO bills source in 10-result pages; UnifAPI bills returned billable organic records.

Range1 <= value <= 200

limit?integer

Number of organic results to return, matching the limit parameter used across other UnifAPI endpoints. Maps to DataForSEO depth and is used only when depth is omitted; defaults to 10.

Range1 <= value <= 200

view?string

Value in

"summary"
"standard"
"full"

include_ai_overview?boolean

When true, ask DataForSEO to load asynchronous Google AI Overview blocks in the organic SERP when available. This can add source cost.

people_also_ask_depth?integer

Optional click depth for People Also Ask expansion. Useful for SEO content-gap research and can add source cost.

Range1 <= value <= 4

include_pixel_rankings?boolean

When true, request pixel rectangle data for above-the-fold and visual rank analysis. This can add source cost.

viewport?

Viewport settings used only with include_pixel_rankings.

google_domain?string

Optional Google domain override such as google.co.uk or google.de.

Length4 <= length <= 80

google_search_params?string

Advanced Google search URL parameters such as nfpr=1. Prefer typed fields like page and include_omitted_results when available.

Length1 <= length <= 500

include_omitted_results?boolean

When true, adds filter=0 to inspect Google results that may otherwise be omitted. Useful for deep rank checks.

remove_url_params?array<>

URL query parameters to remove from result URLs before matching, such as srsltid.

Itemsitems <= 10

expand_related_results?boolean

When true, return related/sitelink-style organic results as separate organic elements instead of nesting them.

stop_at_target?boolean

When true and target is provided, stop crawling once the target is found. Useful for cheaper deep-rank checks, but later competitors may be omitted.

target_match?SeoSerpTargetMatch

How stop_at_target should match the target. Defaults to with_subdomains.

Value in

"domain"
"with_subdomains"
"wildcard"

target_search_mode?SeoSerpTargetSearchMode

When stop_at_target is true and multiple targets are used source, controls whether any or all targets stop the crawl. Defaults to any.

Value in

"any"
"all"

target_element_types?array<>

SERP element types to inspect for stop_at_target matches. Defaults to all first-level URL/domain elements.

Itemsitems <= 8

Response Body

`application/json`

curl -X POST "https://example.com/seo/serp" \  -H "Content-Type: application/json" \  -d '{    "query": "string"  }'

{  "request_id": "string",  "data": {    "query": "string",    "location": "string",    "language": "string",    "device": "desktop",    "os": "windows",    "view": "summary",    "rank_window": {      "page": 0,      "depth": 0,      "start_rank": 0,      "end_rank": 0,      "rank_offset": 0    },    "observed_at": "string",    "search_url": "string",    "total_results": 0,    "serp_features": [      "string"    ],    "summary": {      "organic_results": 0,      "billable_results": 0,      "rich_results": 0,      "paid_results": 0,      "feature_counts": {        "property1": 0,        "property2": 0      },      "check_counts": {        "property1": 0,        "property2": 0      },      "target_present": true,      "target_best_rank": 0    },    "questions": [      {        "question": "string",        "rank": 0,        "source": "people_also_ask"      }    ],    "results": [      {        "rank": 0,        "source_rank": 0,        "group_rank": 0,        "type": "string",        "title": "string",        "url": "string",        "domain": "string",        "snippet": "string",        "text": "string",        "markdown": "string",        "breadcrumb": "string",        "page": 0,        "position": null,        "rectangle": null,        "is_paid": true,        "is_billable": true,        "is_target": true,        "questions": [          "string"        ],        "checks": [          "string"        ],        "nested_items": [          null        ],        "extras": {          "property1": null,          "property2": null        }      }    ],    "target": {      "value": "string",      "domain": "string",      "present": true,      "best_rank": 0,      "matches": [        {          "rank": 0,          "type": "string",          "title": "string",          "url": "string",          "domain": "string"        }      ]    },    "competitors": [      {        "domain": "string",        "best_rank": 0,        "result_count": 0      }    ]  },  "billing": {    "credits_charged": 0,    "records_charged": 0,    "balance_remaining": 0,    "truncated_due_to_balance": true  }}

Collect organic SERP SEO evidence

Authorization

Header Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

402application/json

404application/json

429application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`