Skip to main content
POST
设置 Google 自然搜索 SERP 任务

授权

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

结果元素数量