Etsy API: Search listings

Returns Etsy listings matching required q. Use count to control how many are returned per call.

3 credits / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

q*string

Keyword to search Etsy listings for.

Length1 <= length

count?integer

Maximum listings to return. Fewer can be returned; use has_more to determine whether more results are available.

Range1 <= value <= 240

Default48

curl -X GET "https://example.com/v1/etsy/search?q=leather+journal" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "string",    "count": 0,    "has_more": true,    "listings": [      {        "listing_id": "4488906265",        "title": "Personalized A5 Trifold Leather Journal",        "url": "https://www.etsy.com/listing/4488906265/personalized-a5-trifold-leather-journal",        "image_url": "https://i.etsystatic.com/62498741/r/il/a1d507/7914288856/il_255x319.7914288856_geua.jpg",        "shop_name": "HIDEAcraftedleather",        "shop_url": "https://www.etsy.com/shop/HIDEAcraftedleather",        "price": 66.95,        "original_price": 103,        "currency": "USD",        "on_sale": true,        "percent_discount": 35,        "rating": 4.9,        "review_count": 399      }    ]  }}