电商数据 · 数据 API

Etsy API

手作商品、店铺与买家评价——小众品类选品与定价参考。调 POST /api/v1/social 就行,返回结构化 JSON,$1.39 / 千次/次、失败不计费。

免费开始看文档

个能力

$1.39 / 千次

每次调用

秒级

响应

1 个

API Key 通 87 平台

Etsy 能力清单

action	必填参数	可选参数	单次条数	模式	单价 / 次	返回字段
search	keyword	category, currency, exclude_keywords, min_price, sort	默认 20 · 最多 50	同步	$1.39 / 千次	listing_id · title · url · price · list_price · currency · rating · rating_scale · shop_id · shop_name · shop_rating · shop_review_count · on_sale · free_shipping · is_digital · image_url · platform
profile	url	—	—	同步	$1.39 / 千次	listing_id · title · url · description · materials · category · price · price_min · price_max · currency · review_count · shop_id · shop_name · shop_review_count · shop_years · ships_from_country · image_url · platform · tag · count
reviews	shop	—	默认 20 · 最多 100	同步	$1.39 / 千次	review_id · text · rating · rating_scale · author_name · author_username · posted_at · listing_title · seller_response · product_url · shop_name · shop_url · shop_rating · shop_review_count · platform
shop	shop	shop_name, url, username	—	同步	$1.39 / 千次	shop_id · shop_name · shop_url · is_star_seller · active_listing_count · on_etsy_since · location · platform
product_detail	url	—	—	同步	$1.39 / 千次	id · url · name · text · price · original_price · currency · in_stock_quantity · rating · rating_scale · review_count · shop_id · variants · tags · image_url · platform

Etsy 每个接口分别做什么

下面逐个解释 action、必填参数、可选筛选项和允许值。请求都发到 POST /api/v1/social，只需切换 action。

怎么调用 Etsy 关键词搜索 API？

search

使用 platform="etsy"、action="search" 调用“关键词搜索”能力；返回列表，默认 20 条、单次最多 50 条，主要包含 listing_id、title、url、price、list_price、currency 等 17 个字段。

keyword必填: 检索关键词。
category可选: 分类筛选。取值随平台而异，见该能力的 allowed_values。
currency可选: 价格币种，ISO 4217 代码（如 CNY、USD）。
exclude_keywords可选: 排除关键词，命中的内容不返回。
min_price可选: 最低价格，数值。
sort可选: 排序方式。取值随平台而异，见该能力的 allowed_values。

Etsy 特有返回字段与含义（9）

listing_id: 商品 ID。
list_price: 标价。
on_sale: 是否在促销。
free_shipping: 是否包邮。
is_digital: 是否为数字商品（下载类，无需物流）。
shop_id: 店铺 ID。
shop_name: 店铺名。
shop_rating: 店铺评分。
shop_review_count: 店铺评价数。

怎么调用 Etsy 主页或对象详情 API？

profile

使用 platform="etsy"、action="profile" 调用“主页或对象详情”能力；返回单个对象，主要包含 listing_id、title、url、description、materials、category 等 20 个字段。

url必填: 目标页面的完整链接，直接从该平台复制。

Etsy 特有返回字段与含义（11）

listing_id: 商品 ID。
shop_id: 店铺 ID。
shop_name: 店铺名。
shop_review_count: 店铺评价数。
price_min: 价格区间下限（多规格商品）。
price_max: 价格区间上限。
ships_from_country: 发货国家。
materials: 材质标签。Etsy 手作品类的重要筛选维度。
tag: 标签。
shop_years: 店铺经营年数。
count: 数量（含义随所在能力而定）。

怎么调用 Etsy 评价 API？

reviews

使用 platform="etsy"、action="reviews" 调用“评价”能力；返回列表，默认 20 条、单次最多 100 条，主要包含 review_id、text、rating、rating_scale、author_name、author_username 等 15 个字段。

shop必填: 店铺名称、店铺 ID 或店铺链接。

Etsy 特有返回字段与含义（8）

shop_name: 店铺名。
shop_rating: 店铺评分。
shop_review_count: 店铺评价数。
listing_title: 商品标题。
product_url: 商品链接。
shop_url: 店铺链接。
review_id: 评价 ID。
seller_response: 卖家对评价的回复。

怎么调用 Etsy 店铺资料 API？

shop

