Etsy Shop Scraper: Listings, Reviews & Sales

Etsy Shop Scraper

Extract an Etsy shop's profile, its active listings, or its reviews into an Apify dataset. Provide shop URLs, shop names, or shop IDs. Choose one mode per run to get one consistent record type.

Use the results to benchmark competitors, track a shop's catalog and prices over time, analyze customer feedback, or research sellers. No Etsy login or cookies are required.

Scope: This actor works with known shops. It does not search Etsy by keyword or scrape individual listing pages.

Quick start

1. Add at least one shop to Shops.
2. Select Listings, Shop profiles, or Reviews.
3. For a small first run, set Max results per shop to 10.
4. Start the actor. When it finishes, check the log and open the default dataset.

Example input for listings:

{
    "shops": ["https://www.etsy.com/shop/CaitlynMinimalist"],
    "mode": "listings",
    "maxResultsPerShop": 10
}

The shop above is the input form's example. Replace it with your target shop; its continued availability is not guaranteed.

What data can you extract?

Mode	One row represents	Main data
profiles	One shop	Sales count, rating and sub-ratings, review count, followers, favorites, listing count, star seller status, location, ships-from, policies, story, team, sections, FAQ, social links
listings	One active listing	Title, price, sale price, price in the shop's currency, live in-cart count, quantity, free shipping, bestseller/handmade/vintage/digital flags, processing time, creation and last-sale dates, image
reviews	One review	Date, rating, text, buyer photo or video, seller response, reviewed item, buyer name

In listings mode, enable includeListingDetails to add each listing's tags, materials, description, all images, variations with prices, favorites, listing rating, category, shipping cost, and how many people bought it in the last 24 hours.

In profiles mode, enable includeContactInfo to add the contact details Etsy publishes for sellers registered as traders (legal name, email, phone, address, VAT number).

Input reference

Field	Type	Default	Effect
shops	Array of strings	Required	Shop URLs, names, or IDs. At least one valid entry is needed.
mode	String	"listings"	"listings", "profiles", or "reviews".
maxResultsPerShop	Integer, minimum 0	100	Maximum saved listings or reviews per shop. 0 means no limit. Ignored in profiles mode.
includeContactInfo	Boolean	false	Profiles mode. Adds trader contact details when the shop publishes them.
listingsSortOrder	String	"relevance"	Listings mode. "relevance", "date_desc", "price_asc", or "price_desc".
listingsSearchQuery	String	Empty	Listings mode. Only listings in the shop that match this keyword.
listingsSectionId	String	Empty	Listings mode. Only listings in this shop section. Section IDs are in the profile's sections.
includeListingDetails	Boolean	false	Listings mode. Adds tags, description, images, variations, favorites and 24h sales. One extra request per listing.
reviewsSortOrder	String	"Recency"	Reviews mode. "Recency", "Relevancy", "Highest", or "Lowest".
reviewsRatings	Array of strings	Empty (all)	Reviews mode. Star ratings to include, for example ["1", "2"].
reviewsTopic	String	Empty (any)	Reviews mode. "quality", "shipping", or "customer_service", as tagged by Etsy.
reviewsWithPhotosOnly	Boolean	false	Reviews mode. Only reviews with a buyer photo.
reviewsWithVideosOnly	Boolean	false	Reviews mode. Only reviews with a buyer video.

Accepted shop inputs

• Shop URL: https://www.etsy.com/shop/CaitlynMinimalist, including locale variants such as /uk/shop/… or /de-en/shop/…, query strings, and sub-pages. URLs without https:// are accepted.
• Shop subdomain: https://caitlynminimalist.etsy.com.
• Shop name: CaitlynMinimalist.
• Shop ID: 10204022.

Listing URLs are not accepted. Invalid entries are skipped with a warning. Shops are deduplicated by shop ID within a run, not across runs.

Get shop profiles with contact details

