DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
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.
- 类型: array object[]
- keyword类型: string必填
Keyword to search datasets for
- file类型: array string[]
_formats Dataset file formats, such as other, archive, text, image, document, or tabular
- language类型: string
_code Search engine language code
- language类型: string
_name Full name of search engine language
- last类型: string
_updated Last time the dataset was updated, such as 1m, 1y, or 3y
- os类型: string
Device operating system, such as windows or macos
- pingback类型: string
_url Notification URL of a completed task
- postback类型: string
_data Postback datatype; possible value: advanced
- postback类型: string
_url URL for sending task results
- priority类型: integer
Task priority
- usage类型: string
_rights Usage rights, such as commercial or noncommercial
- 类型: object200
Successful response
- 类型: numbercost
Total tasks cost, USD
- 类型: integerstatus
_code General status code
- 类型: stringstatus
_message General informational message
- 类型: array string[]tasks
Array of task objects
- 类型: integertasks
_count The number of tasks in the tasks array
- 类型: integertasks
_error The number of tasks in the tasks array returned with an error
- 类型: numbertasks[]
.cost Cost of the task, USD
- 类型: stringtasks[]
.id Task identifier in UUID format
- 类型: integertasks[]
.result _count Number of elements in the result array
- 类型: integertasks[]
.status _code Task status code
- 类型: stringtasks[]
.status _message Task status message
- 类型: stringtime
Execution time, seconds
- 类型: stringversion
The current version of the API
application/json - 400
Bad request
- 401
Unauthorized
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
Rate limit exceeded
- 500
Internal server error
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_search/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"keyword": "",
"language_name": "",
"language_code": "",
"os": "",
"last_updated": "",
"file_formats": [
""
],
"usage_rights": "",
"priority": 1,
"postback_url": "",
"pingback_url": "",
"postback_data": ""
}
]'
{
"version": "string",
"status_code": 1,
"status_message": "string",
"time": "string",
"cost": 1,
"tasks_count": 1,
"tasks_error": 1,
"tasks": [
"string"
],
"tasks[].id": "string",
"tasks[].status_code": 1,
"tasks[].status_message": "string",
"tasks[].cost": 1,
"tasks[].result_count": 1
}