使用 platform="etsy"、action="shop" 调用“店铺资料”能力；返回单个对象，主要包含 shop_id、shop_name、shop_url、is_star_seller、active_listing_count、on_etsy_since 等 8 个字段。

shop必填: 店铺名称、店铺 ID 或店铺链接。
shop_name可选: 店铺名。
url可选: 目标页面的完整链接，直接从该平台复制。
username可选: 账号用户名（@handle），不带 @ 前缀。

Etsy 特有返回字段与含义（6）

shop_id: 店铺 ID。
shop_name: 店铺名。
shop_url: 店铺链接。
on_etsy_since: 店铺开设时间。新店 + 高销量是刷单的常见组合。
active_listing_count: 店铺在售商品数。
is_star_seller: 是否为 Etsy 星级卖家认证（发货与服务达标）。

怎么调用 Etsy 商品详情 API？

product_detail

使用 platform="etsy"、action="product_detail" 调用“商品详情”能力；返回单个对象，主要包含 id、url、name、text、price、original_price 等 16 个字段。

url必填: 目标页面的完整链接，直接从该平台复制。

Etsy 特有返回字段与含义（4）

shop_id: 店铺 ID。
original_price: 原价，与 price 对比可算折扣。
in_stock_quantity: 库存数量。
variants: 规格变体。

一次 Etsy search 调用的全过程:向 POST /api/v1/social 发送 platform="etsy"、action="search",以及必填参数 keyword;返回结构化 JSON,含 listing_id、title、url、price、list_price 等字段;单次最多 50 条,计费 $1.39 / 千次,失败与空结果不计费。

Etsy 原始字段名

EveryInfra 统一字段名

左边是 Etsy 数据里原本的字段名，右边是我们统一后的。点任意一行看对应关系。右边这一列在 87 个平台上是同一套—— 换平台时只改请求里的 platform 一个字段，解析代码一行不用动。

只有 Etsy 返回的字段

全站 87 个平台里，这 15 个字段只有 Etsy 会返回——换别的平台拿不到这些数据。字段名与其余平台同样遵循 snake_case 命名，解析方式一致。

listing_id
shop_review_count
on_sale
is_digital
materials
shop_years
ships_from_country
tag
listing_title
seller_response
shop_url
is_star_seller
active_listing_count
on_etsy_since
in_stock_quantity

返回字段含义

字段名跨 87 个平台统一，同一个键在哪个平台都是同一个意思—— 这也是换平台只需改 platform 一个字段的原因。机器可读版:/api/v1/social/fields

title: 标题。平台无标题概念时（如纯文本帖）为 null。
url: 该记录在原平台上的可访问链接。
price: 价格数值，不含货币符号；币种见 currency。
currency: 价格币种代码（如 CNY、USD）。price 存在但 currency 为 null 时不要假定币种。
rating: 评分。分制随平台而异，同一行的 rating_scale 给出该平台满分 (多数是 5，Booking/豆瓣/爱奇艺/NAVER 是 10)。跨平台比较前必须先按 rating_scale 换算 —— 直接比数字会得出反的结论。
rating_scale: 上一列 rating 的满分。5 表示五星制、10 表示十分制。只在该行有 rating 时出现。
image_url: 图片链接。多图能力可能返回 image_urls 数组。
platform: 数据来源平台标识，与请求里的 platform 一致（如 xiaohongshu、tiktok）。
description: 简介或描述，通常比 text 短。
category: 分类名称，取值为原平台的分类体系，未做跨平台归一。
review_count: 评价条数，用于商品/商家类能力。null 表示不公开，不等于 0。
text: 正文内容，已去除 HTML 标签。长文可能被截断。
author_name: 作者昵称（显示名）。
author_username: 作者用户名（@handle），通常可用于拼 URL。
posted_at: 发布时间，ISO 8601 格式、UTC 时区（如 2026-08-07T12:34:56+00:00）。平台只给非标准字符串时原样透传，解析前建议做容错。null 表示平台未公开。
location: 地理位置描述，原文透传，格式随平台而异。
id: 该记录在原平台上的唯一标识。仅在同一平台内唯一，跨平台可能重复。
name: 名称。用于账号/商品/商家类能力，指该对象本身的名字。
tags: 标签数组。无标签时为空数组，不是 null。

