EtshopAPI Platform
中文 / EN
接口参考

历史监控列表 API

GET/v1/monitor/history-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/history-list?page=1&per_page=10' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 2 项

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

参数 类型 说明
page
query · 可选
integer 页码,最小 1,默认 1
per_page
query · 可选
integer 每页条数,范围 1-100,默认 10

返回示例

返回示例 · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "current_page": 1,
        "data": [
            {
                "id": 1017,
                "shop_id": 31570284,
                "name": "LunaGoldJewelryCo",
                "image": "https://i.etsystatic.com/isla/f02c4d/63950172/isla_500x500.63950172_r8w1nq3d.jpg",
                "url": "https://www.etsy.com/shop/LunaGoldJewelryCo",
                "country_code": "TR",
                "have_sold_page": 1,
                "group_id": "3f9c2a7e5b1d4c8e9a6f0b2d7e4c1a95",
                "monitor_task_started_at": 1791849600,
                "monitor_task_stoped_at": 1792886400
            },
            {
                "id": 1009,
                "shop_id": 22918453,
                "name": "WillowAndWickCandles",
                "image": "https://i.etsystatic.com/isla/7ad391/50382614/isla_500x500.50382614_c5h0kt2y.jpg",
                "url": "https://www.etsy.com/shop/WillowAndWickCandles",
                "country_code": "CA",
                "have_sold_page": 0,
                "group_id": null,
                "monitor_task_started_at": 1789437600,
                "monitor_task_stoped_at": 1792029600
            }
        ],
        "first_page_url": "https://api.etshop.ai/open-api/v1/monitor/history-list?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "https://api.etshop.ai/open-api/v1/monitor/history-list?page=1",
        "next_page_url": null,
        "path": "https://api.etshop.ai/open-api/v1/monitor/history-list",
        "per_page": 10,
        "prev_page_url": null,
        "to": 2,
        "total": 2
    },
    "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 历史监控列表
»»» id integer true none 监控 ID,用于删除监控
»»» shop_id integer true none 店铺 ID
»»» name string true none 店铺名称
»»» image string true none 店铺图标
»»» url string true none 店铺链接
»»» country_code string true none 店铺所在国家/地区代码
»»» have_sold_page integer true none 店铺是否公开销售记录页:1 是,0 否
»»» group_id string¦null true none 所属分组 ID,重新监控时可传给添加监控沿用原分组;未分组或分组已删除时为 null
»»» monitor_task_started_at integer true none 最近一次监控的开始时间(Unix 时间戳,秒)
»»» monitor_task_stoped_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 总数量
来自现有接口目录与文档 · 支持接口名称和地址搜索