Data API / DataForSEO / SERP
Setting Google Dataset Search Tasks
Queues datasets matching a query in Google Dataset Search 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 datasets for
language_namestringНеобязательныйFull name of search engine language
language_codestringНеобязательныйSearch engine language code
osstringНеобязательныйDevice operating system, such as windows or macos
last_updatedstringНеобязательныйLast time the dataset was updated, such as 1m, 1y, or 3y
file_formatsstring[]НеобязательныйDataset file formats, such as other, archive, text, image, document, or tabular
usage_rightsstringНеобязательныйUsage rights, such as commercial or noncommercial
priorityintegerНеобязательныйTask priority
postback_urlstringНеобязательныйURL for sending task results
pingback_urlstringНеобязательныйNotification URL of a completed task
postback_datastringНеобязательныйPostback datatype; possible value: advanced
Пример запроса
curl -X POST "https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_search/task_post" \
-H "Authorization: Bearer $FELO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"keyword": "<string>",
"language_name": "<string>",
"language_code": "<string>",
"os": "<string>",
"last_updated": "<string>",
"file_formats": [
"<string>"
],
"usage_rights": "<string>",
"priority": 0
}'Ответ
Поля ответа
versionstringНеобязательныйThe current version of the API
status_codeintegerНеобязательныйGeneral status code
status_messagestringНеобязательныйGeneral informational message
timestringНеобязательныйExecution time, seconds
costnumberНеобязательныйTotal tasks cost, USD
tasks_countintegerНеобязательныйThe number of tasks in the tasks array
tasks_errorintegerНеобязательныйThe number of tasks in the tasks array 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НеобязательныйCost of the task, USD
result_countintegerНеобязательныйNumber of elements in the result array