データ API / DataForSEO / SERP

Setting Google Dataset Info Tasks

Queues one dataset's record 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.

パラメータ

パス・クエリ・ヘッダーのパラメータはありません。

リクエストボディ

dataset_idstring必須
ID of the dataset; you can find it in the dataset URL or in a Google Dataset Search result
language_namestring任意
Full name of search engine language
language_codestring任意
Search engine language code
devicestring任意
Device type; possible value: desktop
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_info/task_post" \
  -H "Authorization: Bearer $FELO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dataset_id": "<string>",
  "language_name": "<string>",
  "language_code": "<string>",
  "device": "<string>",
  "priority": 0,
  "postback_url": "<string>",
  "pingback_url": "<string>",
  "postback_data": "<string>"
}'

レスポンス

レスポンスのフィールド

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