# Etsy

4 endpoints on Etsy. Every one returns the same response shape and has a flat, published price in credits.

Category: [E-commerce & marketplaces](https://onekey.dev/docs/categories/commerce.md) · [Overview page](https://onekey.dev/platforms/etsy)

> [!NOTE] **2 of 4 endpoints are marked "needs a pack" or "may need a pack"** in the table: free credits reach only the open fetch path; a verified email and a purchased pack unlock the rest. See [pricing](https://onekey.dev/pricing).

## Endpoints

| Endpoint | What it does | Cost | Status |
| --- | --- | --- | --- |
| [`listing`](https://onekey.dev/docs/api/etsy/listing.md) | One Etsy listing by id. | 1 credit | beta |
| [`listings`](https://onekey.dev/docs/api/etsy/listings.md) | Search active Etsy listings (Open API v3). | 5 credits | beta |
| [`product_similar`](https://onekey.dev/docs/api/etsy/product_similar.md) | Listings similar to an Etsy product. | 2 credits | beta **needs a pack** |
| [`search_suggestions`](https://onekey.dev/docs/api/etsy/search_suggestions.md) | Etsy search suggestions. | 2 credits | beta **needs a pack** |

Every endpoint page has a **Field mapping** section showing which source field becomes which [unified field](https://onekey.dev/docs/schema.md) (fixed schema) or platform-specific `ext.` field.
