docs / etsy

Etsy

Handmade and vintage product listings and shops.

base /etsy/v16 endpoints

post/etsy/v1/listings/search1 credit

search listings → cards + ids + price/favorites

Parameter	Required
query	optional
max_pages	optional

Try in playground →

post/etsy/v1/listings/detail1 credit

full listing (title/price/discount/variations/gallery/description/category/favorites/stock = demand signal)

Parameter	Required
listing_url	optional
listing_id	optional
url	optional

Try in playground →

post/etsy/v1/shops/detail1 credit

shop profile (name/sales/location/rating/featured)

Parameter	Required
shop_url	optional
shop_slug	optional
url	optional

Try in playground →

post/etsy/v1/reviews/shop1 credit

shop reviews (bare, cookie-less)

Parameter	Required
shop_id	required
limit	optional
exclude_listing_id	optional

Try in playground →

post/etsy/v1/reviews/listing1 credit

reviews for one listing

Parameter	Required
listing_url	optional
listing_id	optional
url	optional

Try in playground →

post/etsy/v1/search/suggest1 credit

search autocomplete suggestions (bare public API, cookie-less — no )

Parameter	Required
query	required
limit	optional

Try in playground →

Example request · listings/search

curl -X POST https://api.reefapi.com/etsy/v1/listings/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}