Etsy Product Search Scraper

What is Etsy Product Search Scraper?

Etsy Product Search Scraper returns one dataset row per Etsy listing that matches your keyword: title, price and currency, sale flag, free-shipping flag, average rating, review count, shop name and link, main image, Star Seller badge, listing URL and rank position. Sellers, product researchers, price analysts and AI agents use it to see what sells in a niche, compare prices and spot top shops, with no Etsy account.

Why sellers use it for product research

• Keyword in, ranked listings out. One search phrase such as handmade necklace returns listings in Etsy's order with position.
• Prices you can compare. Current price, currency and isOnSale for discounted listings.
• Social proof. Average rating and reviewCount for each listing.
• Shop context. shopName, shopUrl and the Star Seller badge.
• Shipping signal. hasFreeShipping shows which listings ship free.

How to use it

The top 25 listings for a niche:

{
  "searchQuery": "handmade necklace",
  "maxResults": 25
}

A deeper look at a competitive category:

{
  "searchQuery": "personalized dog collar",
  "maxResults": 100,
  "maxPages": 5
}

Input	What it controls
searchQuery	The Etsy search phrase
maxResults	Most listings to save, 1 to 250 (default 25); also the cost ceiling
maxPages	Etsy result pages to read, 1 to 10 (default 3)

Output: Etsy listing data you receive

A real row (search URL shortened):

{
  "listingId": "1174946911",
  "listingUrl": "https://www.etsy.com/listing/1174946911/lapis-lazuli-necklace-pearl-and-gemstone",
  "title": "Lapis Lazuli Necklace, Pearl and Gemstone Jewelry for Anniversary Gift, Layered Handmade Dark Blue Statement Necklace",
  "imageUrl": "https://i.etsystatic.com/32268609/r/il/8cc49d/5128543637/il_fullxfull.5128543637_2zcu.jpg",
  "price": 169.15,
  "currency": "USD",
  "rating": 5,
  "reviewCount": 137,
  "shopName": "BURCU",
  "shopUrl": null,
  "isOnSale": true,
  "hasFreeShipping": true,
  "badges": [],
  "searchQuery": "handmade necklace",
  "page": 1,
  "position": 1,
  "scrapedAt": "2026-10-02T15:16:01.255Z"
}

Field	What it contains
listingId, listingUrl, title, imageUrl	The listing
price, currency, isOnSale	Current price and whether it is discounted
rating, reviewCount	Average rating and number of reviews for the listing
shopName, shopUrl, badges	The seller and Star Seller status
hasFreeShipping	Free shipping offered
position, page, searchQuery	Rank in the results and which search found it
dataSource	etsySearch (Etsy search page), the provider label (managed Etsy route) or searchIndexFallback (listing URL and title only)

OUTPUT and RUN_SUMMARY report the outcome (COMPLETE, PARTIAL, VALID_EMPTY), listings saved and any pages that needed the managed route.

Example workflow: pricing a new product line

A jewellery maker plans a gemstone necklace range. They collect 100 listings for gemstone necklace, keep rows with reviewCount above 50, and chart price against rating to find the price band where well-reviewed pieces sit. isOnSale shows how often competitors discount. Then they continue with Etsy Scraper on the best-selling listings to read their reviews and full descriptions.

Pricing

This Actor uses Pay per event plus Apify platform usage. You pay a small start event and one event per listing saved, plus the platform usage of the job. The live Pricing tab on this page shows the current price.

• maxResults 25 = up to 25 listing events + platform usage.
• maxResults is the cost ceiling for the whole job.
• When Etsy's own search page is unavailable, the managed route fills the same fields at the same price per listing.

Etsy research with AI agents (MCP)

Connect this Actor to an AI agent through Apify MCP and ask in plain language:

What do the top-rated personalised leather wallets on Etsy cost? Give me the price range and the five best-reviewed shops.

Agent checklist:

1. Put the product phrase in searchQuery.
2. Set maxResults to what the user needs; 25 is enough for most questions.
3. Read rows with get-dataset-items; sort by reviewCount or price.
4. Expect a few minutes when the managed route is used; OUTPUT.outcome confirms the result.

API example

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~etsy-product-search-scraper/run-sync-get-dataset-items" \
  -H "Authorization: Bearer $APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchQuery": "ceramic mug", "maxResults": 20}'

Related marketplace tools from the same developer

Your next step	Use	Why
When you then want reviews and full listing details	Etsy Scraper	Listing pages, shop catalogs and reviews
When you compare digital products on Gumroad	Gumroad Scraper	Gumroad prices, ratings and creators
When you research Shopify stores in the same niche	Shopify Scraper	Store products and prices

Best results

Starting situation	Helpful action	Expected outcome
A broad niche	Use a specific phrase such as sterling silver hoop earrings	More relevant listings
Price research	Keep maxResults at 25–50	A representative price band quickly
Finding top shops	Sort by reviewCount	Shops with the strongest track record
Testing the output	Set maxResults to 3	A quick, low-cost sample

Builder's note

I found that Etsy researchers care most about price next to rating and review count, so every row carries all three. I learned that Etsy often refuses automated visits to its search pages, so the Actor now switches to a managed Etsy data route that returns the same listing fields, which is why some jobs take a few minutes.

FAQ

Do I need an Etsy account?

No. The Actor collects public Etsy listing data.

Why do some jobs take a few minutes?

When Etsy's search page is unavailable, the managed Etsy route collects full listing data, which takes a few minutes per search.

Why is shopUrl sometimes empty?

Some listings carry the shop name without a shop link in the data Etsy returns. shopName is filled in those rows.

Can I search in other languages?

Yes. Etsy matches phrases in other languages, for example collier fait main.

What does dataSource mean?

It tells you which route produced the row; all routes return genuine Etsy listings.

Responsible use

This Actor collects publicly visible Etsy listing data. Use it for market research and follow Etsy's terms and the laws that apply to you. Read Apify's guide on whether web scraping is legal for more context. Etsy is a trademark of Etsy, Inc. This independent Actor is not affiliated with, associated with, or endorsed by Etsy. For questions or bugs, open a ticket in the Issues tab.