步骤一:批量提交查询请求,并获得提取任务ID
接口地址:https://apidatav2.chinaz.com/batch/baidumobile/keywordranking
返回格式:JSON
请求方式:POST(form-data类型)
请求参数:
名称 |
类型 |
必填 |
说明 |
key |
string |
是 |
申请接口时获取的key |
domain |
string |
是 |
获取的域名,如:chinaz.com |
keywords |
string |
是 |
获取的关键词,多个用“|”隔开 如:站长|站长之家 (每个关键词算一次查询,最高支持50个) |
top100 |
bool |
否 |
默认值:false 查询50条, 如果为true 查询前100条(扣2次请求次数) |
返回参数说明:
名称 |
类型 |
说明 |
StateCode |
int |
状态 |
Reason |
string |
状态说明 |
TaskID |
string |
成功返回的任务ID |
Total |
int |
成功提交总条数 |
JSON返回示例:
{
"StateCode": 1,
"Reason": "提交成功",
"TaskID": "247a536d314b468da167c0b9",
"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 | 抓取的关键词 |
RankStr | string | 排名(页数-条数) |
Title | string | 标题 |
Url | string | 标题连接 |
XiongzhangID | string | 熊掌ID |
JSON返回示例:
{
"StateCode": 1,
"Reason": "成功",
"Result": {
"TaskID": "247a536d314b468da167c0b9",
"SubmitTime": "20190124152552",
"FinishedTime": "20190124152602",
"SubmitCount": 2,
"SuccessCount": 2,
"Data": [
{
"Keyword": "站长",
"StateCode": 1,
"Reason": "成功",
"Result": {
"Ranks": [
{
"RankStr": "1-1",
"Title": "站长工具 - 站长之家",
"Url": "http://m.tool.chinaz.com/",
"XiongzhangID":"站长之家"
},
{
"RankStr": "2-8",
"Title": "站长素材-分享综合设计素材的平台",
"Url": "http://sc.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "2-9",
"Title": "端口扫描 - 站长工具",
"Url": "http://tool.chinaz.com/port/",
"XiongzhangID":""
},
{
"RankStr": "2-10",
"Title": "网站排行榜 - 站长之家",
"Url": "http://top.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "3-1",
"Title": "源码_网站源码_源码下载_源码之家-站长下载",
"Url": "http://down.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "3-2",
"Title": "站长字体下载-分享PS字体、免费字体、商业字体库",
"Url": "http://font.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "3-4",
"Title": "IP/服务器地址查询 - 站长工具",
"Url": "http://ip.tool.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "4-4",
"Title": "站长安全认证/SSL数字证书申请_ 站长工具",
"Url": "https://aq.chinaz.com/",
"XiongzhangID":""
}
]
}
},
{
"Keyword": "站长之家",
"StateCode": 1,
"Reason": "成功",
"Result": {
"Ranks": [
{
"RankStr": "1-2",
"Title": "站长工具 - 站长之家",
"Url": "http://m.tool.chinaz.com/",
"XiongzhangID":"站长之家"
},
{
"RankStr": "1-4",
"Title": "站长素材-分享综合设计素材的平台",
"Url": "http://sc.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "1-5",
"Title": "源码_网站源码_源码下载_源码之家-站长下载",
"Url": "http://down.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "1-7",
"Title": "站长工具 - 站长之家",
"Url": "http://old.tool.chinaz.com/",
"XiongzhangID":"站长之家"
},
{
"RankStr": "1-10",
"Title": "网站排行榜 - 站长之家",
"Url": "http://top.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "2-4",
"Title": "站长工具 - 站长之家",
"Url": "http://index.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "2-5",
"Title": "草根网站-站长之家",
"Url": "https://m.chinaz.com/tags/caogenwangzhan.shtml",
"XiongzhangID":""
},
{
"RankStr": "2-8",
"Title": "站长之家 - 站长资讯 | 我们致力于为中文网站提供",
"Url": "http://bbs.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "3-8",
"Title": "站长字体下载-分享PS字体、免费字体、商业字体库",
"Url": "http://font.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "3-9",
"Title": "中国站长站|chinaz.com网站Alexa排名、流量、访",
"Url": "http://alexa.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "4-5",
"Title": "站长之家-网站排行榜",
"Url": "http://search.top.chinaz.com/msearch.aspx?url=",
"XiongzhangID":""
},
{
"RankStr": "5-7",
"Title": "主播排行榜_直播大数据服务平台 - 站长之家",
"Url": "https://live.chinaz.com/",
"XiongzhangID":""
}
]
}
}
]
}
}
接口地址:https://apidatav2.chinaz.com/single/baidumobile/keywordranking
返回格式:JSON
请求方式:GET/POST(POST请求用form-data类型)
请求示例:https://apidatav2.chinaz.com/single/baidumobile/keywordranking?key=申请的key
&domain=域名&keyword=关键词
请求参数:
名称 |
类型 |
必填 |
说明 |
key |
string |
是 |
申请接口时获取的key |
domain |
string |
是 |
获取的域名,如:chinaz.com |
keyword |
string |
是 |
获取的关键词,如:站长 |
top100 |
bool |
否 |
默认值:false 查询50条, 如果为true 查询前100条(扣2次请求次数) |
返回参数说明:
名称 |
类型 |
说明 |
StateCode | int | 状态码 |
Reason | string | 状态说明 |
RankStr | string | 排名(页数-条数) |
Title | string | 标题 |
Url | string | 标题连接 |
XiongzhangID | string | 熊掌ID |
JSON返回示例:
{
"StateCode": 1,
"Reason": "成功",
"Result": {
"Ranks": [
{
"RankStr": "1-1",
"Title": "站长工具 - 站长之家",
"Url": "http://m.tool.chinaz.com/",
"XiongzhangID":"站长之家"
},
{
"RankStr": "2-10",
"Title": "站长素材-分享综合设计素材的平台",
"Url": "http://sc.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "3-1",
"Title": "站长字体下载-分享PS字体、免费字体、商业字体库",
"Url": "http://font.chinaz.com/",
"XiongzhangID":""
},
{
"RankStr": "3-4",
"Title": "IP/服务器地址查询 - 站长工具",
"Url": "http://ip.tool.chinaz.com/",
"XiongzhangID":""
}
]
}
}