DataForSEO SERP API icon

DataForSEO SERP API

DataForSEO SERP API

Actions87

Google → Get Google Images SERP Advanced

AI-generated

Summary

Retrieve detailed, advanced Google Images SERP data for a specified keyword and search parameters, including location, language, and device OS options.

Inputs

  • Keyword (required) — The search keyword, supporting up to 700 symbols with decoding rules for special characters.
  • Task Priority — Execution priority of the search task; defaults to normal priority.
  • Location (required) — Full name of the search engine location to target the SERP data.
  • Language (required) — Full name of the language for the Google search engine results.
  • GPS Coordinates of a Location — Optional GPS coordinates in latitude,longitude,radius format to locate the search precisely.
  • OS — Operating system filter for desktop-only device results; options are Windows or macOS.
  • Search Engine Domain — Custom Google domain override, if different from the one deduced from location and language.
  • Depth — Number of results or pages depth to retrieve, integer from 1 to 700, defaulting to 100.
  • Direct URL of the Search Query — Direct URL of a search query to parse, used instead of keyword and parameters.
  • Page Crawl Limit — Maximum limit on pages to crawl, integer from 1 to 100.
  • Additional Parameters of the Search Query — Extra search parameters in string format to refine or customize the query.

Output shape

a JSON object containing the advanced Google Images SERP data matching the input parameters

The response structure corresponds to the DataForSEO Google Images advanced SERP API data format, including detailed image search results. Output fields may include images, URLs, snippets, and other rich metadata. Pagination and result-depth is controlled by 'depth' and 'max_crawl_pages' inputs. Errors are returned in standard DataForSEO error envelopes.

Examples

Example 1: Retrieve advanced Google Images SERP results for the keyword "puppies" in New York, English language, Windows OS, with normal priority and default depth.

Set Keyword to "puppies", Location to "New York, United States", Language to "English", OS to "Windows", Task Priority to "Normal Execution Priority"; omit optional curl parameters for defaults.

Links

Discussion