> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrapebadger.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Etsy API — Overview

> Etsy public ecommerce search, product, seller and review data.

Etsy public ecommerce search, product, seller and review data.

Authenticate with `X-API-Key`. Requests use `https://scrapebadger.com/v1/etsy`.

## Endpoints

| Endpoint | Request | Credits |
| - | - | -: |
| [Search listings](https://docs.scrapebadger.com/api-reference/endpoint/etsy/search.md) | `GET /search` | 10 |
| [Get listing detail](https://docs.scrapebadger.com/api-reference/endpoint/etsy/listings-listing-id.md) | `GET /listings/{listing_id}` | 10 |
| [Get shop profile](https://docs.scrapebadger.com/api-reference/endpoint/etsy/shops-shop-name.md) | `GET /shops/{shop_name}` | 10 |
| [Get shop listings](https://docs.scrapebadger.com/api-reference/endpoint/etsy/shops-shop-name-listings.md) | `GET /shops/{shop_name}/listings` | 10 |
| [Get shop reviews](https://docs.scrapebadger.com/api-reference/endpoint/etsy/shops-shop-name-reviews.md) | `GET /shops/{shop_name}/reviews` | 20 |
| [Get categories](https://docs.scrapebadger.com/api-reference/endpoint/etsy/categories.md) | `GET /categories` | 10 |
| [Get listing reviews](https://docs.scrapebadger.com/api-reference/endpoint/etsy/listings-listing-id-reviews.md) | `GET /listings/{listing_id}/reviews` | 20 |
| [Get search suggestions](https://docs.scrapebadger.com/api-reference/endpoint/etsy/autocomplete.md) | `GET /autocomplete` | 20 |

Credits apply to successful requests. Failed requests and empty result sets are not charged.

## Markets

Supported market codes: `US`, `GB`.

Use the same market and location parameters across search, product and availability requests. Store availability and prices reflect the requested context at collection time.

## Pagination

Follow each endpoint’s pagination fields and retain product IDs to deduplicate results. Search counts and stock can change between calls.

## Get started

[Open the playground](https://scrapebadger.com/dashboard/etsy-scraper) or use the [Python and Node.js SDKs](https://docs.scrapebadger.com/sdks.md).

## Search filters

Keyword, price, sorting and pagination controls are available on Search. The Categories endpoints provide navigation data; category filtering is not offered on Search.

## Run this asynchronously

Calls on this API can run in the background, so you don't hold a connection open while they work. Add one of these to the call:

| Add | What you get |
| - | - |
| `async=true` | The normal response if the call finishes within 25 s. Otherwise `202` with a `request_id`, which you poll at `GET /v1/requests/{request_id}` for free. |
| `callback_url=https://…` | `202` at once. When the call completes, the result is POSTed to your URL, signed with your webhook secret. |
| `Idempotency-Key: <your id>` header | A resent submit returns the first call instead of running it again. |

```bash theme={null}
curl -s "https://scrapebadger.com/v1/...?your=params&async=true" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
# 202 {"request_id": "…", "status": "running", …}, then:
curl -s "https://scrapebadger.com/v1/requests/REQUEST_ID" \
  -H "X-API-Key: $SCRAPEBADGER_API_KEY"
```

An async call is billed once, when it completes. See [Async requests and webhooks](https://docs.scrapebadger.com/long-running-requests.md) for webhooks, signatures and the SDK helpers.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.