---
title: "Scrape Etsy product search"
method: POST
path: "/marketplace/etsy-search"
tags: ["Plugins"]
---

# Scrape Etsy product search

`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`

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.

## Query parameters

- `query` string, required: What to search, e.g. 'handmade jewelry'.
- `sort` string: Ordering: relevancy, price_asc, price_desc, newest, top_reviews.
- `min_price` integer, nullable: Lowest price to include.
- `max_price` integer, nullable: Highest price to include.
- `page` integer: 1-based page to start from.
- `max_results` integer: How many products to collect across pages.
- `proxy_country` string, nullable: Proxy country the request is sent from (ISO-2, e.g. 'US', 'DE'). Defaults to US (USD prices).
- `include_sponsored` boolean: Also return Etsy's paid ad placements (`sponsored: true`). Off by default: ads ignore the search order and `sort`.

## Response `200`

JSON with a `products` array.

- unknown

## Other responses

- `400`: Invalid parameters.
- `422`: Validation Error
- `502`: Blocked by Etsy, no results page returned, or the call did not finish in time.

---

[API](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api.md) · [All operations](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/scrapeunblocker/apis/scrapeunblocker-api/revisions/c02f1254cc47?raw)