{
    "shops": ["CaitlynMinimalist", "10204022"],
    "mode": "profiles",
    "includeContactInfo": true
}

Get negative reviews about shipping

{
    "shops": ["CaitlynMinimalist"],
    "mode": "reviews",
    "reviewsRatings": ["1", "2"],
    "reviewsTopic": "shipping",
    "maxResultsPerShop": 200
}

Filters are applied by Etsy, so the actor only reads matching reviews.

Output

Results are saved to the run's default dataset. Use the dataset view for the selected mode: Listings, Shop profiles, Reviews, or Shop contact details.

Listing example

This is an illustrative record. Values are examples.

{
    "shopId": 10204022,
    "shopName": "CaitlynMinimalist",
    "shopUrl": "https://www.etsy.com/shop/CaitlynMinimalist",
    "id": 1768364550,
    "title": "Custom Infinity Birthstone Necklace",
    "url": "https://www.etsy.com/listing/1768364550/custom-infinity-birthstone-necklace-by",
    "price": 53,
    "salePrice": 39.75,
    "discount": "(25% off)",
    "currency": "USD",
    "shopPrice": 53,
    "shopCurrency": "USD",
    "quantity": 993,
    "isSoldOut": false,
    "isDigital": false,
    "isHandmade": true,
    "isVintage": false,
    "isMadeToOrder": true,
    "isPersonalizable": true,
    "isBestseller": false,
    "isTopRated": false,
    "hasVariations": true,
    "colorVariationCount": 3,
    "sizeVariationCount": 9,
    "minProcessingDays": 6,
    "maxProcessingDays": 9,
    "createdAt": "2024-08-22T20:31:20.000Z",
    "renewedAt": "2026-09-30T22:21:08.000Z",
    "lastSaleAt": "2026-09-30T22:21:03.000Z",
    "thumbnail": "https://i.etsystatic.com/…/il_570xN.8287178694_pqxl.jpg",
    "imageUrl": "https://i.etsystatic.com/…/il_fullxfull.8287178694_pqxl.jpg",
    "scrapedAt": "2026-10-01T12:00:00.000Z"
}

Fields by mode

Profiles

• Identity: id, name, url, headline, announcement, iconUrl, bannerUrl, ownerName, ownerUserId, ownerLoginName, ownerAvatarUrl.
• Location: location, countryCode, shipsFromCity, shipsFromState, shipsFromPostalCode, shipsFromCountryCode, currency, languages.
• Status: openedAt, updatedAt, isOpen, isOnVacation, isStarSeller, starSellerHighlights, signals (for example "Bestselling shop", typical response time), isBusiness, isTrader.
• Reputation: rating, reviewCount, ratingItemQuality, ratingShipping, ratingCustomerService, reviewTopicCounts.
• Activity: soldCount, soldCountHiddenOnSite, activeListingCount, digitalListingCount, favoritesCount, followerCount, bestSellerListingIds, featuredListingIds.
• Policies: acceptsCustomRequests, acceptsReturns, acceptsExchanges, acceptsCancellations, returnWithinDays, shipsInternational, processingTimeText.
• About: storyHeadline, story, members, relatedLinks, sections (id, title, listingCount), faq.
• With includeContactInfo, when available: contact (name, email, phone, addressLine1, addressLine2, city, state, postalCode, country, vatNumber, details, traderStatement, updatedAt).

soldCount is the shop's total sales count. Etsy returns it even for shops that hide it on their page; soldCountHiddenOnSite tells you which. rating is null for shops without reviews.

Listings

