Etsy Listings Scraper
astravalabs/etsy-listings-scraper
Submit up to 50 keywords and collect Etsy search results in bulk. Every row preserves its keyword, overall and organic position, sponsored slot, localized price, shop signals, badges, product type, and media indicators without visiting every product page.
// run this actor
Use the Apify CLI for a quick local run, or the HTTP API from any language or automation platform.
apify call astravalabs/etsy-listings-scraper --input '{"keywords":["mushroom lamp","cottagecore lamp"],"maxPages":5,"maxTotalResults":1000,"country":"US"}'# Set API token
API_TOKEN=<YOUR_API_TOKEN>
# Prepare Actor input
cat > input.json << 'EOF'
{
"keywords": [
"mushroom lamp",
"cottagecore lamp"
],
"maxPages": 5,
"maxTotalResults": 1000,
"country": "US"
}
EOF
# Run the Actor using the HTTP API
# Full API reference: https://docs.apify.com/api/v2
curl "https://api.apify.com/v2/acts/astravalabs~etsy-listings-scraper/runs?token=$API_TOKEN" \
-X POST \
-d @input.json \
-H 'Content-Type: application/json'// Replace <YOUR_API_TOKEN> before running the cURL example. Keep tokens out of committed files.
// output — 36 top-level fields per listing
// use cases
- Etsy niche and ranking research
- Organic versus sponsored placement mapping
- Pricing and discount teardowns
- Localized market comparisons
// boundaries
- Search-result pages do not contain full descriptions, tags, materials, galleries, or complete reviews.
- Etsy usually caps a keyword index at roughly 20–22 pages even when more are requested.
A measured 5-page single-keyword run returned 258 listings in 9.4 seconds; the 50-keyword maximum-scale run returned 63,840 in 5m 29.2s.
What “last tested” means
The published input contract, output field list, pricing unit, and documentation were checked against the current actor, and a sample run completed on the date shown. This is a dated product check, not an uptime guarantee; public source behavior can change after testing.
Inspect representative JSON →// sanitized illustrative values; field names and nesting follow the published output contract