另有 Etsy 特有字段 listing_id · list_price · shop_id · shop_name · shop_rating · shop_review_count · on_sale · free_shipping · is_digital · materials · price_min · price_max · shop_years · ships_from_country · tag · count · review_id · listing_title · seller_response · product_url · shop_url · is_star_seller · active_listing_count · on_etsy_since · original_price · in_stock_quantity · variants，保留该平台自身的语义。

30 秒调用示例

etsy_search.sh

curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer omg_你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"etsy","action":"search","params":{"keyword":"咖啡"}}'

返回长这样

response.json

{
  "id": "etsy_…",
  "search": [
    {
      "listing_id": "…",
      "title": "…",
      "url": "https://…",
      "price": "…",
      "list_price": "…",
      "currency": "…",
      "rating": 128,
      "rating_scale": "…",
      "shop_id": "…",
      "shop_name": "…",
      "shop_rating": "…",
      "shop_review_count": 128,
      "on_sale": "…",
      "free_shipping": "…",
      "is_digital": true,
      "image_url": "https://…",
      "platform": "etsy"
    }
  ],
  "count": 20,
  "billing": { "charged": true, "credits": 100, "cny": 0.009356 }
}

常见用例

关键词监控

按关键词轮询 Etsy 的新内容，配合 Gemini 文本 API 做情绪分类与异常波动告警。

口碑与差评告警

拉 Etsy 的评论做评分走势与差评归因，新差评第一时间入库推送。

账号与主体画像

按 Etsy 的主页数据建达人/商家档案，做投放筛选或竞品盯防。

价格与库存监控

追踪 Etsy 的商品价格、库存与详情变化，波动即告警。

Etsy API 常见问题

Etsy API 怎么调用?

调 POST /api/v1/social,请求体传 platform="etsy"、action 和 params。以 search 为例,必填 keyword,可选 category、currency、exclude_keywords、min_price。Etsy 共 5 个 action,鉴权用 Authorization: Bearer <API Key>,同一把 Key 通 87 个平台。

Etsy API 怎么收费?

$1.39 / 千次/次,Etsy 全部 5 个能力同价。$1 免费额度约等于 719 次 Etsy 调用。一次调用一次计费,不按条数或页数加价;参数错误、鉴权失败和空结果都不计费。

Etsy API 一次能返回多少条数据?

最多的是 reviews,单次上限 100 条(默认 20 条)。另外 3 个能力返回单个对象,没有条数概念。传 limit 控制,一次调用就返回这么多,不需要翻页也不多收钱。

Etsy API 返回哪些字段?

search 返回 listing_id、title、url、price、list_price、currency 等 17 个字段。其中 15 个字段只有 Etsy 会返回(见上方「独有字段」)。字段名跨平台统一,换平台不用改解析代码。

Etsy怎么按关键词批量采集?

调 POST /api/v1/social,传 platform="etsy"、action="search",必填参数 keyword。单次最多 50 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,关键词搜索字段为 listing_id、title、url、price、list_price。

Etsy账号资料怎么批量抓取?

调 POST /api/v1/social,传 platform="etsy"、action="profile",必填参数 url。返回单个对象,没有条数上限;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,账号资料字段为 listing_id、title、url、description、materials。

Etsy评价怎么批量采集?

调 POST /api/v1/social,传 platform="etsy"、action="reviews",必填参数 shop。单次最多 100 条,一次调用一次计费、不按条数加价;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,评价数据字段为 review_id、text、rating、rating_scale、author_name。

Etsy商品详情怎么批量采集?

调 POST /api/v1/social,传 platform="etsy"、action="product_detail",必填参数 url。返回单个对象,没有条数上限;单价 $1.39 / 千次,失败与空结果不计费。返回结构化 JSON,商品详情字段为 id、url、name、text、price。

可以先免费试用 Etsy API 吗?

可以。注册免费,加微信领邀请码可得 $1 免费额度(≈720 次数据调用或 576 次 AI 调用),足够把 Etsy 的 5 个能力都试一遍。无需信用卡。

1688 API 速卖通 API Amazon API Craigslist API eBay API Shopee API 淘宝 API Temu API 全部 87 平台 ↗

开始调用 Etsy API

加微信领 $1 免费额度 —— ≈720 次数据调用或 576 次 AI 调用,足够把 Etsy 的能力全试一遍。

免费开始