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

# Etsy Products

> Search Etsy for products matching keywords, returning listing title, price, images, and URL

`$8 / 1k products`

Search Etsy for products matching keywords, returning listing title, price, images, and URL

## Endpoint

`POST /api/v1/agents/etsy/search/run`

## Parameters

<ParamField body="keywords" type="array" required>
  **List** · Etsy search keywords. One per line.
</ParamField>

<ParamField body="maxResults" type="integer" default={100}>
  **Number** · Maximum number of items to return per keyword. Use 0 for all.
</ParamField>

## Response columns

| Field                | Display name           | Type     |
| -------------------- | ---------------------- | -------- |
| `productUrl`         | Product URL            | url      |
| `title`              | Title                  | text     |
| `price`              | Price                  | currency |
| `currency`           | Currency               | text     |
| `shopRating`         | Shop Rating            | rating   |
| `shopReviews`        | Shop Reviews           | number   |
| `returnsAccepted`    | Returns Accepted       | boolean  |
| `exchangesAccepted`  | Exchanges Accepted     | boolean  |
| `minProcessingDays`  | Min Processing Days    | number   |
| `maxProcessingDays`  | Max Processing Days    | number   |
| `returnDeadlineDays` | Return Deadline (Days) | number   |
| `originPostal`       | Origin Postal          | text     |
| `imageUrls`          | Image URLs             | text     |

## Example

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST https://api.mindcase.co/api/v1/agents/etsy/search/run \
    -H "Authorization: Bearer mk_live_abc123def456" \
    -H "Content-Type: application/json" \
    -d '{
    "params": {
      "keywords": [
        "Taylor Swift necklace"
      ],
      "maxResults": 100,
      "proxyConfiguration": {
        "useApifyProxy": false
      }
    }
  }'
  ```

  ```python Python theme={null}
  import requests

  resp = requests.post(
      "https://api.mindcase.co/api/v1/agents/etsy/search/run",
      headers={"Authorization": "Bearer mk_live_abc123def456"},
      json={"params": {
      "keywords": [
          "Taylor Swift necklace"
      ],
      "maxResults": 100,
      "proxyConfiguration": {
          "useApifyProxy": false
      }
  }},
  )
  data = resp.json()
  ```
</CodeGroup>

### Example response

```json Response theme={null}
{
  "job_id": "job_7f3a2b1c",
  "status": "completed",
  "data": [
    {
      "productUrl": "https://www.etsy.com/listing/4497775941/vintage-18k-gold-venice-gondola-charm",
      "title": "Vintage 18k Gold Venice Gondola Charm Pendant 750 Italy",
      "price": "795.00",
      "currency": "USD",
      "shopRating": "4.93",
      "shopReviews": "79",
      "returnsAccepted": true,
      "exchangesAccepted": true,
      "minProcessingDays": 1,
      "maxProcessingDays": 1,
      "returnDeadlineDays": 7,
      "originPostal": "08750",
      "imageUrls": [
        "https://i.etsystatic.com/47002867/r/il/84bfb0/7972722930/il_fullxfull.7972722930_sdnx.jpg"
      ]
    }
  ]
}
```