DataForSEO SERP API icon

DataForSEO SERP API

DataForSEO SERP API

Actions87

Google → Get Live Google Organic SERP Regular

AI-generated

Summary

Fetch Live Organic Google Search Engine Results Page (SERP) data for a specified keyword, language, and location using the Google regular organic SERP endpoint.

Inputs

  • Keyword (required) — The search term to query on Google, up to 700 characters. Special URL encoding rules apply for '%' and '+' symbols.
  • Location (required) — The full name of the geographic location for the search engine, determining local SERP results.
  • Language (required) — The full name of the language to use for the search results.
  • GPS Coordinates of a Location — Optional latitude, longitude, and radius to specify an exact search location, in the format 'latitude,longitude,radius'.
  • Device — Choose between desktop or mobile devices for the search context; defaults to desktop.
  • OS — Specify the operating system of the device, matching the chosen device type (Windows/macOS for desktop, Android/iOS for mobile).
  • Search Engine Domain — Optionally override the automatic search engine domain selection (e.g., google.co.uk).
  • Depth — Maximum number of SERP results to return. Defaults to 100, maximum 700.
  • Target — Specify a domain, subdomain, or webpage to filter SERP results containing URLs matching the target pattern, with support for wildcards.
  • Direct URL of the Search Query — Provide a direct Google search URL which the node will parse to extract necessary parameters.
  • Display Related Results? — If true, embeds related results as snippets within their parent organic results in the response; defaults to true.
  • Page Crawl Limit — Limits the number of additional pages to crawl for search results; optional.
  • Additional Parameters of the Search Query — Extra query parameters to customize the search request.

Output shape

a structured JSON object containing live organic search results from Google SERP

The response includes detailed organic search result elements matched to the query, respecting all input parameters; related results may be included inline if enabled. Pagination or multi-page crawling is controlled via 'Page Crawl Limit' if used. Errors follow the node's standard error handling.

Links

Discussion