Etsy

Search Etsy listings

Read one Etsy search results page for a query: the ordered organic listing IDs (up to 48), a listing card for every organic result with shop, prices, discount, rating and badges, every promoted listing card and the total page count. organic_results_partially_embedded marks a page whose remaining organic IDs came back without card data. Each successful request costs 1 account credit, including partial results. Failed requests cost 0 credits.

get/v1/etsy/search

Request

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

Query parameters

querystring required

Search text (1-200 characters).

pageinteger

Results page starting at 1.

sort'most_relevant' | 'price_low' | 'price_high' | 'highest_reviews' | 'most_recent'

most_relevant (default), price_low, price_high, highest_reviews or most_recent.

min_pricenumber
max_pricenumber
currency'AUD' | 'BRL' | 'CAD' | 'CHF' | 'CNY' | 'CZK' | 'DKK' | 'EUR' | 'GBP' | 'HKD' | 'HUF' | 'IDR' | 'ILS' | 'INR' | 'JPY' | 'MAD' | 'MXN' | 'MYR' | 'NOK' | 'NZD' | 'PHP' | 'PLN' | 'SEK' | 'SGD' | 'THB' | 'TRY' | 'TWD' | 'USD' | 'VND' | 'ZAR'

Display currency pinned through Etsy's own locale override (default USD). One of the 30 currencies Etsy offers; language and region stay en-US / US.

Response

Inspect the response status and failure or coverage fields.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.