EtshopAPI Platform
中文 / EN
接口参考

关键词商品列表 API

GET/v1/keyword/keyword-product-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-product-list?tags=wall%20art&current_page=1&page_size=2&order_by=total_review&direction=desc' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 6 项

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

参数 类型 说明
tags
query · 必填
string 关键词,按商品标签精确匹配,不区分大小写。需要 URL 编码
name
query · 可选
string 在结果中进一步筛选:商品标签或标题包含这些词,多个用英文逗号分隔
current_page
query · 可选
integer 页码,最小 1,默认 1
page_size
query · 可选
integer 每页条数,范围 1-100,默认 20
order_by
query · 可选
string 排序字段:review_growth(近 7 天评论增长)、collection_growth(近 7 天收藏增长)、total_collection(总收藏)、total_review(总评论)、create_date(上架时间);默认 review_growth
direction
query · 可选
string 排序方向:desc 降序(默认)、asc 升序

返回示例

返回示例 · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "data": [
            {
                "id": 1188235614,
                "image": "https://i.etsystatic.com/27403561/r/il/5c7e1a/3952184720/il_794xN.3952184720_k2m8.jpg",
                "name": "Abstract Boho Wall Art Set of 3, Neutral Printable Wall Art, Mid Century Modern Prints",
                "create_date": 1645512331,
                "currency_code": "USD",
                "country_code": "US",
                "sale": 18342,
                "sale_growth": 214,
                "review": 3876,
                "review_growth": 41,
                "collect": 52310,
                "collect_growth": 612,
                "view": 0,
                "view_growth": 0,
                "real_sale": 18342,
                "real_sale_growth": 214,
                "bestseller": 1,
                "etsy_pick": 0,
                "product_type": ["Digital"],
                "is_video": 0,
                "price": 9.6,
                "url": "https://www.etsy.com/listing/1188235614/abstract-boho-wall-art-set-of-3-neutral",
                "store_name": "PrintPalaceStudio",
                "shop_id": 27403561
            },
            {
                "id": 963247815,
                "image": "https://i.etsystatic.com/19832746/r/il/a81f02/2954187236/il_794xN.2954187236_p9xd.jpg",
                "name": "Large Framed Canvas Wall Art, Mountain Landscape Painting, Living Room Decor",
                "create_date": 1612843902,
                "currency_code": "GBP",
                "country_code": "GB",
                "sale": 6420,
                "sale_growth": 58,
                "review": 1532,
                "review_growth": 12,
                "collect": 28764,
                "collect_growth": 203,
                "view": 0,
                "view_growth": 0,
                "real_sale": 6420,
                "real_sale_growth": 58,
                "bestseller": 0,
                "etsy_pick": 1,
                "product_type": ["Handmade"],
                "is_video": 1,
                "price": 64.5,
                "url": "https://www.etsy.com/listing/963247815/large-framed-canvas-wall-art-mountain",
                "store_name": "NordicCanvasCo",
                "shop_id": 19832746
            }
        ],
        "page": {
            "page_count": 206438,
            "current_page": 1,
            "total_count": 412876,
            "page_size": 2
        }
    },
    "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 响应数据
»» data [object] true none 商品列表
»»» id integer true none 商品 ID
»»» image string true none 商品主图
»»» name string true none 商品标题
»»» create_date integer true none 上架时间(Unix 时间戳,秒)
»»» currency_code string true none 价格币种
»»» country_code string true none 店铺所在国家/地区代码
»»» sale integer true none 总销量
»»» sale_growth integer true none 近 7 天销量增长
»»» review integer true none 总评论数
»»» review_growth integer true none 近 7 天评论增长
»»» collect integer true none 总收藏数
»»» collect_growth integer true none 近 7 天收藏增长
»»» view integer true none 总浏览量
»»» view_growth integer true none 近 7 天浏览增长
»»» real_sale integer true none 真实销量
»»» real_sale_growth integer true none 近 7 天真实销量增长
»»» bestseller integer true none 是否 Bestseller:1 是,0 否
»»» etsy_pick integer true none 是否 Etsy's Pick:1 是,0 否
»»» product_type [string] true none 商品类型:Digital、Handmade、Vintage、Customizable、Others
»»» is_video integer true none 是否有视频:1 是,0 否
»»» price number true none 价格(币种见 currency_code)
»»» url string true none 商品链接
»»» store_name string true none 店铺名称
»»» shop_id integer true none 店铺 ID
»» page object true none 分页信息
»»» page_count integer true none 总页数
»»» current_page integer true none 当前页码
»»» total_count integer true none 总条数
»»» page_size integer true none 每页条数
» 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 总数量
来自现有接口目录与文档 · 支持接口名称和地址搜索