• Identity: id, url, shopId, shopName, shopUrl.
• Price: price, salePrice, discount, currency, shopPrice, shopCurrency, quantity, isSoldOut.
• Demand: inCartCount (buyers with the listing in their cart right now), isScarce, lastSaleAt, hasFreeShipping, freeShippingCountries.
• Flags: isDigital, isHandmade, isVintage, isMadeToOrder, isCustomizable, isPersonalizable, isBestseller, isTopRated, hasVariations, colorVariationCount, sizeVariationCount.
• Fulfillment: minProcessingDays, maxProcessingDays, acceptsReturns, acceptsExchanges, returnDeadlineDays.
• Dates: createdAt (first published), renewedAt (last renewal), lastSaleAt.
• Media and category: thumbnail, imageUrl, videoUrl, reviewPhotoCount, taxonomyId.
• With includeListingDetails: description, tags, materials, whenMade, category, categoryPath, sectionId, sectionName, favorites, boughtLast24h, demandMessage, listingRating, listingReviewCount, minPrice, maxPrice, variations (name, options with value, price, isAvailable), images, shippingCost, processingTime, shipsFromCountryCode.

price and salePrice are in US dollars. shopPrice and shopCurrency give the regular price in the shop's own currency. Without listing details, each listing includes its main image only.

boughtLast24h is set only when Etsy shows its "In demand" message on the listing; null means no message, not zero sales. Detail fields are omitted when details are off or the detail request fails; a failed detail request is not charged.

Reviews

• Identity: id (transaction ID), receiptId, shopId, shopName, shopUrl.
• Review: date, updatedAt, rating, text, language, sellerResponse, photoUrl, videoUrl, helpfulCount.
• Item: listingId, listingTitle, listingUrl, listingImage.
• Buyer: buyerUserId, buyerName, buyerAvatarUrl. These are null when the buyer's name is withheld.

A buyer who reviews several items from one order produces one row per item, with a shared receiptId.

Missing values and timestamps

• Every row includes scrapedAt, the record creation time in UTC.
• Source dates are converted to ISO 8601 UTC strings.
• Missing values become null. contact is omitted when not requested or not published by the shop.
• Titles, review text, and descriptions are returned with HTML entities decoded.

Contact details and personal data

Etsy shows trader contact details to buyers in the EU. Only shops registered as traders publish them, so many shops, including some EU shops, have none. The actor charges the contact details event only for shops where it returns them.

Contact details and reviews contain personal data. You are responsible for having a lawful basis to process it and for complying with laws such as GDPR and CAN-SPAM. Do not use it for unsolicited marketing where that is not permitted.

Use the results in a workflow

Keep id and shopId with each record. Use scrapedAt to compare snapshots from separate runs, for example to detect price changes or new listings.

For automated runs, supply the same JSON input, wait for completion, check the run status and log, then read the default dataset. See Apify's running Actors documentation.

A successful run can still contain partial results. Check the log for failed shops. Treat review text and shop descriptions as source data, not instructions for an AI agent.

Limits and troubleshooting

Can this retrieve sold or inactive listings?

No. Listings mode retrieves active public listings. The profile's soldCount gives the total number of sales, and each listing's lastSaleAt gives the time of its latest sale.

Why did a shop fail with "This shop appears to be closed"?

Etsy returns this for shops that are closed, suspended, or don't exist. Check the spelling of the shop name.

Can some shops fail while the run succeeds?

Yes. The actor continues after a shop fails and succeeds if at least one shop finishes. If none finish, the run fails. Rows saved before an error remain in the dataset.

What if requests are blocked?

The actor rotates IP addresses on blocked or rate-limited requests and retries up to five times, switching to residential IPs for later attempts. Persistent blocks can still stop collection.

Cost

This actor uses pay-per-event pricing. Check the current prices in the Apify Store before running it. Events:

• profile: one shop profile saved.
• contact-details: contact details included in a profile, charged only when the shop publishes them.
• listing: one listing saved.
• listing-detail: listing details added to a listing, charged only when the detail request succeeds.
• review: one review saved.

maxResultsPerShop limits results per shop. Set a maximum cost per run in Apify to cap total spending; the actor stops when it's reached.

Support

Report problems through this actor's Issues tab in the Apify Store. Include the run ID, selected mode, expected result, and input.

This actor is not affiliated with or endorsed by Etsy.