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

keywords · array · required

List · Etsy search keywords. One per line.

maxResults · integer · default: 100

Number · Maximum number of items to return per keyword. Use 0 for all.

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

curl

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
    }
  }
}'

Example response

Response

{
  "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"
      ]
    }
  ]
}