DataForSEO
SEO, search-engine results, keyword research, backlinks and AI visibility data.
获取 Google 评价已完成任务
列出已完成、等待收取的 Google Shopping 评价任务。免费。采用 DataForSEO 的信封结构：数据位于 tasks[0].result，结果状态位于 tasks[0].status_code——被拒绝的请求仍会返回 HTTP 200。持有任务 id 的调用方可直接获取结果，跳过此步骤。
计费参考
- 计量方式：按上报的响应成本计量。
- 参考请求估算：0.012 美元。
- 参考客户倍率：1.0。不得对已结算的客户金额再次应用。
仅供参考的元数据，不是账户报价、保证价格或消费上限。资源额度不同于 Felo 额度。最终扣费以 Felo 计费记录为准。
- 类型: object200
成功响应
- 类型: numbercost
任务总费用，美元
- 类型: integerstatus
_code 通用状态码 完整响应码列表见此处 注意：我们强烈建议设计必要的系统来处理相关的异常或错误情况
- 类型: stringstatus
_message 通用信息性消息 完整的一般信息性消息列表见此处
- 类型: array string[]tasks
任务数组
- 类型: integertasks
_count tasks 数组中的任务数
- 类型: integertasks
_error tasks 数组中返回错误的任务数
- 类型: numbertasks
.cost 任务费用，美元
- 类型: objecttasks
.data 包含通过请求 URL 传递的参数
- 类型: stringtasks
.id 任务标识符 我们系统中 UUID 格式的唯一任务标识符
- 类型: array string[]tasks
.path URL 路径
- 类型: array string[]tasks
.result 结果数组
- 类型: integertasks
.result _count result 数组中的元素数
- 类型: stringtasks
.result .date _posted 任务提交的日期（UTC 格式）
- 类型: stringtasks
.result .endpoint _advanced 用于收集 Google Shopping Product Specifications Advanced 任务结果的 URL
- 类型: stringtasks
.result .endpoint _html 用于收集 Google Shopping Product Specifications HTML 任务结果的 URL。注意：此端点不提供 HTML，该值将为 null
- 类型: stringtasks
.result .id 已完成任务的标识符 我们系统中采用 UUID 格式的唯一任务标识符
- 类型: stringtasks
.result .se 设置任务时指定的搜索引擎
- 类型: stringtasks
.result .se _type 搜索引擎类型。可取值：shopping_specifications
- 类型: integertasks
.status _code DataForSEO 生成的任务状态码；范围如下：10000-60000 完整响应码列表见此处
- 类型: stringtasks
.status _message 任务的信息性消息 完整的一般信息性消息列表见此处
- 类型: stringtasks
.time 执行时间，秒
- 类型: stringtime
执行时间，秒
- 类型: stringversion
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/merchant/google/reviews/tasks_ready \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"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.time": "string",
"tasks.cost": 1,
"tasks.result_count": 1,
"tasks.path": [
"string"
],
"tasks.data": {},
"tasks.result": [
"string"
],
"tasks.result.id": "string",
"tasks.result.se": "string",
"tasks.result.se_type": "string",
"tasks.result.date_posted": "string",
"tasks.result.endpoint_advanced": "string",
"tasks.result.endpoint_html": "string"
}