EtshopAPI Platform
中文 / EN
接口参考

关键词分析 API

GET/v1/keyword/analytics
免费·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/analytics?keyword=wall%20art' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 1 项

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

参数 类型 说明
keyword
query · 必填
string 关键词,不区分大小写。需要 URL 编码

返回示例

返回示例 · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "list": {
            "tag": "wall art",
            "competition": 412876,
            "avg_real_sales": "0.62",
            "avg_price_total": "28.47",
            "avg_favorites": "22.44",
            "avg_listing_reviews": "4.54",
            "most_popular_tags": [
                {
                    "tag": "wall art",
                    "competition": 412876
                },
                {
                    "tag": "wall decor",
                    "competition": 356120
                },
                {
                    "tag": "printable wall art",
                    "competition": 118934
                }
            ],
            "most_popular_categories": [
                {
                    "category_arr": ["Art & Collectibles", "Prints", "Digital Prints"],
                    "percentage": "0.46"
                },
                {
                    "category_arr": ["Art & Collectibles", "Painting", "Acrylic"],
                    "percentage": "0.18"
                },
                {
                    "category_arr": ["Home & Living", "Home Decor", "Wall Decor", "Wall Hangings"],
                    "percentage": "0.12"
                }
            ],
            "price_range": [
                {
                    "price": "3.99",
                    "num": 12
                },
                {
                    "price": "5.20",
                    "num": 9
                },
                {
                    "price": "24.00",
                    "num": 4
                }
            ],
            "processing_times": [
                {
                    "day": "1 days - 1 days",
                    "num": "0.41"
                },
                {
                    "day": "1 days - 3 days",
                    "num": "0.27"
                },
                {
                    "day": "3 days - 5 days",
                    "num": "0.19"
                }
            ]
        }
    },
    "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 关键词
»»» competition integer true none 竞争度:使用该关键词(标签)的商品数量
»»» avg_real_sales string true none 平均真实销量(真实销量总数 ÷ 商品数量,保留 2 位小数)
»»» avg_price_total string true none 平均价格(美元,保留 2 位小数)
»»» avg_favorites string true none 平均收藏数(保留 2 位小数)
»»» avg_listing_reviews string true none 平均评论数(保留 2 位小数)
»»» most_popular_tags [object] true none 最受欢迎的相关标签,最多 80 个,按竞争度从高到低
»»»» tag string true none 标签
»»»» competition integer true none 使用该标签的商品数量
»»» most_popular_categories [object] true none 最受欢迎的分类,最多 5 个
»»»» category_arr [string] true none 分类路径,从一级分类到末级分类
»»»» percentage string true none 占比,0.42 表示 42%
»»» price_range [object] true none 价格分布:取真实销量最高的 100 个商品的美元价格,按价格从低到高
»»»» price string true none 价格(美元)
»»»» num integer true none 该价格的商品数量
»»» processing_times [object] true none 备货时间分布
»»»» day string true none 备货时间区间,例如 1 days - 3 days
»»»» num string true none 占比,0.35 表示 35%
» 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 总数量
来自现有接口目录与文档 · 支持接口名称和地址搜索