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

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

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`