# Search — Eto API

> Search active Etsy listings across the marketplace.

Base URL `https://eto.tools/api/v1/`. Every request carries the `X-Eto-API-Key` header. Part of the [Eto API reference](https://eto.tools/dev/docs/).

## Endpoints in this category

- [GET /api/v1/listings/search](https://eto.tools/dev/docs/search/listings-search.md): Search active Etsy listings

## GET /api/v1/listings/search

Search active Etsy listings

- Operation ID: `listings_search`
- Slug: `listings-search`
- Category: Search
- Authentication: API key only. Reads public marketplace data, so no store needs to be connected.
- HTML: https://eto.tools/dev/docs/#ep-listings-search
- Markdown: https://eto.tools/dev/docs/search/listings-search.md

Search for active listings on Etsy by keyword. Returns paginated results with listing details.

Proxied to the Etsy API at `/v3/application/listings/active`. Fields Etsy returns are passed through untouched.

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `keywords` | query | `string` | yes | Search keywords |
| `limit` | query | `integer` | no | Number of results (max 100) Default: `25`. |
| `offset` | query | `integer` | no | Pagination offset Default: `0`. |
| `sort_on` | query | `string` | no | Sort field: created, price, score Default: `created`. |
| `sort_order` | query | `string` | no | Sort order: asc, desc Default: `desc`. |
| `min_price` | query | `number` | no | Minimum price filter |
| `max_price` | query | `number` | no | Maximum price filter |
| `category_id` | query | `integer` | no | Filter by product category ID (get IDs from /categories) |

### Request

```bash
curl -H "X-Eto-API-Key: eto_your_key" "https://eto.tools/api/v1/listings/search?keywords=leather+wallet&limit=10"
```

```python
import requests

url = "https://eto.tools/api/v1/listings/search?keywords=leather+wallet&limit=10"
headers = {"X-Eto-API-Key": "eto_your_key"}

response = requests.get(url, headers=headers, timeout=120)
response.raise_for_status()
print(response.json())
```

```javascript
const url = "https://eto.tools/api/v1/listings/search?keywords=leather+wallet&limit=10";

const response = await fetch(url, {
  method: "GET",
  headers: {
    "X-Eto-API-Key": "eto_your_key",
  },
});
if (!response.ok) throw new Error(`Eto API ${response.status}`);
const data = await response.json();
```

### Response

```json
{"count": 1000, "results": [{"listing_id": 123, "title": "...", "price": {"amount": 2999, "divisor": 100, "currency_code": "USD"}, ...}]}
```

### Errors

Failures answer with the shared error body described in the Errors section: `{"error": {"code", "status", "message", "hint", "docs"}}`. Branch on `code`, not on the message.