/api/v1/serp
Single-Engine Live SERP & Dynamic Rank Match
Fetches organic results, AI Overview detection, and SERP features for a keyword on any of the 7 supported engines. Supplying domain= automatically computes target_domain_rank without extra credits. (Cache: 24-Hour SERP Vault)
Request Parameters
0 Cr charged on 400 validation errors| Parameter | Type & Default | Description & Allowed Values |
|---|---|---|
keyword
REQ |
string
def: —
|
Search query to check. |
engine
|
enum
def: "google"
|
"google", "bing", "yahoo", "youtube", "seznam", "naver", or "baidu". |
location
|
string
def: "United States"
|
Country / market name (e.g. United States, United Kingdom, Germany, India). |
language
|
string
def: "English"
|
Search interface language. |
domain
|
string
def: null
|
Optional root domain for automatic organic rank & URL matching. |
depth
|
integer
def: 20
|
SERP result depth (10–100). |
mode
|
enum
def: "auto"
|
"sandbox" (0 Cr), "vault" (24h cache), "live", or "auto". |