# Etsy API guide



## Choose a Etsy operation



Start with the object your task needs. The groups below use the current catalogue; open an endpoint to check accepted identifiers, filters, price and availability before retrieving.



### Products and categories



- [Etsy categories](https://www.monocrawl.com/docs/endpoints/etsy/categories) — The Etsy category tree, or one branch of it.

- [Etsy category listings](https://www.monocrawl.com/docs/endpoints/etsy/category-products) — Listings in an Etsy category, 64 per page.

- [Etsy listing](https://www.monocrawl.com/docs/endpoints/etsy/product) — One Etsy listing: title, description, price, availability, images, tags, materials, category, shop, favourites, views and recent reviews.

- [Etsy shop](https://www.monocrawl.com/docs/endpoints/etsy/shop) — One Etsy shop: sales, rating, seller, location, listing counts and sections.

- [Etsy shop listings](https://www.monocrawl.com/docs/endpoints/etsy/shop-products) — The listings of an Etsy shop, with price, discount, badges and processing time.

- [Etsy shop search](https://www.monocrawl.com/docs/endpoints/etsy/shops) — Shops matching a keyword, twelve per page.



### Reviews and offers



- [Etsy listing reviews](https://www.monocrawl.com/docs/endpoints/etsy/reviews) — Reviews of an Etsy listing, eight per page, with the rating distribution and review themes.

- [Etsy shop reviews](https://www.monocrawl.com/docs/endpoints/etsy/shop-reviews) — Reviews of an Etsy shop across its listings, eight per page.



### Search and discovery



- [Etsy listing search](https://www.monocrawl.com/docs/endpoints/etsy/search) — Listings matching a keyword, twelve per page, with price, discount, shop, rating and badges.

- [Etsy search suggestions](https://www.monocrawl.com/docs/endpoints/etsy/suggestions) — Search suggestions for a partial query, with the categories each suggests.



### Other operations



- [Etsy similar listings](https://www.monocrawl.com/docs/endpoints/etsy/similar) — Listings similar to one listing.



## Check fields and collection limits



Use the endpoint’s declared parameters and returned continuation. Filters from another platform do not automatically apply here. Preserve source identifiers, URLs and warnings; a successful page does not establish complete history. Published response schemas identify whether they come from a reviewed shaper or observed response shapes.



Agents can use `get_endpoint` for the current contract and `get_docs` with topic `platforms/etsy` to read this page. The [coverage guide](https://www.monocrawl.com/docs/data-availability) explains nulls and partial results, and the [production guide](https://www.monocrawl.com/docs/production-checklist) covers budgets and recovery.



## Endpoint reference

## etsy/categories

`GET /v1/etsy/categories`

The Etsy category tree, or one branch of it.

*Etsy categories*

| Parameter | Required | Description |
| --- | --- | --- |
| `parent_id` | no | Parent category id for its children |
| `depth` | no | Tree depth, 1-3 — e.g. `1` |
| `query` | no | Category name search |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `depth`: Bound collection to the documented number of records or source pages. Depth semantics vary by endpoint and may affect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/categories" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "children": [],
      "children_count": 0,
      "children_ids": [
        "example"
      ],
      "id": "example",
      "level": 0,
      "name": "example",
      "path": "example",
      "url": "https://example.com/example"
    }
  ]
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/categories#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/categories.json)


## etsy/category-products

`GET /v1/etsy/category-products`

Listings in an Etsy category, 64 per page.

*Etsy category listings*

| Parameter | Required | Description |
| --- | --- | --- |
| `path` | yes | Category path, or its etsy.com/c/ URL — e.g. `jewelry/necklaces` |
| `page` | no | Page number (64 per page) — e.g. `1` |
| `sort` | no | relevancy, most_recent, price_asc, price_desc or highest_reviews Accepted values: relevancy, most_recent, price_asc, price_desc, highest_reviews. Case, spaces, hyphens and underscores are interchangeable. |
| `min_price` | no | Minimum price |
| `max_price` | no | Maximum price |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/category-products?path=jewelry%2Fnecklaces" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "bestseller": false,
      "currency": "example",
      "discount_percent": 0,
      "etsys_pick": false,
      "free_shipping": false,
      "has_video": false,
      "id": "example",
      "image": "https://example.com/example",
      "images": [],
      "is_ad": false,
      "original_price": 0,
      "platform": "example",
      "popular_now": false,
      "price": 0,
      "reviews_count": 0,
      "shop": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "star_seller": false,
      "thumbnail": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "page": 0,
  "path": "example",
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/category-products#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/category-products.json)


## etsy/product

`GET /v1/etsy/product`

One Etsy listing: title, description, price, availability, images, tags, materials, category, shop, favourites, views and recent reviews.

*Etsy listing*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Etsy listing id, or its URL — e.g. `4429284280` |
| `currency` | no | Currency code — e.g. `USD` |
| `region` | no | Two-letter region — e.g. `US` |
| `language` | no | Language — e.g. `en-US` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/product?id=4429284280" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "available": false,
  "bestseller": false,
  "category": {
    "taxonomy": "example"
  },
  "created_at": "2026-09-01T12:00:00Z",
  "currency": "example",
  "customizable": false,
  "description": "example",
  "digital": false,
  "favorites": 0,
  "id": "example",
  "image": "https://example.com/example",
  "images": [
    "example"
  ],
  "made_to_order": false,
  "materials": [
    "example"
  ],
  "platform": "example",
  "price": 0,
  "price_usd": 0,
  "quantity": 0,
  "recent_reviews": [],
  "reviews_summary": {
    "average_rating": 0,
    "rating_counts": {
      "All": 0
    },
    "tags": [
      {
        "name": "example",
        "negative": 0,
        "positive": 0
      }
    ],
    "total_reviews": 0
  },
  "section": "example",
  "ships_from": "example",
  "shop": {
    "avatar": "https://example.com/example",
    "id": "example",
    "name": "example",
    "url": "https://example.com/example"
  },
  "similar": [],
  "sold_out": false,
  "state": "example",
  "tags": [
    "example"
  ],
  "title": "example",
  "top_rated": false,
  "type": "example",
  "updated_at": "2026-09-01T12:00:00Z",
  "url": "https://example.com/example",
  "variation_pricing": false,
  "views": 0,
  "vintage": false,
  "when_made": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/product#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/product.json)


## etsy/reviews

`GET /v1/etsy/reviews`

Reviews of an Etsy listing, eight per page, with the rating distribution and review themes.

*Etsy listing reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Etsy listing id, or its URL — e.g. `4429284280` |
| `page` | no | Page number (8 per page) — e.g. `1` |
| `scope` | no | listing or shop Accepted values: listing, shop. Case, spaces, hyphens and underscores are interchangeable. — e.g. `listing` |
| `sort` | no | relevancy, recency, highest or lowest Accepted values: relevancy, recency, highest, lowest. Case, spaces, hyphens and underscores are interchangeable. — e.g. `relevancy` |
| `rating` | no | Only this star rating (1-5) |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/reviews?id=4429284280" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "author": {
        "avatar": "https://example.com/example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "id": "example",
      "listing": {
        "id": "example",
        "title": "example",
        "url": "https://example.com/example"
      },
      "platform": "example",
      "posted_at": "2026-09-01T12:00:00Z",
      "rating": 0,
      "recommended": false,
      "text": "example"
    }
  ],
  "listing_id": "example",
  "page": 0,
  "photos": [
    "example"
  ],
  "rating": {
    "max": 0,
    "value": 0,
    "votes": 0
  },
  "rating_distribution": {
    "All": 0
  },
  "themes": [
    {
      "name": "example",
      "negative": 0,
      "positive": 0
    }
  ],
  "total": 0,
  "total_pages": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/reviews.json)


## etsy/search

`GET /v1/etsy/search`

Listings matching a keyword, twelve per page, with price, discount, shop, rating and badges.

*Etsy listing search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keyword — e.g. `wool socks` |
| `page` | no | Page number (12 per page) — e.g. `1` |
| `sort` | no | relevancy, most_recent, price_asc, price_desc or highest_reviews Accepted values: relevancy, most_recent, price_asc, price_desc, highest_reviews. Case, spaces, hyphens and underscores are interchangeable. — e.g. `relevancy` |
| `min_price` | no | Minimum price |
| `max_price` | no | Maximum price |
| `ship_to` | no | Two-letter country |
| `currency` | no | Currency code — e.g. `USD` |
| `region` | no | Two-letter region — e.g. `US` |
| `language` | no | Language — e.g. `en-US` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `region`: Select the documented source market or request location. Read this endpoint’s region semantics; it does not generally prove creator residence.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/search?query=wool%20socks" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "bestseller": false,
      "color_options": 0,
      "currency": "example",
      "discount_percent": 0,
      "etsys_pick": false,
      "free_shipping": false,
      "has_video": false,
      "id": "example",
      "image": "https://example.com/example",
      "images": [],
      "is_ad": false,
      "original_price": 0,
      "platform": "example",
      "popular_now": false,
      "price": 0,
      "rating": {
        "max": 0,
        "value": 0,
        "votes": 0
      },
      "reviews_count": 0,
      "shop": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "star_seller": false,
      "thumbnail": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "page": 0,
  "query": "example",
  "sort": "example",
  "total": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/search#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/search.json)


## etsy/shop

`GET /v1/etsy/shop`

One Etsy shop: sales, rating, seller, location, listing counts and sections.

*Etsy shop*

| Parameter | Required | Description |
| --- | --- | --- |
| `shop` | yes | Shop name, numeric id or URL — e.g. `Qorux` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/shop?shop=Qorux" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "created_at": "2026-09-01T12:00:00Z",
  "currency": "example",
  "digital_listings_count": 0,
  "id": "example",
  "listings_count": 0,
  "location": "example",
  "name": "example",
  "on_vacation": false,
  "open": false,
  "platform": "example",
  "rating": {
    "max": 0,
    "value": 0,
    "votes": 0
  },
  "reviews_count": 0,
  "sales": 0,
  "sections": [
    {
      "id": "example",
      "listings_count": 0
    }
  ],
  "seller": {
    "avatar": "https://example.com/example",
    "name": "example",
    "since": "example"
  },
  "type": "example",
  "updated_at": "2026-09-01T12:00:00Z",
  "url": "https://example.com/example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/shop#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/shop.json)


## etsy/shop-products

`GET /v1/etsy/shop-products`

The listings of an Etsy shop, with price, discount, badges and processing time.

*Etsy shop listings*

| Parameter | Required | Description |
| --- | --- | --- |
| `shop` | yes | Shop name, numeric id or URL — e.g. `Qorux` |
| `page` | no | Page number — e.g. `1` |
| `limit` | no | Up to 48 per page — e.g. `24` |
| `section_id` | no | A section id from etsy/shop |
| `sort` | no | created, price_asc, price_desc or score Accepted values: created, price_asc, price_desc, score. Case, spaces, hyphens and underscores are interchangeable. — e.g. `created` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/shop-products?shop=Qorux" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "available": false,
      "bestseller": false,
      "created_at": "2026-09-01T12:00:00Z",
      "currency": "example",
      "customizable": false,
      "digital": false,
      "has_video": false,
      "id": "example",
      "image": "https://example.com/example",
      "images": [
        "example"
      ],
      "made_to_order": false,
      "materials": [],
      "platform": "example",
      "price": 0,
      "quantity": 0,
      "shop": {
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "sold_out": false,
      "star_seller": false,
      "tags": [],
      "thumbnail": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example",
      "vintage": false
    }
  ],
  "page": 0,
  "shop": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/shop-products#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/shop-products.json)


## etsy/shop-reviews

`GET /v1/etsy/shop-reviews`

Reviews of an Etsy shop across its listings, eight per page.

*Etsy shop reviews*

| Parameter | Required | Description |
| --- | --- | --- |
| `shop` | yes | Shop name, numeric id or URL — e.g. `Qorux` |
| `page` | no | Page number (8 per page) — e.g. `1` |
| `sort` | no | recency, relevancy, highest or lowest Accepted values: relevancy, recency, highest, lowest. Case, spaces, hyphens and underscores are interchangeable. — e.g. `recency` |
| `rating` | no | Only this star rating (1-5) |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/shop-reviews?shop=Qorux" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "author": {
        "avatar": "https://example.com/example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "id": "example",
      "listing": {
        "id": "example",
        "title": "example",
        "url": "https://example.com/example"
      },
      "photo": "example",
      "platform": "example",
      "posted_at": "2026-09-01T12:00:00Z",
      "rating": 0,
      "recommended": false,
      "text": "example"
    }
  ],
  "page": 0,
  "photos": [
    "example"
  ],
  "rating": {
    "max": 0,
    "value": 0,
    "votes": 0
  },
  "rating_distribution": {
    "All": 0
  },
  "shop": "example",
  "themes": [],
  "total": 0,
  "total_pages": 0
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/shop-reviews#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/shop-reviews.json)


## etsy/shops

`GET /v1/etsy/shops`

Shops matching a keyword, twelve per page.

*Etsy shop search*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Search keyword — e.g. `ceramic` |
| `page` | no | Page number (12 per page) — e.g. `1` |
| `sort` | no | most_relevant, most_recent or alphabetical Accepted values: most_relevant, most_recent, alphabetical. Case, spaces, hyphens and underscores are interchangeable. — e.g. `most_relevant` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `sort`: Choose the documented source ordering before paging through results. Ordering keeps the normal endpoint price and does not guarantee exhaustive results.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/shops?query=ceramic" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "cursor": null,
  "has_more": false,
  "items": [
    {
      "icon": "example",
      "images": [
        "example"
      ],
      "listings_count": 0,
      "name": "example",
      "platform": "example",
      "title": "example",
      "type": "example",
      "url": "https://example.com/example"
    }
  ],
  "page": 0,
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/shops#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/shops.json)


## etsy/similar

`GET /v1/etsy/similar`

Listings similar to one listing.

*Etsy similar listings*

| Parameter | Required | Description |
| --- | --- | --- |
| `id` | yes | Etsy listing id, or its URL — e.g. `4429284280` |
| `limit` | no | Requested rows per response, 1–1000. The source may return fewer. Remaining rows from an already purchased page use a saved cursor and cost zero to retrieve for up to one hour; further native source pages use this endpoint’s normal price. — e.g. `5` |
| `cursor` | no | Use the returned cursor unchanged, retaining the original query, filters and limit. Saved mlo1. cursors retrieve already purchased rows at zero credits for up to one hour. A native source cursor, when supplied, starts a normally priced source page. Quote with dry_run before continuing. |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `limit`: Bound the returned rows to what your task needs. A smaller limit does not necessarily reduce source calls or price; inspect the quote.
- `cursor`: Continue the same source traversal with the complete returned cursor. Saved-result retrieval and a new source page can have different prices; quote the next call.
- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/similar?id=4429284280" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "available": false,
      "bestseller": false,
      "category": {
        "taxonomy": "example"
      },
      "created_at": "2026-09-01T12:00:00Z",
      "currency": "example",
      "customizable": false,
      "description": "example",
      "digital": false,
      "favorites": 0,
      "id": "example",
      "image": "https://example.com/example",
      "images": [
        "example"
      ],
      "made_to_order": false,
      "materials": [
        "example"
      ],
      "platform": "example",
      "price": 0,
      "price_usd": 0,
      "quantity": 0,
      "section": "example",
      "ships_from": "example",
      "shop": {
        "avatar": "https://example.com/example",
        "id": "example",
        "name": "example",
        "url": "https://example.com/example"
      },
      "sold_out": false,
      "state": "example",
      "tags": [
        "example"
      ],
      "title": "example",
      "top_rated": false,
      "type": "example",
      "updated_at": "2026-09-01T12:00:00Z",
      "url": "https://example.com/example",
      "variation_pricing": false,
      "views": 0,
      "vintage": false,
      "when_made": "example"
    }
  ],
  "listing_id": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/similar#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/similar.json)


## etsy/suggestions

`GET /v1/etsy/suggestions`

Search suggestions for a partial query, with the categories each suggests.

*Etsy search suggestions*

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | Partial search text — e.g. `gift` |
| `dry_run` | no | Read a zero-credit estimate without fetching sources, running AI, or reserving credits. Cache status is a snapshot, not a guarantee at execution. Accepted values: 1, 0, true, false. Case, spaces, hyphens and underscores are interchangeable. — e.g. `1` |

### Useful optional inputs

- `dry_run`: Read a free estimate before fetching sources or scheduling paid work. Zero credits; cache status and availability are snapshots rather than guarantees.

**Cost:** 4 credits at list price per successful uncached response; variable-cost operations may quote or settle a different charge. Confirmed uncharged or refunded failures report zero. Pending reconciliation can report credits_used:null; retain request_id and the original idempotency key.

```bash
curl "https://www.monocrawl.com/v1/etsy/suggestions?query=gift" \
  -H "x-api-key: mn_your_key_here"
```

### Response data

Illustrative abbreviated data; documented core fields are optional and may be null. Additional source fields are allowed.

```json
{
  "count": 0,
  "has_more": false,
  "items": [
    {
      "categories": [],
      "query": "example"
    }
  ],
  "query": "example"
}
```

[Field reference](https://www.monocrawl.com/docs/endpoints/etsy/suggestions#response) · [JSON Schema for response.data](https://www.monocrawl.com/schemas/etsy/suggestions.json)