EtshopAPI Platform
中文 / EN
接口参考

相关关键词 API

GET/v1/keyword/keyword-list
免费·api.etshop.ai/open-api
Credits 消耗规则

计费规则:店铺/商品列表与热销榜每返回 1 条扣 1 Credit,店铺详情每次扣 2 Credits;详情、趋势、每日数据、评论免费(需 3 天内在列表或详情中返回过)。关键词搜索每个词扣 1 Keyword Credit,30 天内同一个词免费。店铺监控每个店铺扣 1 Monitor Credit,监控 30 天,停止后不退还。空结果不扣费,服务器错误自动退还。

请求头

AUTHORIZATIONAuthorization: {API Key}
CONTENT-TYPEapplication/json
ACCEPTapplication/json

请求示例

cURL
curl --location --request GET 'https://api.etshop.ai/open-api/v1/keyword/keyword-list?keyword=wall%20art&type=3&country=US' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 5 项

按参数标注的位置传入请求。

参数 类型 说明
type
query · 必填
integer 查询类型:1 商品相关关键词(使用该关键词的热门商品所用的其它标签);2 相似关键词(名称相近的关键词);3 全部关键词(1 和 2 的合集);4 店铺关键词(店铺商品使用的标签);5 商品关键词(商品使用的标签)
keyword
query · 可选
string 关键词,不区分大小写。type 为 1、2、3 时必填
shop_id
query · 可选
integer 店铺 ID。type 为 4 时必填
product_id
query · 可选
integer 商品 ID。type 为 5 时必填
country
query · 可选
string Google 关键词数据的国家/地区代码,例如 US。只对 type 为 1、2、3 生效,不区分大小写,不传或传 ALL 表示全球数据;该国家/地区没有数据时 Google 相关字段为 null

返回示例

返回示例 · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "list": [
            {
                "tag": "wall art",
                "listing_reviews": 1873420,
                "favorites": 9264315,
                "competition": 412876,
                "shop_competition": 98342,
                "real_sales": 256731,
                "google_monthly_search": 165000,
                "google_pd": 87,
                "google_cpc": 0.42
            },
            {
                "tag": "wall decor",
                "listing_reviews": 1520384,
                "favorites": 7811920,
                "competition": 356120,
                "shop_competition": 87215,
                "real_sales": 198452,
                "google_monthly_search": 74000,
                "google_pd": 100,
                "google_cpc": 0.55
            },
            {
                "tag": "boho wall art",
                "listing_reviews": 286103,
                "favorites": 1502388,
                "competition": 64510,
                "shop_competition": 21873,
                "real_sales": 41296,
                "google_monthly_search": null,
                "google_pd": null,
                "google_cpc": null
            }
        ]
    },
    "credits": {
        "type": "keyword_credits",
        "remaining_credits": 49871,
        "consumed_credits": 0,
        "total_credits": 50000
    }
}
文档中的示例数据

返回数据结构

名称 类型 必选 约束 说明
» code integer true none 业务状态码
» message string true none 响应消息
» data object true none 响应数据
»» list [object] true none 关键词列表,按竞争度从高到低;没有数据时为空数组
»»» tag string true none 关键词
»»» listing_reviews integer true none 使用该关键词的商品的评论总数
»»» favorites integer true none 使用该关键词的商品的收藏总数
»»» competition integer true none 竞争度:使用该关键词(标签)的商品数量
»»» shop_competition integer true none 店铺竞争度:使用该关键词的店铺数量
»»» real_sales integer true none 使用该关键词的商品的真实销量总数
»»» google_monthly_search number¦null true none Google 月搜索量
»»» google_pd number¦null true none Google 广告竞争度(Paid Difficulty)
»»» google_cpc number¦null true none Google 广告单次点击费用(CPC,美元)
» credits object true none 本次请求的 Credits 信息,见计费规则
»» type string true none Credits 类型,本接口为 keyword_credits
»» remaining_credits integer true none 本次请求后剩余的 Keyword Credits
»» consumed_credits integer true none 本次请求消耗的 Keyword Credits,本接口为 0
»» total_credits integer true none Keyword Credits 总数量
来自现有接口目录与文档 · 支持接口名称和地址搜索