步骤一:批量提交查询请求,并获得提取任务ID
接口地址:https://apidatav2.chinaz.com/batch/sopc/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": "9342340364744686a3c8d638",
"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": "9342340364744686a3c8d638",
"SubmitTime": "20190125152416",
"FinishedTime": "20190125152425",
"SubmitCount": 2,
"SuccessCount": 2,
"Data": [
{
"Keyword": "站长",
"StateCode": 1,
"Reason": "成功",
"Result": {
"SiteCount": 100000000,
"Ranks": [
{
"RankStr": "1-1",
"Title": "站长工具- 站长之家",
"Url": "http://tool.chinaz.com/",
"Description": "站长工具是站长的必备工具..."
},
{
"RankStr": "1-2",
"Title": "站长素材-分享综合设计素材的平台",
"Url": "http://sc.chinaz.com/",
"Description": "站长素材是一家大型综合设计类素材网站..."
},
{
"RankStr": "1-3",
"Title": "SEO综合查询- 站长工具",
"Url": "http://seo.chinaz.com/",
"Description": "当前位置: 站长工具 SEO综合查询...."
},
...
]
}
},
{
"Keyword": "站长之家",
"StateCode": 1,
"Reason": "成功",
"Result": {
"SiteCount": 8690000,
"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": "SEO综合查询- 站长工具",
"Url": "http://seo.chinaz.com/",
"Description": "当前位置: 站长工具 SEO综合查询...."
},
...
]
}
}
]
}
}
接口地址:https://apidatav2.chinaz.com/single/sopc/keywordtop50
返回格式:JSON
请求方式:GET/POST(POST请求用form-data类型)
请求示例:https://apidatav2.chinaz.com/single/sopc/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": 100000000,
"Ranks": [
{
"RankStr": "1-1",
"Title": "站长工具- 站长之家",
"Url": "http://tool.chinaz.com/",
"Description": "站长工具是站长的必备工具..."
},
{
"RankStr": "1-2",
"Title": "站长素材-分享综合设计素材的平台",
"Url": "http://sc.chinaz.com/",
"Description": "站长素材是一家大型综合设计类素材网站..."
},
{
"RankStr": "1-3",
"Title": "SEO综合查询- 站长工具",
"Url": "http://seo.chinaz.com/",
"Description": "当前位置: 站长工具 SEO综合查询..."
},
...
]
}
}