DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
设置 Google 数据集信息任务
将 Google 数据集搜索中某条数据集的记录排入队列，返回 tasks[0].id 中的任务 id。采用 DataForSEO 的信封结构：数据位于 tasks[0].result，结果状态位于 tasks[0].status_code——被拒绝的请求仍会返回 HTTP 200。实时版本会立即返回，单个查询更简单；当批量任务会超过一次工具调用时，再使用队列。
计费参考
- 计量方式：按上报的响应成本计量。
- 参考请求估算：0.02 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: array (object | null)[]
- dataset类型: string
_id - device类型: string | null
设备类型
可选字段
返回特定设备类型的结果
可能的值：
desktop - language类型: string | null
_code 搜索引擎语言代码
可选字段
如果使用此字段，则无需指定
language_name可能的值：
en - language类型: string | null
_name 搜索引擎语言全名
可选字段
如果使用此字段，则无需指定
language_code可能的值：
English - os类型: string | null
设备操作系统
可选字段
从以下值中选择：
windows、macos默认值：
windows - pingback类型: string | null
_url 任务完成通知 URL
可选字段
任务完成后，我们会向你指定的 URL 发送 GET 请求进行通知
可将 ‘$id’ 字符串用作
$id变量，将 ‘$tag’ 用作经 URL 编码的$tag变量。发送请求前我们会设置必要的值。示例：
http://your-server.com/pingscript?id=$idhttp://your-server.com/pingscript?id=$id&tag=$tag注意：
pingback_url中的特殊字符会进行 URL 编码；例如，
#字符会被编码为%23
详情请参阅我们的帮助中心
- postback类型: string
_data postback_url 数据类型
指定
postback_url时为必填字段对应将发送到你服务器的数据类型
可能的值：
advanced - postback类型: string | null
_url 用于发送任务结果的 URL
可选字段
任务完成后，我们会将结果以
gzip格式压缩，并向你指定的postback_url发送 POST 请求可将 ‘$id’ 字符串用作
$id变量，将 ‘$tag’ 用作经 URL 编码的$tag变量。发送请求前我们会设置必要的值示例：
http://your-server.com/postbackscript?id=$idhttp://your-server.com/postbackscript?id=$id&tag=$tag注意：
postback_url中的特殊字符会进行 URL 编码；例如，
#字符会被编码为%23
详情请参阅我们的 帮助中心
- priority类型: integer | null
- tag类型: string | null
用户自定义任务标识符
可选字段
字符数上限为 255
可使用此参数标识任务，并将其与结果对应
指定的
tag值可在响应的data对象中找到
- 类型: object | null · Response36Afe1097B20_SerpGoogleDatasetInfoTaskPostResponseInfo200
- 类型: number | null 格式: doublecost
任务总费用，美元
- 类型: integer | nullstatus
_code 通用状态码 完整响应码列表见此处
- 类型: string | nullstatus
_message 通用信息性消息 完整的一般信息性消息列表见此处
- 类型: array (object | null)[] | nulltasks
任务数组
- 类型: object | null · Response36Afe1097B20_SerpGoogleDatasetInfoTaskPostTaskInfo
- cost类型: number | null 格式: double
任务总费用，美元
- data类型: object | null
包含你在 POST 请求中指定的相同参数
- property类型: object | null
Name
- id类型: string | null
任务标识符 我们系统中 UUID 格式的唯一任务标识符
- path类型: array (string | null)[] | null
URL 路径
- result类型: object | null
结果数组
在本例中，该值将为null - result类型: integer | null 格式: int64
_count result 数组中的元素数
- status类型: integer | null
_code 任务的状态码 由 DataForSEO 生成，范围如下：10000-60000 完整响应码列表见此处
- status类型: string | null
_message 任务的信息性消息 完整的一般信息性消息列表见此处
- time类型: string | null
执行时间，秒
- 类型: integer | null 格式: int64tasks
_count tasks 数组中的任务数
- 类型: integer | null 格式: int64tasks
_error tasks 数组中返回错误的任务数
- 类型: string | nulltime
总执行时间，秒
- 类型: string | nullversion
API 的当前版本
application/json - 400
无法处理该请求。请检查请求参数。
- 401
需要有效的 Felo API 密钥。
- 402
由于未满足计费要求，请求无法继续。
- 403
该账户无权执行此操作。
- 429
已达到请求或支出限额。
- 502
服务无法完成该请求。
- 503
API 或计费服务暂时不可用。
- 504
服务在处理请求时超时。
- default
错误响应；上游透传响应可能采用提供方格式
application/json
curl https://openapi.felo.ai/v1/beta/dataforseo/serp/google/dataset_info/task_post \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '[
{
"dataset_id": "L2cvMTFqbl85ZHN6MQ=="
}
]'
{
"version": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"tasks_count": null,
"tasks_error": null,
"tasks": [
{
"id": null,
"status_code": null,
"status_message": null,
"time": null,
"cost": null,
"result_count": null,
"path": [
null
],
"data": null,
"result": null
}
]
}