步骤一:批量提交查询请求,并获得提取任务ID
接口地址:https://apidatav2.chinaz.com/batch/sogoupc/keywordtop50
返回格式:JSON
请求方式:POST(form-data类型)
请求参数:
名称 |
类型 |
必填 |
说明 |
key |
string |
是 |
申请接口时获取的key |
keywords |
string |
是 |
获取的关键词,多个用“|”隔开 如:站长|站长之家 (每个关键词算一次查询,最高支持50个) |
返回参数说明:
名称 |
类型 |
说明 |
StateCode |
int |
状态 |
Reason |
string |
状态说明 |
TaskID |
string |
成功返回的任务ID |
Total |
int |
成功提交总条数 |
JSON返回示例:
{
"StateCode": 1,
"Reason": "提交成功",
"TaskID": "b34b709845fd476188e3341d",
"Total": 2
}
步骤二:根据提取任务ID查询数据是否采集完成,如果完成则得到Json格式结果
接口地址:https://apidatav2.chinaz.com/batch/apiresut
返回格式:JSON
请求方式:POST(form-data类型)
请求参数:
名称 |
类型 |
必填 |
说明 |
taskid |
string |
是 |
步骤一返回的任务ID |
返回参数说明:
名称 |
类型 |
说明 |
StateCode | int | 状态码 |
Reason | string | 状态说明 |
TaskID | string | 任务ID |
SubmitTime | string | 提交时间 |
FinishedTime | string | 成功时间 |
SubmitCount | int | 成功提交条数 |
SuccessCount | int | 成功抓取条数 |
Keyword | string | 抓取的关键词 |
SiteCount | int | 关键词收录量 |
RankStr | string | 排名(页数-条数) |
Title | string | 标题 |
Url | string | 标题连接 |
Description | string | 描述 |
JSON返回示例:
{
"StateCode": 1,
"Reason": "成功",
"Result": {
"TaskID": "b34b709845fd476188e3341d",
"SubmitTime": "20190125142126",
"FinishedTime": "20190125142129",
"SubmitCount": 2,
"SuccessCount": 2,
"Data": [
{
"Keyword": "站长",
"StateCode": 1,
"Reason": "成功",
"Result": {
"SiteCount": 2727031,
"Ranks": [
{
"RankStr": "1-1",
"Title": "站长工具 - 站长之家",
"Url": "http://tool.chinaz.com",
"Description": "站长工具是站长的必备工具。经常上站长工具..."
},
{
"RankStr": "1-2",
"Title": "808站长推荐9款免费的跨境电商SEO工具-大师SEO",
"Url": "http://www.scdzic.com",
"Description": "[图文]该工具的特点... "
},
{
"RankStr": "1-3",
"Title": " 站长必须学会6个网站运营技巧 - BD... ",
"Url": "http://666.com",
"Description": " 站长必须学会6个网站运营技巧 我运营网站..."
},
...
]
}
},
{
"Keyword": "站长之家",
"StateCode": 1,
"Reason": "成功",
"Result": {
"SiteCount": 904253,
"Ranks": [
{
"RankStr": "1-1",
"Title": "站长之家 - 站长资讯-我们致力于为中文网站提供动力!",
"Url": "http://www.chinaz.com",
"Description": "站长之家(中国站长站)为个人..."
},
{
"RankStr": "1-2",
"Title": "站长工具 - 站长之家",
"Url": "http://tool.chinaz.com",
"Description": "站长工具是站长的必备工具。经常上站..."
},
{
"RankStr": "1-3",
"Title": "站长之家 - 搜狗百科",
"Url": "http://baike.sogou.com",
"Description": "站长之家是一家专业为个人站长与企业..."
},
...
]
}
}
]
}
}
接口地址:https://apidatav2.chinaz.com/single/sogoupc/keywordtop50
返回格式:JSON
请求方式:GET/POST(POST请求用form-data类型)
请求示例:https://apidatav2.chinaz.com/single/sogoupc/keywordtop50?key=申请的key&keyword=站长
请求参数:
名称 |
类型 |
必填 |
说明 |
key |
string |
是 |
申请接口时获取的key |
keyword |
string |
是 |
获取的关键词,如:站长 |
返回参数说明:
名称 |
类型 |
说明 |
StateCode | int | 状态码 |
Reason | string | 状态说明 |
SiteCount | int | 关键词收录量 |
RankStr | string | 排名(页数-条数) |
Title | string | 标题 |
Url | string | 标题连接 |
Description | string | 描述 |
JSON返回示例:
{
"StateCode": 1,
"Reason": "成功",
"Result": {
"SiteCount": 2819006,
"Ranks": [
{
"RankStr": "1-1",
"Title": "站长工具 - 站长之家",
"Url": "http://tool.chinaz.com",
"Description": "站长工具是站长的必备工具。经常上..."
},
{
"RankStr": "1-2",
"Title": "808站长推荐9款免费的跨境电商SEO工具-大师SEO",
"Url": "http://www.scdzic.com",
"Description": "[图文]该工具的特点... "
},
{
"RankStr": "1-3",
"Title": " 站长必须学会6个网站运营技巧... ",
"Url": "http://666.com",
"Description": " 站长必须学会6个网站运营技巧 我运营网站..."
},
...
]
}
}