Google organic results
dataforseo/serp_google_organic_liveReturn a parsed Google results page for a query in a given market.
- call
- $0.004
- DataForSEO
- 3 min
Overview
Runs a live web search and returns the whole results page decomposed into structured elements rather than markup. Beyond the ten blue links it captures the surrounding furniture — featured snippets, related questions, knowledge panels, local packs, ads, video and image blocks, AI overviews — each labelled by type and carrying both its rank among its own kind and its absolute position on the page. The market and language decide which engine edition is queried, so the same query can be compared across countries.
One results page, broken into typed and ranked elements with their titles, URLs, domains, and descriptions.
Input
These go in the input object of the run request.
| Field | Type | Required | Description |
|---|---|---|---|
| keyword | string | Yes | The search query to run, up to 700 characters. |
| location_code | integer | Yes | Which market to search from. |
| language_code | string | No | Interface and result language. |
| depth | integer | No | How many results to parse. |
| device | string | No | Which device to emulate. |
| target | string | No | Only return results from this domain, written without a scheme or `www`. |
Requests up to 1 MB.
Example
A call that works, with your own key.
curl https://gateway.agentsky.dev/v1/run \
-H "authorization: Bearer $AGENTSKY_API_KEY" \
-H "content-type: application/json" \
-d '{"provider":"dataforseo","endpoint":"serp_google_organic_live","input":{"keyword":"agent gateways","location_code":2840,"language_code":"en","depth":20}}'Pricing
$0.004 per call on the default plan. That is the list price; when the provider reports what a call actually cost, you are billed that instead. Every run carries its price in the response.