DataForSEO Google SERP (Advanced)

API docs
https://api.sandbase.ai/v1/api/dataforseo/v3/serp/google/organic/live/advanced

Get live Google organic search results for any keyword, location and language, including AI Overviews, featured snippets, People Also Ask and other SERP features, with rank positions and URLs.

Price
From $0.002USD / call
Method
POST
Response
JSON
Parameters
0 required · 4 optional

Playground

Input
Search query, e.g. "openai api".
DataForSEO location code, e.g. 2840 for the United States.
Language code, e.g. "en".
Number of results to return (default 100).
OutputReady

Your output will appear here

Complete the inputs, then click Run.

API README

Google SERP API (Advanced)

Live Google search results for a keyword in any location, language and device: organic results with position, title, URL and snippet, plus the other SERP features on the page such as AI Overview, featured snippets, People Also Ask, local pack and video results.

Use cases

  • Track rankings for your keywords in specific cities or countries.
  • Read the AI Overview and its cited sources for a query.
  • Feed fresh search results to an agent or a content brief.

Request

curl -X POST "https://api.sandbase.ai/v1/api/dataforseo/v3/serp/google/organic/live/advanced" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "running shoes", "location_code": 2840, "language_code": "en"}'

The result is returned in outputs[0].

Parameters

NameTypeRequiredDescription
depthstringNoNumber of results to return (default 100).
keywordstringNoSearch query, e.g. "openai api".
language_codestringNoLanguage code, e.g. "en".
location_codeintegerNoDataForSEO location code, e.g. 2840 for the United States.

Example response

Real response for the request above, trimmed: lists keep their first item and long strings are cut.

{
  "status_code": 20000,
  "tasks": [
    {
      "result": [
        {
          "keyword": "running shoes",
          "check_url": "https://www.google.com/search?q=running%20shoes&hl=en&gl=US&ie=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
          "item_types": [
            "ai_overview",
            "organic",
            "local_pack",
            "images",
            "perspectives",
            "product_considerations",
            "related_searches"
          ],
          "se_results_count": 74,
          "items": [
            {
              "type": "organic",
              "rank_group": 3,
              "rank_absolute": 7,
              "domain": "shop.runnersdepot.com",
              "title": "Running and Walking Shoes",
              "url": "https://shop.runnersdepot.com/",
              "description": "Shop online with Runner's. Running and Walking Shoes. Shop by Category Shoes Insoles S…"
            }
          ]
        }
      ]
    }
  ]
}

Response fields

FieldMeaning
result[].item_typesSERP feature types present on the page, e.g. organic, ai_overview, people_also_ask.
result[].items[]Every element in page order. Organic rows have type: "organic", rank_group, rank_absolute, title, url, domain and description.
items[] (type ai_overview)AI Overview text in markdown and its references (source title, URL, domain).
result[].check_urlThe Google URL that was searched, for manual checks.
result[].se_results_countGoogle's reported number of results.

Notes

  • depth sets how many results are fetched; the cost grows with the number of result pages.
  • Some organic url values come back as google.com/goto?url=... redirect links, as Google serves them; follow the redirect to get the destination.
  • location_code 2840 is the United States; use location_name such as "London,England,United Kingdom" for cities.
  • The response keeps DataForSEO's original JSON; results are under tasks[0].result[0].

Pricing

Billed at the actual cost of each call, about $0.002 for the request above. Failed calls are not charged.

Explore more

Related APIs

All APIs
APIPriceResponse
DataForSEOFrom $0.002 per callJSON
DataForSEOFrom $0.0102 per callJSON
DataForSEOFrom $0.000724 per callJSON
DataForSEO$0.004 per callJSON
DataForSEOFrom $0.00162 per callJSON
DataForSEOFrom $0.001105 per callJSON

Questions

FAQ

How do I use the DataForSEO Google SERP (Advanced) API?

Send a POST request to https://api.sandbase.ai/v1/api/dataforseo/v3/serp/google/organic/live/advanced with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the DataForSEO Google SERP (Advanced) API cost?

From $0.002 per call, billed from your SandBase balance. You are only charged for calls you make; there is no subscription.

What parameters does the DataForSEO Google SERP (Advanced) API accept?

No parameters are required. Optional: keyword (string), location_code (integer), language_code (string) and depth (string). The Parameters table and the Playground on this page list every field.

What does the DataForSEO Google SERP (Advanced) API return?

A JSON response returned in the same HTTP request (synchronous). The README on this page includes a sample response.

Do I need a DataForSEO developer account or API key?

No. DataForSEO Google SERP (Advanced) runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for DataForSEO API access separately.