• 接口说明

    目录

    [隐藏]

    1 功能说明

    获取词库网内部数据的接口
    本接口除网站词库外全部返回的是关键词,关键词热度及关键词收录,网站词库返回的是关键词,热度,排名,预估流量,收录量,标题及网址,全部以JSON格式返回。

    注意:

    1. 每次请求都是返回100条数据,不足100条的则返回最大量,返回的数据当中包含总条数。

    2. 接口状态为“测试”状态时,不会产生任何扣费操作,该状态下返回的数据都是测试数据。

    3. 免费次数调用完继续调用开关默认设置否,如果设置成是则VIP状态下免费次数用完后继续调用会按次扣费。

    4. 网站词库?#27599;?#36890;整站导出功能才可通过接口调用,该调用并不计算调用次数,即开通某域名的整站导出后可无限制调用该域名的网站词库数据。

    5. 请保管好apptoken防止泄露,如果被盗用而产生接口扣费操作,词库网将不返还这些扣费。

    6. 可通过VIP定制进行接口调用次数的定制,也可直接调用,直接调用是按每次0.1元进行收费的。

    2 接口调用说明

    2.1 获取长尾词

    (1)获取地址

    http://api.ciku5.com

    (2)HTTP请求方式

    GET

    (3)数据返回格式

    json

    (4)传递参数

    参数名称 是否必须 类型 描述
    action
    int

    指定请求的类型,获取长尾词该值为1

    appid
    long

    申请接口时获取的appid

    apptoken
    string

    申请接口时获取的apptoken 得用32位MD5?#29992;?/font>  MD5在线生成

    wd
    string

    要获取的关键词 得用urlEncode的UTF-8进行编码

    例如关键词“词库网”,编码后为“%e8%af%8d%e5%ba%93%e7%bd%91” 在线URL编码

    pageindex
    int

    页码数默认为1,接口每次返回100条数据,如果返回的结果当中条数总量大于100,则可根据分页再次进行获取

    例如该参数值为1,则是获取第1到100条的数据,值为2则是获取第100到200条的数据

    ver
    int

    [新增参数] 版本号默认为0,新版本参数为1,新版本对比旧版本新增PC指数,移动指数跟360指数

    (5)请求举例

    该请求获取有关“词库网”的相关长尾词

    http://api.ciku5.com?action=1&appid=你的appid&apptoken=?#29992;?#36807;的apptoken&wd=%e8%af%8d%e5%ba%93%e7%bd%91&pageindex=1&ver=版本号

    (6)成功返回结果

    关键词都是Unicode编码过的  在线Unicode解码

    V0版本结果

    {
        "state": 1,
        "error": "",
        "total": 1,
        "data": [{
            "keyword": "\u8bcd\u5e93\u7f51",
            "index": 83,
            "pagenum": 53100000
        }, ...]
    }

    V1版本结果

    {
        "state": 1,
        "error": "",
        "total": 1,
        "data": [{
            "keyword": "\u8bcd\u5e93\u7f51",
            "index": 83,
            "pcindex": 83,
            "mobileindex": 83,
            "so360index": 83,
            "pagenum": 53100000
        }, ...]
    }

    (7)失败返回结果

    state状态不是1就是返回失败 查看具体的错误代码

    {
        "state": 104,
        "error": "\u0069\u0070\u672a\u6388\u6743"
    }

    2.2 获取指定关键词

    (1)获取地址

    http://api.ciku5.com

    (2)HTTP请求方式

    GET

    (3)数据返回格式

    json

    (4)传递参数

    参数名称 是否必须 类型 描述
    action
    int

    指定请求的类型,获取指定关键词该值为9

    appid
    long

    申请接口时获取的appid

    apptoken
    string

    申请接口时获取的apptoken 得用32位MD5?#29992;?/font>  MD5在线生成

    wd
    string

    要获取的关键词,关键词一次最多传20个,多个关键词用英文逗号隔开 得用urlEncode的UTF-8进行编码

    例如关键词“词库,词库网,工具”,编码后为“%e8%af%8d%e5%ba%93%2c%e8%af%8d%e5%ba%93%e7%bd%91%2c%e5%b7%a5%e5%85%b7” 在线URL编码

    ver
    int

    [新增参数] 版本号默认为0,新版本参数为1,新版本对比旧版本新增PC指数,移动指数跟360指数

    (5)请求举例

    该请求获取“词库,词库网,工具”的热度及收录数据

    http://api.ciku5.com?action=9&appid=你的appid&apptoken=?#29992;?#36807;的apptoken&wd=%e8%af%8d%e5%ba%93%2c%e8%af%8d%e5%ba%93%e7%bd%91%2c%e5%b7%a5%e5%85%b7&ver=版本号

    (6)成功返回结果

    关键词都是Unicode编码过的  在线Unicode解码

    V0版本结果

    {
        "state": 1,
        "error": "",
        "total": 3,
        "data": [{
            "keyword": "\u8bcd\u5e93",
            "index": 192,
            "pagenum": 15300000
        }, {
            "keyword": "\u8bcd\u5e93\u7f51",
            "index": 83,
            "pagenum": 2900000
        }]
    }

    V1版本结果

    {
        "state": 1,
        "error": "",
        "total": 3,
        "data": [{
            "keyword": "\u8bcd\u5e93",
            "index": 192,
            "pcindex": 192,
            "mobileindex": 192,
            "so360index": 192,
            "pagenum": 15300000
        }, {
            "keyword": "\u8bcd\u5e93\u7f51",
            "index": 192,
            "pcindex": 192,
            "mobileindex": 192,
            "so360index": 192,
            "pagenum": 2900000
        }]
    }

    (7)失败返回结果

    state状态不是1就是返回失败 查看具体的错误代码

    {
        "state": 104,
        "error": "\u0069\u0070\u672a\u6388\u6743"
    }

    2.3 获取新词

    (1)获取地址

    http://api.ciku5.com

    (2)HTTP请求方式

    GET

    (3)数据返回格式

    json

    (4)传递参数

    参数名称 是否必须 类型 描述
    action
    int

    指定请求的类型,获取新词该值为3

    appid
    long

    申请接口时获取的appid

    apptoken
    string

    申请接口时获取的apptoken 得用32位MD5?#29992;?/font>  MD5在线生成

    pageindex
    int

    页码数默认为1,接口每次返回100条数据,如果返回的结果当中条数总量大于100,则可根据分页再次进行获取

    例如该参数值为1,则是获取第1到100条的数据,值为2则是获取第100到200条的数据

    ver
    int

    [新增参数] 版本号默认为0,新版本参数为1,新版本对比旧版本新增PC指数,移动指数跟360指数

    (5)请求举例

    该请求获取新词前100条

    http://api.ciku5.com?action=3&appid=你的appid&apptoken=?#29992;?#36807;的apptoken&pageindex=1&ver=版本号

    (6)成功返回结果

    关键词都是Unicode编码过的  在线Unicode解码

    V0版本结果

    {
        "state": 1,
        "error": "",
        "total": 100,
        "data": [{
            "keyword": "\u4eba\u6c11\u5e01\u5973\u90ce",
            "index": 119454,
            "pagenum": 53100000
        }, {
            "keyword": "\u5973\u5b50\u6000\u5b555\u6708\u88ab\u903c\u63a5\u5ba2",
            "index": 117151,
            "pagenum": 53100000
        }, ...]
    }

    V1版本结果

    {
        "state": 1,
        "error": "",
        "total": 100,
        "data": [{
            "keyword": "\u4eba\u6c11\u5e01\u5973\u90ce",
            "index": 119454,
            "pcindex": 119454,
            "mobileindex": 119454,
            "so360index": 119454,
            "pagenum": 53100000
        }, {
            "keyword": "\u5973\u5b50\u6000\u5b555\u6708\u88ab\u903c\u63a5\u5ba2",
            "index": 117151,
            "pcindex": 119454,
            "mobileindex": 119454,
            "so360index": 119454,
            "pagenum": 53100000
        }, ...]
    }

    (7)失败返回结果

    state状态不是1就是返回失败 查看具体的错误代码

    {
        "state": 104,
        "error": "\u0069\u0070\u672a\u6388\u6743"
    }

    2.4 获取热词

    (1)获取地址

    http://api.ciku5.com

    (2)HTTP请求方式

    GET

    (3)数据返回格式

    json

    (4)传递参数

    参数名称 是否必须 类型 描述
    action
    int

    指定请求的类型,获取热词该值为4

    appid
    long

    申请接口时获取的appid

    apptoken
    string

    申请接口时获取的apptoken 得用32位MD5?#29992;?/font>  MD5在线生成

    pageindex
    int

    页码数默认为1,接口每次返回100条数据,如果返回的结果当中条数总量大于100,则可根据分页再次进行获取

    例如该参数值为1,则是获取第1到100条的数据,值为2则是获取第100到200条的数据

    ver
    int

    [新增参数] 版本号默认为0,新版本参数为1,新版本对比旧版本新增PC指数,移动指数跟360指数

    (5)请求举例

    该请求获取热词前100条

    http://api.ciku5.com?action=4&appid=你的appid&apptoken=?#29992;?#36807;的apptoken&pageindex=1&ver=版本号

    (6)成功返回结果

    关键词都是Unicode编码过的  在线Unicode解码

    V0版本结果

    {
        "state": 1,
        "error": "",
        "total": 100,
        "data": [{
            "keyword": "\u4eba\u6c11\u5e01\u5973\u90ce",
            "index": 119454,
            "pagenum": 53100000
        }, {
            "keyword": "\u5973\u5b50\u6000\u5b555\u6708\u88ab\u903c\u63a5\u5ba2",
            "index": 117151,
            "pagenum": 53100000
        }, ...]
    }

    V1版本结果

    {
        "state": 1,
        "error": "",
        "total": 100,
        "data": [{
            "keyword": "\u4eba\u6c11\u5e01\u5973\u90ce",
            "index": 119454,
            "pcindex": 119454,
            "mobileindex": 119454,
            "so360index": 119454,
            "pagenum": 53100000
        }, {
            "keyword": "\u5973\u5b50\u6000\u5b555\u6708\u88ab\u903c\u63a5\u5ba2",
            "index": 117151,
            "pcindex": 119454,
            "mobileindex": 119454,
            "so360index": 119454,
            "pagenum": 53100000
        }, ...]
    }

    (7)失败返回结果

    state状态不是1就是返回失败 查看具体的错误代码

    {
        "state": 104,
        "error": "\u0069\u0070\u672a\u6388\u6743"
    }

    2.5 获取热词预测

    (1)获取地址

    http://api.ciku5.com

    (2)HTTP请求方式

    GET

    (3)数据返回格式

    json

    (4)传递参数

    参数名称 是否必须 类型 描述
    action
    int

    指定请求的类型,获取热词预测该值为5

    appid
    long

    申请接口时获取的appid

    apptoken
    string

    申请接口时获取的apptoken 得用32位MD5?#29992;?/font>  MD5在线生成

    pageindex
    int

    页码数默认为1,接口每次返回100条数据,如果返回的结果当中条数总量大于100,则可根据分页再次进行获取

    例如该参数值为1,则是获取第1到100条的数据,值为2则是获取第100到200条的数据

    ver
    int

    [新增参数] 版本号默认为0,新版本参数为1,新版本对比旧版本新增PC指数,移动指数跟360指数

    (5)请求举例

    该请求获取热词预测前100条

    http://api.ciku5.com?action=5&appid=你的appid&apptoken=?#29992;?#36807;的apptoken&pageindex=1&ver=版本号

    (6)成功返回结果

    关键词都是Unicode编码过的  在线Unicode解码

    V0版本结果

    {
        "state": 1,
        "error": "",
        "total": 100,
        "data": [{
            "keyword": "\u4eba\u6c11\u5e01\u5973\u90ce",
            "index": 119454,
            "pagenum": 53100000
        }, {
            "keyword": "\u5973\u5b50\u6000\u5b555\u6708\u88ab\u903c\u63a5\u5ba2",
            "index": 117151,
            "pagenum": 53100000
        }, ...]
    }

    V1版本结果

    {
        "state": 1,
        "error": "",
        "total": 100,
        "data": [{
            "keyword": "\u4eba\u6c11\u5e01\u5973\u90ce",
            "index": 119454,
            "pcindex": 119454,
            "mobileindex": 119454,
            "so360index": 119454,
            "pagenum": 53100000
        }, {
            "keyword": "\u5973\u5b50\u6000\u5b555\u6708\u88ab\u903c\u63a5\u5ba2",
            "index": 117151,
            "pcindex": 119454,
            "mobileindex": 119454,
            "so360index": 119454,
            "pagenum": 53100000
        }, ...]
    }

    (7)失败返回结果

    state状态不是1就是返回失败 查看具体的错误代码

    {
        "state": 104,
        "error": "\u0069\u0070\u672a\u6388\u6743"
    }

    2.6 获取网站词库

    注意:接口改版后,只有开通整站导出的网站才有导出权限,网站词库导出调用不扣调用次数,即开通某域名的整站导出后可无限制调用该域名的网站词库数据。

    (1)获取地址

    http://api.ciku5.com

    (2)HTTP请求方式

    GET

    (3)数据返回格式

    json

    (4)传递参数

    参数名称 是否必须 类型 描述
    action
    int

    指定请求的类型,获取行业词库该值为6

    appid
    long

    申请接口时获取的appid

    apptoken
    string

    申请接口时获取的apptoken 得用32位MD5?#29992;?/font>  MD5在线生成

    wd
    string

    域名参数

    ?#28909;?#33719;取“词库网”的网站词库,则该值为www.mayb.tw

    pageindex
    int

    页码数默认为1,接口每次返回100条数据,如果返回的结果当中条数总量大于100,则可根据分页再次进行获取

    例如该参数值为1,则是获取第1到100条的数据,值为2则是获取第100到200条的数据

    indexrange
    string

    指数?#27573;В?#40664;认为空,格式为100-200

    pagerange
    string

    收录?#27573;В?#40664;认为空,格式为1000-20000

    ver
    int

    [新增参数] 版本号默认为0,新版本参数为1,新版本对比旧版本新增PC指数,移动指数

    (5)请求举例

    该请求获取“词库网”网站词库前100条

    http://api.ciku5.com?action=2&appid=你的appid&apptoken=?#29992;?#36807;的apptoken&pageindex=1&wd=www.mayb.tw&&indexrange=100-200&pagerange=10000-20000ver=版本号

    (6)成功返回结果

    关键词,标题都是Unicode编码过的  在线Unicode解码

    V0版本结果

    {
        "state": 1,
        "error": "",
        "total": 16,
        "data": [{
            "keyword": "\u7f51\u7ad9\u8bcd\u5e93",
            "index": 4,
            "sort": 1,
            "aboutip": "2 ~ 4",
            "pagenum": 51800000,
            "title": "\u8bcd\u5e93\u7f51 - \u70ed\u95e8\u5173\u952e\u8bcd\u5e93\u3001\u957f\u5c3e\u5173\u952e\u8bcd\u5e93\u3001\u7f51\u7ad9\u5173\u952e\u8bcd\u5e93\u3001\u884c\u4e1a\u5173\u952e\u8bcd\u5e93",
            "url": "www.mayb.tw"
        }, {
            "keyword": "\u8bcd\u5e93",
            "index": 184,
            "sort": 2,
            "aboutip": "55 ~ 92",
            "pagenum": 28000000,
            "title": "\u8bcd\u5e93\u7f51 - \u70ed\u95e8\u5173\u952e\u8bcd\u5e93\u3001\u957f\u5c3e\u5173\u952e\u8bcd\u5e93\u3001\u7f51\u7ad9\u5173\u952e\u8bcd\u5e93\u3001\u884c\u4e1a\u5173\u952e\u8bcd\u5e93",
            "url": "www.mayb.tw"
        }, ...]
    }
    
    

    V1版本结果

    {
        "state": 1,
        "error": "",
        "total": 16,
        "data": [{
            "keyword": "\u7f51\u7ad9\u8bcd\u5e93",
            "index": 4,
            "pcindex": 4,
            "mobileindex": 4,
            "sort": 1,
            "aboutip": "2 ~ 4",
            "pagenum": 51800000,
            "title": "\u8bcd\u5e93\u7f51 - \u70ed\u95e8\u5173\u952e\u8bcd\u5e93\u3001\u957f\u5c3e\u5173\u952e\u8bcd\u5e93\u3001\u7f51\u7ad9\u5173\u952e\u8bcd\u5e93\u3001\u884c\u4e1a\u5173\u952e\u8bcd\u5e93",
            "url": "www.mayb.tw"
        }, {
            "keyword": "\u8bcd\u5e93",
            "index": 184,
            "pcindex": 4,
            "mobileindex": 4,
            "sort": 2,
            "aboutip": "55 ~ 92",
            "pagenum": 28000000,
            "title": "\u8bcd\u5e93\u7f51 - \u70ed\u95e8\u5173\u952e\u8bcd\u5e93\u3001\u957f\u5c3e\u5173\u952e\u8bcd\u5e93\u3001\u7f51\u7ad9\u5173\u952e\u8bcd\u5e93\u3001\u884c\u4e1a\u5173\u952e\u8bcd\u5e93",
            "url": "www.mayb.tw"
        }, ...]
    }

    (7)失败返回结果

    state状态不是1就是返回失败 查看具体的错误代码

    {
         "state": 104,
         "error": "\u0069\u0070\u672a\u6388\u6743"
    }

    3 返回字段说明

    字段 说明
    state

    返回的状态值,该值为1说明正确返回  查看具体的错误代码

    error

    如果返回正确该值为空,否则提示相应的错误信息

    data

    数据集合,JSON数组

    keyword

    关键词

    index

    百?#26085;?#20307;指数

    pcindex

    百度pc指数

    mobileindex

    百度移动热度

    so360index

    360指数

    sort

    关键词排名[网站词库]

    aboutip

    预估流量[网站词库]

    pagenum

    关键词收录量

    title

    网站标题[网站词库]

    url

    网站网址[网站词库]

    4 错误代码说明

    编号[state] 说明
    100

    action参数有误

    101

    appid参数有误

    102

    非法IP

    103

    appkey验证不通过

    104

    ip?#35789;?#26435;

    105

    接口不存在或者帐户被禁用

    106

    余额不足或者查询超过最大限制

    107

    wd参数有误关键词不能超过40字符

    108

    wd参数有误非法域名

    109

    bt参数有误该行业分类不存在

    110

    系统处理异常

    111

    尚未开通此域名的整站导出

    112

    wd参数有误关键词不符合要求

    5 示例下载

    (1)源码下载

    点击下载

    (2)接口工具下载

    点击下载

    注意:该工具需要.NET2.0框架支持,如果没有?#27599;?#26550;则点击此处下载安装

    工具截图