Etsy

Search Etsy listings

Searches Etsy listings across shops for the required keywords q, in Etsy's default relevance order. Page with offset (default 0) and limit (default 36, max 100). The response gives the total match count, and each result has listing id, title, URL, image, price, shop name and rating, quantity and sold-out flag. Read currency, since it is not fixed to USD.

get/etsy/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/etsy/search
  • Auth: API key in header x-api-key

Query parameters

qstring required

Search keywords

offsetinteger

0-based result offset

limitinteger

Page size (default 36, max 100)

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "count": 112886,
    "query": "handmade mug",
    "results": [
      {
        "listing_id": "1044347578",
        "price": "$29.99"
      }
    ]
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.