Skip to main content
POST
Live SERP results

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

X-API-Key
string | null

Query Parameters

project_id
string<uuid> | null

Project ID for search history

Body

application/json

Request body for live SERP lookup.

keyword
string
required

Keyword to retrieve SERP results for.

Required string length: 1 - 500
location_code
integer
required

DataForSEO location code (e.g. 2840 = United States).

language_code
string
required

Language code (e.g., 'en', 'de', 'fr').

Maximum string length: 10
depth
integer
default:10

Number of SERP results to retrieve.

Required range: 1 <= x <= 100

Response

Successful Response

success
boolean
default:true
data
SerpResponse · object | null

Full SERP response for a keyword.