Data API / DataForSEO / SERP
Setting Google Organic SERP Tasks
Queues the ranked results for a keyword on Google, returning a task id in tasks[0].id. Wrapped in DataForSEO's envelope: data in tasks[0].result, outcome in tasks[0].status_code - a rejected request still returns HTTP 200. The live twin answers immediately and is simpler for a single query; queue when the batch would outlast a tool call.
Параметры
Параметров пути, запроса и заголовков нет.
Тело запроса
keywordstringОбязательныйKeyword to search for
location_namestringНеобязательныйFull name of search engine location
location_codeintegerНеобязательныйSearch engine location code
location_coordinatestringНеобязательныйGPS coordinates of a location
language_namestringНеобязательныйFull name of search engine language
language_codestringНеобязательныйSearch engine language code
depthintegerНеобязательныйParsing depth, default 100, max 700
max_crawl_pagesintegerНеобязательныйPage crawl limit, max 100
devicestringНеобязательныйDevice type: desktop or mobile
osstringНеобязательныйDevice operating system
group_organic_resultsbooleanНеобязательныйDisplay related results as grouped organic results
calculate_rectanglesbooleanНеобязательныйCalculate pixel rankings for SERP elements in advanced results
postback_urlstringНеобязательныйPostback URL for completed task results
pingback_urlstringНеобязательныйPingback URL for task completion notification
postback_datastringНеобязательныйPostback payload type
tagstringНеобязательныйUser-defined task identifier
Пример запроса
curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/organic/task_post" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "<string>",
"location_name": "<string>",
"location_code": 0,
"location_coordinate": "<string>",
"language_name": "<string>",
"language_code": "<string>",
"depth": 0,
"max_crawl_pages": 0
}'Ответ
Поля ответа
versionstringНеобязательныйAPI version
status_codeintegerНеобязательныйGeneral status code
status_messagestringНеобязательныйGeneral informational message
timestringНеобязательныйExecution time
costnumberНеобязательныйTotal tasks cost in USD
tasks_countintegerНеобязательныйNumber of tasks in the request
tasks_errorintegerНеобязательныйNumber of tasks returned with an error
tasksstringНеобязательныйArray of task objects
idstringНеобязательныйTask identifier in UUID format
status_codeintegerНеобязательныйTask status code
status_messagestringНеобязательныйTask status message
costnumberНеобязательныйTask cost
result_countintegerНеобязательныйNumber of result elements