DataForSEO SERP API icon

DataForSEO SERP API

DataForSEO SERP API

Actions87

Google → Get Google Local Finder SERP HTML

AI-generated

Summary

Fetch HTML content of the Google Local Finder SERP for a specified keyword and geographic/location context.

Inputs

  • Keyword (required) — The search keyword string (up to 700 characters) for querying the Google Local Finder results, with percent-encoding rules explained in the hint.
  • Task Priority — Set the execution priority of the request; options are Normal or High priority.
  • Location (required) — Full name of the search engine location to target for the SERP results.
  • Language (required) — Full name of the search engine language to use for the query.
  • GPS Coordinates of a Location — Optional GPS coordinate string (latitude,longitude,radius) to specify the geographic region for the search.
  • Device — Device type for the SERP simulation, either Desktop or Mobile.
  • OS — Operating system of the device; for Desktop choose Windows or macOS, for Mobile choose Android or iOS.
  • Depth — Number of results depth to retrieve, ranging from 1 to 700, defaulting to 100.
  • Filter Results by Minimum Rating — Minimum rating filter value to apply on results, with specific options provided and mobile-only applicability noted for some values.
  • Filter Results by Open Hours — Time filter string to restrict results by open hours status, supporting values like "open_now", "24_hours", or day and time specific filters.

Output shape

a single record containing the raw HTML content of the Google Local Finder search engine results page matching the input parameters.

The response returns HTML as raw data, suitable for parsing or display; pagination or multi-page results must be managed via the 'depth' parameter. All input parameters except Task Priority, GPS Coordinates, Device, OS, Depth, and filters are required for meaningful output.

Examples

Example 1: Retrieve Google Local Finder HTML for a bakery keyword in New York City on desktop.

Keyword='bakery', Location='New York City, New York, United States', Language='English', Device='desktop', OS='windows'.

Links

Discussion