EtshopAPI Platform
中文 / EN
接口参考

监控商品真实销量 API

GET/v1/monitor/real-sale-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/monitor/real-sale-list?shop_name=PrintPalaceStudio&page=1&per_page=10&order_by=real_sale&direction=desc' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 5 项

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

参数 类型 说明
shop_name
query · 必填
string 店铺名称(精确匹配),即监控列表返回的 name
page
query · 可选
integer 页码,最小 1,默认 1
per_page
query · 可选
integer 每页条数,范围 1-100,默认 10
order_by
query · 可选
string 排序字段:real_sale(真实销量)、real_revenue(真实销售额)、product_created_at(商品上架时间);不传时按记录创建顺序
direction
query · 可选
string 排序方向:desc 降序(默认)、asc 升序

返回示例

返回示例 · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "current_page": 1,
        "data": [
            {
                "product_id": 1188235614,
                "shop_id": 27403561,
                "name": "Abstract Boho Wall Art Set of 3, Neutral Printable Wall Art, Mid Century Modern Prints",
                "image": "https://i.etsystatic.com/27403561/r/il/5c7e1a/3952184720/il_794xN.3952184720_k2m8.jpg",
                "url": "https://www.etsy.com/listing/1188235614/abstract-boho-wall-art-set-of-3-neutral",
                "bestseller": 1,
                "currency_code": "USD",
                "price": 9.6,
                "real_sale": 214,
                "real_revenue": 2054.4,
                "product_created_at": 1645512331
            },
            {
                "product_id": 1402776358,
                "shop_id": 27403561,
                "name": "Sage Green Botanical Prints, Set of 6 Printable Wall Art, Vintage Leaf Illustrations",
                "image": "https://i.etsystatic.com/27403561/r/il/9d03be/4615827390/il_794xN.4615827390_x7cq.jpg",
                "url": "https://www.etsy.com/listing/1402776358/sage-green-botanical-prints-set-of-6",
                "bestseller": 0,
                "currency_code": "USD",
                "price": 11.4,
                "real_sale": 87,
                "real_revenue": 991.8,
                "product_created_at": 1676893450
            }
        ],
        "first_page_url": "https://api.etshop.ai/open-api/v1/monitor/real-sale-list?page=1",
        "from": 1,
        "last_page": 27,
        "last_page_url": "https://api.etshop.ai/open-api/v1/monitor/real-sale-list?page=27",
        "next_page_url": "https://api.etshop.ai/open-api/v1/monitor/real-sale-list?page=2",
        "path": "https://api.etshop.ai/open-api/v1/monitor/real-sale-list",
        "per_page": 10,
        "prev_page_url": null,
        "to": 10,
        "total": 263
    },
    "credits": {
        "type": "monitor_credits",
        "remaining_credits": 98,
        "consumed_credits": 0,
        "total_credits": 100
    }
}
文档中的示例数据

返回数据结构

名称 类型 必选 约束 说明
» code integer true none 业务状态码
» message string true none 响应消息
» data object true none 响应数据
»» current_page integer true none 当前页码
»» data [object] true none 商品列表
»»» product_id integer true none 商品 ID
»»» shop_id integer true none 店铺 ID
»»» name string true none 商品标题
»»» image string true none 商品主图
»»» url string true none 商品链接
»»» bestseller integer true none 是否 Bestseller:1 是,0 否
»»» currency_code string true none 价格币种
»»» price number true none 商品价格
»»» real_sale integer true none 监控期间的真实销量
»»» real_revenue number true none 监控期间的真实销售额(price × real_sale)
»»» product_created_at integer true none 商品上架时间(Unix 时间戳,秒)
»» first_page_url string true none 第一页链接
»» from integer¦null true none 当前页第一条的序号
»» last_page integer true none 最后一页页码
»» last_page_url string true none 最后一页链接
»» next_page_url string¦null true none 下一页链接
»» path string true none 接口地址
»» per_page integer true none 每页条数
»» prev_page_url string¦null true none 上一页链接
»» to integer¦null true none 当前页最后一条的序号
»» total integer true none 总条数
» credits object true none 本次请求的 Credits 信息,见计费规则
»» type string true none Credits 类型,本接口为 monitor_credits
»» remaining_credits integer true none 本次请求后剩余的 Monitor Credits
»» consumed_credits integer true none 本次请求消耗的 Monitor Credits,本接口为 0
»» total_credits integer true none Monitor Credits 总数量
来自现有接口目录与文档 · 支持接口名称和地址搜索