Etsy Product Scraper

Look up any Etsy listing by ID or URL and export title, price, shop, images, rating, reviews, and shipping origin. One dataset row per listing — ready for CSV, Excel, or JSON.

Built for Apify Console, API, MCP agents, and integrations (Make, Zapier, n8n). This Actor reads listing-detail pages. It does not search Etsy or pull full review threads.

What you get

Field	Example
title	Freshwater Pearl Drop Earrings…
productId	1858266469
url	https://www.etsy.com/listing/1858266469
price	32
currency	USD
sellerName	Divanjewelrygold
rating	4.71
shipsFrom	North Bergen, NJ

Each input is one listing. That is not the same product as a search scraper, which returns many listings per keyword.

Sample output

Live row from listing ID 1858266469:

{
  "input": "1858266469",
  "type": "product",
  "productId": "1858266469",
  "url": "https://www.etsy.com/listing/1858266469/freshwater-pearl-drop-earringsbridal",
  "title": "Freshwater Pearl Drop Earrings,Bridal Pearl Earrings,18K Gold Dangle Earrings,Wedding Earrings,Bridesmaid Gift,Wedding Gift,Bridal Jewelry",
  "price": 32,
  "listPrice": 40,
  "currency": "USD",
  "rating": 4.71,
  "sellerName": "Divanjewelrygold",
  "sellerUrl": "https://www.etsy.com/shop/Divanjewelrygold",
  "shipsFrom": "North Bergen, NJ",
  "variationCount": 3,
  "categories": ["Homepage", "Jewelry", "Earrings", "Dangle & Drop Earrings"],
  "imageUrl": "https://i.etsystatic.com/55594479/r/il/8c24e4/6566024892/il_75x75.6566024892_rdzf.jpg"
}

How to run

1. Open the Actor in Apify Console.
2. Paste listing IDs or etsy.com/listing/… URLs, one per line.
3. Optional: max results.
4. Click Start. Open the Output tab when the run finishes.

Example input

{
  "productIds": [
    "1858266469",
    "https://www.etsy.com/listing/1858266469"
  ],
  "maxResults": 10
}

Duplicate IDs (including the same listing as ID and URL) are fetched once.

API

curl -X POST "https://api.apify.com/v2/acts/datacortex~etsy-product-scraper/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"productIds":["1858266469"]}'

Replace YOUR_TOKEN with an Apify API token.

Use with MCP / agents

This is a normal Apify Actor. Agents call it through Apify MCP — you do not run a separate MCP process.

Pin this Actor as a tool (after it is public):

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=datacortex/etsy-product-scraper"
    }
  }
}

The agent should fetch-actor-details on datacortex/etsy-product-scraper, then run it with the same JSON as Example input above. Running Actors requires an Apify token (OAuth in the client, or Authorization: Bearer <APIFY_TOKEN>).

Pricing

$5.00 per 1,000 listings + $0.001 per run.

Each input is one lookup and one dataset row. That is not the same product as a search scraper ($0.50 / 1,000), which returns many rows per query.

Event	When it fires	Price
apify-actor-start	Once when the run starts	$0.001
apify-default-dataset-item	Once per dataset row (one listing)	$0.005 ($5.00 / 1,000)

Job	Rows	You pay
1 listing	1	$0.001 + $0.005 = $0.006
10 listings	10	$0.001 + $0.050 = $0.051
100 listings	100	$0.001 + $0.500 = $0.501
1,000 listings	1,000	$0.001 + $5.000 = $5.001

Set a max total charge per run so a long list cannot overrun budget. The Actor stops when that limit is reached.

Input reference

Field	Required	Default	Notes
productIds	yes	—	IDs or URLs, max 1,000, duplicates skipped
maxResults	no	all	Hard cap across the list

Limitations

• Listing-detail pages only. This Actor does not search Etsy or download full review threads.
• Prices are what Etsy showed for the listing at fetch time.
• Unavailable or unparseable listings return an error row.

Changelog

See CHANGELOG.md.