DataForSEO SERP API icon

DataForSEO SERP API

DataForSEO SERP API

Actions87

Google → Get Live Google Maps SERP Advanced

AI-generated

Summary

Retrieve live Google Maps search results for a specified keyword using advanced parameters to customize location, language, device, and other search options.

Inputs

  • Keyword (required) — The search keyword to query, supporting up to 700 characters with URL-encoded symbols decoded. Use %25 for a literal percent sign and %2B for a plus sign.
  • Location (required) — Full name of the search engine location to simulate. Refer to DataForSEO documentation for supported locations.
  • Language (required) — Full name of the search engine language to use. Refer to DataForSEO documentation for supported languages.
  • GPS Coordinates of a Location — Optional latitude, longitude, and radius to specify geographic search area, formatted as 'latitude,longitude,radius' (e.g., 53.476225,-2.243572,200).
  • Device — Specify the device type for the search query, either Desktop or Mobile. Defaults to Desktop.
  • OS — Specify the operating system of the device. Options depend on the Device selection: Windows or macOS for Desktop, Android or iOS for Mobile.
  • Search Engine Domain — Override the default search engine domain inferred from location and language (e.g., google.co.uk, google.com.au).
  • Depth — Number of search results depth to retrieve, from 1 to 700. Defaults to 100.
  • Direct URL of the Search Query — Provide a direct Google search URL to parse the relevant parameters for the query.
  • Page Crawl Limit — Limits the number of pages to crawl in the search results, between 1 and 100.
  • Search This Area — Boolean to enable or disable the 'search this area' mode for geo-targeted results. Defaults to true.
  • Search Places Mode — Boolean to enable or disable the 'search places' mode to obtain Google Maps results focused on a specific place. Defaults to true.

Output shape

a JSON object containing detailed live Google Maps SERP data including listings and metadata according to the advanced input parameters.

The response reflects live Google Maps data with support for extensive query customization. The result includes structured data on local map listings and search context. Optional parameters affect result depth, device emulation, geotargeting, and search restrictions. Paging limits and URL-based queries are supported.

Links

Discussion