小红书长尾词挖掘API

详细说明：

接口地址：https://apis.5118.com/keyword/xhs
返回格式：json
请求方式：POST
在线调试

请求示例：https://apis.5118.com/keyword/xhs

提交任务调试工具： Postman示例

提交任务请求参数说明：

名称	类型	必填	默认值	说明
keyword	string	是		查询关键词
page_index	int	否	1	当前分页
page_size	int	否	100	每页返回数据的数量(最大返回数量100条)
sort_fields	int	否		排序字段(输入1-4下标,1:5118移动流量指数,2:5118PC流量指数,3:笔记数,4:全网长尾词)
sort_type	string	否	desc	升序或降序(asc:升序,desc:降序)
filter	int	否	1:所有词	快捷过滤(输入1-4下标,1:所有词,2:所有流量词,3:5118移动流量指数,4:5118PC流量指数)
filter_date	string	否		筛选日期(时间格式:yyyy-MM-dd)

提交任务返回参数说明：

名称	类型	默认值	说明
errcode	string	0	返回的错误代码
errmsg	string		返回的错误说明
total	int		总数量
page_count	int		总页数
page_index	int	1	当前分页
page_size	int	100	每页返回记录的数量
keyword	string		关键词
network_mobile_index	int		5118移动流量指数
network_pc_index	int		5118PC流量指数
xhs_note_count	int		笔记数
long_keyword_count	int		全网长尾词

JSON返回示例：

{
    "errcode": "0",
    "errmsg": "",
    "data": {
        "total": 173,
        "page_count": 18,
        "page_index": 1,
        "page_size": 10,
        "word": [
            {
                "keyword": "苹果手机升级系统为什么卡",
                "network_mobile_index": 0,
                "network_pc_index": 0,
                "xhs_note_count": 0,
                "long_keyword_count": 0
            },
			...
		]
	}
}

提交充值订单

状态回调配置说明

服务级错误码参照(error_code)：

错误码	说明
100101	调用次数不够,请充值
100102	服务每秒调用量超限
100103	服务每小时调用量超限
100104	服务每天调用量超限
100111	调用字数不够,请充值
100201	url无法解析
100202	请求缺少apikey
100203	无效的apikey
100204	api不存在
100205	api已经关闭
100206	后端服务响应status非200
100207	后端服务未正确接入
100208	请求方式不支持
100301	Api商城内部错误
100302	请求后端服务过程中错误
100303	系统繁忙稍候再试
100403	您输入的apikey不正确

系统级错误码参照：

错误码	说明
200201	传进参数为空
200202	用户ID为空
200203	请输入要查询的关键词
200406	输入时间格式有误，请按“yyyy-MM-dd”格式输入
200407	请输入长度大于1的关键词
200607	有重叠字符
200608	您搜索的关键词不支持查询
200999	查询条数超出最大上限

错误码格式说明：

2	002	01
服务器错误(1:为系统级别错误)	服务模块代码(即数据ID)	具体错误代码

资费说明：

名称	价格	次数
首次试用套餐	0.00	100
套餐一	400.00	10000
套餐二	2400.00	100000
套餐三	12000.00	1000000
套餐四	30000.00	5000000

示例代码：

PHP
C#

<?php
    $host = "https://apis.5118.com";
    $path = "/keyword/xhs";
    $method = "POST";
    $apikey = "你要调用API的apikey，到 https://account.5118.com/signin/myapi 获取";
    $headers = array();
    array_push($headers, "Authorization:" . $apikey);
    //根据API的要求，定义相对应的Content-Type
    array_push($headers, "Content-Type".":"."application/x-www-form-urlencoded; charset=UTF-8");
    $querys = "";
    $bodys = "keyword=keyword&page_index=1&page_size=10&sort_fields=1&sort_type=desc&filter=1&filter_date=2020-07-16";
    $url = $host . $path;
    $curl = curl_init();
    curl_setopt($curl, CURLOPT_CUSTOMREQUEST, $method);
    curl_setopt($curl, CURLOPT_URL, $url);
    curl_setopt($curl, CURLOPT_HTTPHEADER, $headers);
    curl_setopt($curl, CURLOPT_FAILONERROR, false);
    if (1 == strpos("$".$host, "https://"))
    {
        curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, false);
        curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, false);
    }
    curl_setopt($curl, CURLOPT_POSTFIELDS, $bodys);
    curl_exec($curl);
?>

请选择您要购买的套餐

系统通知