SERP — Google Organic (Live)
dataforseo/serp_google_organic_liveAvailable
Real-time Google organic SERP for any keyword + location. Returns ranked URLs, titles, snippets, sitelinks, knowledge graph. Up to 100 results per request.
Retail priceinput $0.004
Providerdataforseo
Capabilityhttp
InterfacePOST /v1/run
Request example
Every paid call needs a unique Idempotency-Key. The same key and payload replay the original result without a second charge.
curl https://router.tycoon.cool/v1/run \
+ -H "Authorization: Bearer $TYCOONROUTER_API_KEY" \
+ -H "Content-Type: application/json" \
+ -H "Idempotency-Key: $(uuidgen)" \
+ -d '{"model":"dataforseo/serp_google_organic_live","inputs":{"messages":[{"role":"user","content":"Hello"}]}}'Response contract
Synchronous routes return the provider result with TycoonRouter request metadata. Async routes return a request ID plus status and cancel URLs.
| Header | Purpose |
|---|---|
| x-request-id | Immutable Router request identity |
| x-idempotent-replay | True when the response is a replay |
| x-tycoonrouter-charge-micros | Settled retail charge when available |
Production safeguards
Unknown prices, unbounded requests and uncertain provider outcomes fail closed before a second paid dispatch. Usage and wallet events remain queryable from the account page.