# Etsy API

围绕 Etsy 商品 listing 与店铺，查询材料、规格和展示价格，按关联商品整理店铺评价，为手作与数字商品选品提供资料。

- Domain: ecom · 5 data actions
- Canonical page: https://everyinfra.com/etsy-api
- Failures and empty results never form a final charge.

## Actions

### search — 关键词搜索
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: keyword

- Optional: currency, exclude_keywords, min_price, sort
- Allowed values: sort (newest/price_asc/price_desc/relevance), currency (aud/brl/cad/chf/dkk/eur/gbp/hkd/…)

- Returns fields: 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 — 主页或对象详情
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: 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, images, review_highlights, review_tags, variants

### reviews — 评价
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: shop

- Returns fields: 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 — 店铺资料
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: shop

- Optional: shop_name, username

- Returns fields: shop_id, shop_name, shop_url, is_star_seller, active_listing_count, on_etsy_since, location, platform

### product_detail — 商品详情
- Mode: sync · Price: 100 credits ($1.39 / 千次)
- Required: url

- Returns fields: id, url, name, text, price, original_price, currency, in_stock_quantity, rating, rating_scale, review_count, shop_id, variants, tags, image_url, platform

## Also

- Machine catalog (no key): https://everyinfra.com/openapi.json · GET /api/v1/social/catalog
- Agents guide: https://everyinfra.com/agents.md