Data API / DataForSEO / SERP

Live Google Images SERP HTML

Returns the image results for a keyword on Google, synchronously. Raw page source rather than parsed results. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Parameters

No path, query, or header parameters.

Request body

keywordstringRequired
Keyword to search for
location_codeintegerOptional
Search engine location code
location_namestringOptional
Full name of search engine location
location_coordinatestringOptional
GPS coordinates of a location
language_codestringOptional
Search engine language code
language_namestringOptional
Full name of search engine language
devicestringOptional
Device type: desktop or mobile

Example request

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/images/live/html" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keyword": "<string>",
  "location_code": 0,
  "location_name": "<string>",
  "location_coordinate": "<string>",
  "language_code": "<string>",
  "language_name": "<string>",
  "device": "<string>"
}'

Response

Response fields

versionstringOptional
The current version of the API
status_codeintegerOptional
General status code
status_messagestringOptional
General informational message
timestringOptional
Execution time, seconds
costnumberOptional
Total tasks cost, USD
tasksstring[]Optional
Array of tasks
resultstring[]Optional
Array of HTML results