Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.mindcase.co/llms.txt

Use this file to discover all available pages before exploring further.

$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

FieldDisplay nameType
productUrlProduct URLurl
titleTitletext
pricePricecurrency
currencyCurrencytext
shopRatingShop Ratingrating
shopReviewsShop Reviewsnumber
returnsAcceptedReturns Acceptedboolean
exchangesAcceptedExchanges Acceptedboolean
minProcessingDaysMin Processing Daysnumber
maxProcessingDaysMax Processing Daysnumber
returnDeadlineDaysReturn Deadline (Days)number
originPostalOrigin Postaltext
imageUrlsImage URLstext

​
Example

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