Data API / DataForSEO / SERP

SERP API Page Screenshot

Returns a rendered screenshot of a search result page on Google. Returns keyword, type, se_domain, location_code, language_code, check_url, datetime, spell, refinement_chips, item_types, items_count and items. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200.

Параметры

Параметров пути, запроса и заголовков нет.

Тело запроса

task_idstringОбязательный
Unique identifier of the associated task in UUID format; can be used within 7 days
browser_presetstringНеобязательный
Browser resolution preset: desktop, tablet, or mobile
browser_screen_widthintegerНеобязательный
Browser resolution width; range 240-9999
browser_screen_heightintegerНеобязательный
Browser resolution height; range 240-9999
browser_screen_scale_factornumberНеобязательный
Browser scale factor; range 0.5-3
pageintegerНеобязательный
SERP page number to screenshot; default 1

Пример запроса

curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/screenshot" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "task_id": "<string>",
  "browser_preset": "<string>",
  "browser_screen_width": 0,
  "browser_screen_height": 0,
  "browser_screen_scale_factor": 0,
  "page": 0
}'

Ответ

Поля ответа

versionstringНеобязательный
The current version of the API
status_codeintegerНеобязательный
General status code
status_messagestringНеобязательный
General informational message
timestringНеобязательный
Execution time, seconds
costnumberНеобязательный
Total task cost, USD
tasksstring[]Необязательный
Array of tasks
idstringНеобязательный
Task identifier in UUID format
status_codeintegerНеобязательный
Task status code
status_messagestringНеобязательный
Task status message
result_countintegerНеобязательный
Number of elements in the result array
pathstring[]Необязательный
URL path
dataobjectНеобязательный
Contains the same parameters specified in the POST request
resultstring[]Необязательный
Array of results
items_countintegerНеобязательный
Number of items in the results array
itemsstring[]Необязательный
Items array
imagestringНеобязательный
URL of the page screenshot on DataForSEO storage