Skip to main content
POST
设置 Google 自然搜索 SERP 任务
设置 Google Organic SERP 任务。标准的基于任务的端点。仅在设置任务时向您的账户收费。每次 POST 调用最多可发送 100 个任务。

示例

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
keyword
string
必填

要搜索的关键词

location_name
string

搜索引擎位置的完整名称

location_code
integer

搜索引擎位置代码

location_coordinate
string

某个位置的 GPS 坐标

language_name
string

搜索引擎语言的完整名称

language_code
string

搜索引擎语言代码

depth
integer

解析深度,默认值为 100,最大值为 700

max_crawl_pages
integer

页面抓取上限,最大值为 100

device
string

设备类型:desktop 或 mobile

os
string

设备操作系统

group_organic_results
boolean

将相关结果显示为分组的自然搜索结果

calculate_rectangles
boolean

计算高级结果中 SERP 元素的像素排名

postback_url
string

用于接收已完成任务结果的回调 URL

pingback_url
string

用于任务完成通知的 Pingback URL

postback_data
string

回传负载类型

tag
string

用户定义的任务标识符

响应

成功响应

version
string

API 版本

status_code
integer

通用状态码

status_message
string

一般信息消息

time
string

执行时间

cost
number

任务总成本(USD)

tasks_count
integer

请求中的任务数量

tasks_error
integer

返回错误的任务数量

tasks
string

任务对象数组

tasks[].id
string

UUID 格式的任务标识符

tasks[].status_code
integer

任务状态码

tasks[].status_message
string

任务状态消息

tasks[].cost
number

任务成本

tasks[].result_count
integer

结果元素数量