Etsy Scraper

Extract Etsy marketplace data at scale without a login or API key. Pull a shop's full catalog, search results for any keyword, or a single listing in full detail with price, rating, reviews, and the complete image gallery. The scraper walks pagination automatically up to the limit you set, so you can collect hundreds or thousands of listings per source in a single run.

What it does

• Shop catalog - every listing from a shop, plus a shop profile record with location, owner, rating, and review count.
• Keyword search - listings matching any search term across the marketplace.
• Listing detail - full data for a specific listing: title, price, list price, availability, quantity, rating, review count, description, category, image gallery, and a sample of reviews.
• Pagination - shop and search modes walk multiple pages until your maxResultsPerSource is reached or the source runs out.
• Optional enrichment - turn lightweight shop and search cards into full listing records on demand.

Input

Field	Type	Description
shops	array	Shop names to pull listings from. With or without shop/, or a full shop URL. Example: example_shop.
searchQueries	array	Keyword searches. Example: ceramic mug.
listingUrls	array	Listing links or IDs to fetch in full detail. Example: https://www.etsy.com/listing/1234567890/example-title or 1234567890.
maxResultsPerSource	integer	Cap per shop or search query. Default 100.
enrichListings	boolean	Also open each shop and search listing for full detail. Default off.
includeShopProfile	boolean	Return a shop profile record in shop mode. Default on. Not billed.
concurrency	integer	Sources processed in parallel. Default 5.
proxyConfig	object	Apify proxy. RESIDENTIAL is the default and recommended.

At least one of shops, searchQueries, or listingUrls is required.

Example input

{
  "shops": ["example_shop"],
  "searchQueries": ["ceramic mug"],
  "maxResultsPerSource": 250,
  "enrichListings": false,
  "includeShopProfile": true,
  "concurrency": 3
}

Output

Each item is tagged with a type of listing or shop.

Listing

{
  "type": "listing",
  "id": "1234567890",
  "url": "https://www.etsy.com/listing/1234567890/an-example-title",
  "title": "An example handmade ceramic mug",
  "shop": "example_shop",
  "shopUrl": "https://www.etsy.com/shop/example_shop",
  "category": "Home & Living < Kitchen & Dining < Drink & Barware < Mugs",
  "price": 24.0,
  "currency": "USD",
  "listPrice": 30.0,
  "availability": "InStock",
  "quantity": 112,
  "rating": 4.9,
  "reviewCount": 4704,
  "description": "An example listing description.",
  "images": [
    "https://i.example.com/full/example_1.jpg",
    "https://i.example.com/full/example_2.jpg"
  ],
  "thumbnail": "https://i.example.com/full/example_1.jpg",
  "reviews": [
    {
      "author": "Jane Doe",
      "rating": 5,
      "date": "2024-12-19",
      "body": "An example review body."
    }
  ],
  "scrapedAt": "2026-06-17T12:00:00.000Z"
}

Shop

{
  "type": "shop",
  "name": "example_shop",
  "url": "https://www.etsy.com/shop/example_shop",
  "location": "Arizona, United States",
  "owner": "Jane Doe",
  "slogan": "An example shop slogan",
  "description": "An example shop description.",
  "logo": "https://i.example.com/logo.jpg",
  "banner": "https://i.example.com/banner.jpg",
  "rating": 5,
  "reviewCount": 4704,
  "listingCount": 36,
  "scrapedAt": "2026-06-17T12:00:00.000Z"
}

Every field is always present. Unknown values are null.

Use cases

• Build a price and product dataset for a shop or a category for market and competitor analysis.
• Track a competitor's catalog, pricing, and rating over time on a schedule.
• Monitor search results for a keyword to spot new sellers and trending products.
• Collect listings and reviews for research or model training.

Notes

• A run uses the Apify proxy you select. RESIDENTIAL gives the most reliable results.
• If a source is temporarily unavailable, the item is returned with a generic status (upstream_unavailable, upstream_rate_limit, or not_found) so a single failure never stops the run.
• Pagination depth is bounded by what the source exposes for a given shop or search.
• Shop and search cards carry the core fields (title, price, image). Turn on enrichListings for full per-listing detail including description and reviews.

To improve our actors we collect anonymized usage telemetry (run stats and input patterns). No personal account data is collected.