EtshopAPI Platform
中文 / EN
接口参考

监控详情 API

GET/v1/monitor/detail
免费·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/detail?shop_name=PrintPalaceStudio' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 1 项

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

参数 类型 说明
shop_name
query · 必填
string 店铺名称(精确匹配),即监控列表返回的 name

返回示例

返回示例 · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "shop": {
            "id": 1024,
            "monitor_task_started_at": 1793521800,
            "monitor_task_reported_at": 1794380400,
            "shop_id": 27403561,
            "name": "PrintPalaceStudio",
            "image": "https://i.etsystatic.com/isla/8c1f2a/58213947/isla_500x500.58213947_d3k9xw1p.jpg",
            "url": "https://www.etsy.com/shop/PrintPalaceStudio",
            "headline": "Printable wall art & modern digital prints",
            "country_code": "US",
            "currency_code": "USD",
            "create_date": 1514764800,
            "open_day": 3237,
            "additional_customization": 1,
            "is_open": 1,
            "have_sold_page": 1,
            "sold_count": 48263,
            "avg_price": 9.85,
            "revenue": 475390.55,
            "active_listing_count": 1268,
            "total_rating_count": 9734,
            "total_share_count": 21456
        }
    },
    "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 响应数据
»» shop object true none 店铺及监控信息
»»» id integer true none 监控 ID
»»» monitor_task_started_at integer true none 本次监控的开始时间(Unix 时间戳,秒)
»»» monitor_task_reported_at integer¦null true none 最近一次更新监控数据的时间(Unix 时间戳,秒)
»»» shop_id integer true none 店铺 ID
»»» name string true none 店铺名称
»»» image string true none 店铺图标
»»» url string true none 店铺链接
»»» headline string true none 店铺简介
»»» country_code string true none 店铺所在国家/地区代码
»»» currency_code string true none 店铺币种
»»» create_date integer true none 开店时间(Unix 时间戳,秒)
»»» open_day integer true none 开店天数
»»» additional_customization integer true none 是否支持个性化定制:1 是,0 否
»»» is_open integer true none 店铺是否营业:1 营业中,0 已关闭
»»» have_sold_page integer true none 店铺是否公开销售记录页:1 是,0 否
»»» sold_count integer true none 店铺总销量
»»» avg_price number true none 商品平均价格(美元)
»»» revenue number true none 估算总销售额(avg_price × sold_count,美元)
»»» active_listing_count integer true none 在售商品数
»»» total_rating_count integer true none 店铺总评论数
»»» total_share_count 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 总数量
来自现有接口目录与文档 · 支持接口名称和地址搜索