Collect organic SERP SEO evidence

Run one live organic SERP check for SEO optimization evidence, including target visibility, competitor domains, rich SERP features, 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?string

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

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.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

query*string

Search query to inspect.

target?string

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

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.

device?string

SERP device type. Defaults to desktop.

os?string

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.

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.

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.

view?string

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.

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.

google_search_params?string

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

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.

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.

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.

target_element_types?array<>

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

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

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "credits_charged": 0,      "records_charged": 0,      "balance_remaining": 0,      "truncated_due_to_balance": true    }  }}

{  "error": {    "type": "validation_error",    "message": "string",    "request_id": "string",    "issues": [      null    ],    "billing": {      "credits_required": 0,      "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`