DataForSEO SERP API icon

DataForSEO SERP API

DataForSEO SERP API

Actions87

Google → Get Google Images SERP HTML

AI-generated

Summary

Retrieve the raw HTML of Google Images search engine results pages (SERP) based on a specified keyword and search parameters.

Inputs

  • Keyword (required) — Specify the search keyword for the image query, up to 700 characters. Encode '%' as '%25' and '+' as '%2B' if these symbols are needed literally.
  • Task Priority — Set the execution priority of the task to either normal or high.
  • Location (required) — Provide the full name of the search engine location to localize the query. Refer to DataForSEO docs for supported locations.
  • Language (required) — Set the search engine language by full name, according to supported languages in DataForSEO documentation.
  • GPS Coordinates of a Location — Optional GPS coordinates in 'latitude,longitude,radius' format to specify location more precisely.
  • OS — Select the device operating system (Windows or macOS) to emulate desktop OS in the search.
  • Search Engine Domain — Optionally specify a custom Google search engine domain (like google.co.uk) overriding automatic selection.
  • Depth — Number of results depth to crawl, from 1 to 700, defaults to 100.
  • Direct URL of the Search Query — Provide a direct URL for the search query to parse instead of using keyword and parameters.
  • Page Crawl Limit — Limit the maximum number of pages to crawl, from 1 to 100.
  • Additional Parameters of the Search Query — Add any extra search parameters as a string to customize the query.

Output shape

a single record containing the raw HTML content of the Google Images SERP for the specified query and parameters.

The result is the full HTML of the Google Images search results page as returned by the DataForSEO API. No parsed or structured data is returned from this operation. User must provide all required inputs to define the query environment such as keyword, language, location; optional parameters can adjust priority, depth, OS, and more.

Examples

Example 1: Get Google Images SERP HTML for the keyword 'kittens' in English and New York location with high priority and depth of 50 results.

Set Keyword to 'kittens', Location to 'New York, United States', Language to 'English', Task Priority to 'High Execution Priority', and Depth to 50.

Links

Discussion