Plugins

Scrape Etsy product search

Searches Etsy for query and returns the products as JSON: title, price + currency (ISO code) + currencySymbol, shop, image, a listing url and sponsored. Paid ad placements, which Etsy mixes in regardless of sort, are left out unless include_sponsored=true. Sort with sort, filter with min_price/max_price, and collect up to max_results across pages. Prices are in USD by default.

post/marketplace/etsy-search

Request

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

Query parameters

querystring required

What to search, e.g. 'handmade jewelry'.

sortstring

Ordering: relevancy, price_asc, price_desc, newest, top_reviews.

min_priceinteger nullable

Lowest price to include.

max_priceinteger nullable

Highest price to include.

pageinteger

1-based page to start from.

max_resultsinteger

How many products to collect across pages.

proxy_countrystring nullable

Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Defaults to US (USD prices).

include_sponsoredboolean

Also return Etsy's paid ad placements (sponsored: true). Off by default: ads ignore the search order and sort.

Response

JSON with a products array.

unknown required

Changes

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