EtshopAPI Platform
中文 / EN
接口参考

已关闭店铺列表 API

GET/v1/shop/close-shop-list
每返回一条记录消耗 1 Credit;余额不足时按剩余 Credits 能覆盖的条数返回(部分扣费),余额为 0 时返回 403001;查询结果为空不扣费·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/shop/close-shop-list?close_time_start=2026-08-01&close_time_end=2026-10-31&order_by=sold_count_30&direction=desc&current_page=1&page_size=1' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: {API Key}'

请求参数 28 项

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

参数 类型 说明
name
query · 可选
string 店铺名称或标语关键词,模糊匹配;多个用英文逗号分隔,需同时匹配
sold_count_start
query · 可选
integer 总销量最小值
sold_count_end
query · 可选
integer 总销量最大值
sold_count_30_start
query · 可选
integer 关店前 30 天销量最小值
sold_count_30_end
query · 可选
integer 关店前 30 天销量最大值
total_rating_count_start
query · 可选
integer 总评论数最小值
total_rating_count_end
query · 可选
integer 总评论数最大值
favorites_count_start
query · 可选
integer 总收藏数最小值
favorites_count_end
query · 可选
integer 总收藏数最大值
avg_price_start
query · 可选
number 商品平均价格最小值(美元)
avg_price_end
query · 可选
number 商品平均价格最大值(美元)
total_product_num_start
query · 可选
integer 店铺商品数最小值
total_product_num_end
query · 可选
integer 店铺商品数最大值
mysql_product_num_start
query · 可选
integer 已收录商品数最小值
mysql_product_num_end
query · 可选
integer 已收录商品数最大值
average_rating_start
query · 可选
number 店铺评分最小值(0–5)
average_rating_end
query · 可选
number 店铺评分最大值(0–5)
country_code
query · 可选
string 店铺所在国家/地区代码,多个用英文逗号分隔
product_type
query · 可选
string 商品类型,多个用英文逗号分隔:Handmade、Digital、Vintage、Customizable、Others
create_date_start
query · 可选
string 开店日期起始,格式 Y-m-d,例如 2023-01-01
create_date_end
query · 可选
string 开店日期截止,格式 Y-m-d,例如 2023-12-31
close_time_start
query · 可选
string 关店日期起始,格式 Y-m-d,例如 2026-08-01
close_time_end
query · 可选
string 关店日期截止,格式 Y-m-d,例如 2026-10-31
is_real_sale
query · 可选
integer 是否有真实销量数据:1 是,0 否
current_page
query · 可选
integer 页码,最小 1,默认 1
page_size
query · 可选
integer 每页条数,范围 1-100,默认 20
order_by
query · 可选
string 排序字段:sold_count_30(关店前 30 天销量)、close_time(关店时间)、total_sale(总销量)、total_collection(总收藏)、total_review(总评论)、create_date(开店时间)、total_product_num(店铺商品数)、mysql_product_num(已收录商品数);默认 sold_count_30
direction
query · 可选
string 排序方向:desc 降序(默认)、asc 升序

返回示例

返回示例 · JSON
{
    "code": 200,
    "message": "success",
    "data": {
        "data": [
            {
                "id": 27304519,
                "image": "https://i.etsystatic.com/isla/5e9a07/64019283/isla_fullxfull.64019283_p3t8w1zr.jpg",
                "name": "CozyKnitCorner",
                "url": "https://www.etsy.com/shop/CozyKnitCorner",
                "star_seller": 1,
                "headline": "Chunky knit blankets, scarves and baby wraps",
                "total_product_num": 186,
                "mysql_product_num": 179,
                "create_date": 1585267200,
                "close_time": 1789920000,
                "sold_count_30": 864,
                "open_day": 2369,
                "currency_code": "GBP",
                "sold_count": 23517,
                "total_rating_count": 4820,
                "favorites_count": 12931,
                "views": 1084526,
                "avg_price": 42.9,
                "country_code": "GB",
                "best_selling_product": [
                    {
                        "id": 1023894571,
                        "images": ["https://i.etsystatic.com/27304519/r/il/3b6f20/3876543210/il_fullxfull.3876543210_gh78.jpg"]
                    }
                ]
            }
        ],
        "page": {
            "page_count": 3127,
            "current_page": 1,
            "total_count": 3127,
            "page_size": 1
        }
    },
    "credits": {
        "type": "default",
        "remaining_credits": 196535,
        "consumed_credits": 1,
        "total_credits": 196536
    }
}
文档中的示例数据

返回数据结构

名称 类型 必选 约束 说明
» 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 店铺名称
»»» url string true none 店铺链接
»»» star_seller integer true none 是否 Star Seller:1 是,0 否
»»» headline string true none 店铺标语
»»» total_product_num integer true none 店铺商品数
»»» mysql_product_num integer true none 已收录商品数
»»» create_date integer true none 开店时间(Unix 时间戳,秒)
»»» close_time integer true none 关店时间(Unix 时间戳,秒)
»»» sold_count_30 integer true none 关店前 30 天销量
»»» open_day integer true none 营业天数(开店到关店)
»»» currency_code string true none 店铺币种
»»» sold_count integer true none 总销量
»»» total_rating_count integer true none 总评论数
»»» favorites_count integer true none 总收藏数
»»» views integer true none 总浏览量
»»» avg_price number true none 商品平均价格(美元)
»»» country_code string true none 店铺所在国家/地区代码
»»» best_selling_product [object] true none 最畅销的商品(最多 3 个)
»»»» id integer true none 商品 ID
»»»» images [string] true none 商品主图
»» 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 类型,本接口为 default
»» remaining_credits integer true none 本次请求后剩余的 Credits
»» consumed_credits integer true none 本次请求消耗的 Credits,等于实际返回的记录数
»» total_credits integer true none 本次请求前的 Credits 余额(remaining_credits + consumed_credits)
来自现有接口目录与文档 · 支持接口名称和地址搜索