# Etsy Scraper | Listings Shops Categories Prices (`lentic_clockss/etsy-scraper`) Actor

Scrape Etsy.com listings, shops & categories — keyword search, nested PLPs, PDP enrich, multi-market ship-to. Extract listingId, prices, ratings, images, badges. Export Excel/CSV/JSON.

- **URL**: https://apify.com/lentic\_clockss/etsy-scraper.md
- **Developed by:** [kane liu](https://apify.com/lentic_clockss) (community)
- **Categories:** E-commerce, Lead generation, Automation
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.20 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Etsy Scraper | Listings Shops Categories Prices

**Scrape Etsy product listings, keyword search, shops, categories, featured hubs, and listing detail pages — then download structured marketplace data as Excel, CSV, or JSON.**

Use this Actor as a practical **Etsy product data API** for price monitoring, seller research, and handmade/vintage assortment tracking. Pick a **ship-to market**, choose a mode, set filters, and get Dataset rows with `listingId`, prices (sale / original / % off), ratings, images, shop names, and ad badges.

- Scrape **Etsy search**, **shop search**, **category & subcategory PLPs** (`/c/jewelry` or `/c/jewelry/necklaces`), **listing PDP**, **shop pages**, **featured / curated** hubs, and the **category taxonomy**
- Cover **30+ ship-to markets** (US, GB, CA, AU, DE, FR, …) with locale, currency, and residential egress aligned to the market
- Extract **title, price, currency, salePrice, originalPrice, discountPercent, ratingValue, reviewCount, imageUrl, shopName, badges, isAd**
- Optional **PDP enrich** (`enrichDetails`) for shipping text, shop sales / years, more images, and variations
- Filter by **price range**, **ships from**, **ready to ship**, **Star Seller**, **free shipping**, and digital download
- Export to **Excel / CSV / JSON**, or connect Make, n8n, Zapier, Python, or the Apify API
- **Pay per event** — Actor start + each Dataset result; **platform usage is included** (you do not pay separate Apify compute on top)

> **Unofficial tool.** This Actor is not affiliated with, endorsed by, or sponsored by Etsy, Inc. It collects publicly reachable listing and shop surfaces and does **not** log in, checkout, place orders, or access private buyer/seller accounts. Login-only pricing and full review-pagination APIs are out of scope.

***

### What does the Etsy Scraper do?

[Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper) lets you **extract structured listing and shop data from [Etsy.com](https://www.etsy.com/)** without running your own anti-bot browser fleet. Give it a keyword, category slug, listing ID, shop name, or featured path, then start a run.

Under the hood, the Actor:

1. Validates your input (mode, ship-to market, query / category / listing / shop, filters)
2. Enforces free-tier caps when you are on a free Apify plan
3. Calls a managed Cloud Run worker that opens Etsy with residential egress and browser automation
4. Parses SERP cards (DOM + optional listingCards intercept) and PDP JSON-LD
5. Pushes Dataset rows ready for Excel / CSV / JSON export
6. Writes `RUN_SUMMARY` (and `ERROR_SUMMARY` on failure) to the key-value store

You run it like any other Apify Actor — schedule it, call it from the API, or plug it into automations.

***

### What Etsy data can I extract?

| Data | Search | Shop search | Category | Listing PDP | Shop | Featured | Categories |
| --- | :---: | :---: | :---: | :---: | :---: | :---: | :---: |
| listingId / URL | ✅ | — | ✅ | ✅ | ✅ | ✅ | — |
| Title / name | ✅ | shop | ✅ | ✅ | ✅ | ✅ | ✅ |
| Price / sale / original / % off | ✅ | — | ✅ | ✅ | ✅ | ✅ | — |
| Currency (by ship-to) | ✅ | — | ✅ | ✅ | ✅ | ✅ | — |
| shopName / shopUrl | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | — |
| imageUrl / images | ✅ | — | ✅ | ✅ | ✅ | ✅ | — |
| ratingValue / reviewCount | ✅ | — | ✅ | ✅ | shop meta | ✅ | — |
| badges / isAd | ✅ | — | ✅ | — | ✅ | ✅ | — |
| shipping / sales / years | enrich | — | enrich | ✅ | shop meta | enrich | — |
| variations / material | enrich | — | enrich | ✅ | — | enrich | — |
| categorySlug / path | — | — | ✅ | ✅ | — | — | ✅ |

***

### Why scrape Etsy?

Etsy is the leading marketplace for handmade, vintage, and craft goods. Teams scrape Etsy for **price monitoring**, **competitor analysis**, **product research**, and **seller lead generation**:

- Monitor **Etsy search results** and **category PLPs** across ship-to markets and currencies
- Track **sale vs original price**, discount %, Star Seller / ad badges, and ratings
- Pull **shop listings** with shop-level rating and sales text
- Map the **category taxonomy** (depth 2+) for assortment planning
- Enrich listings with **PDP JSON-LD** (images, availability, variations)
- Feed BI dashboards, pricing tools, or AI agents with structured Etsy rows

Compared with keyword-only Etsy scrapers, this Actor covers **search + shop search + nested categories + PDP enrich + shops + featured + taxonomy** with **multi-market ship-to prefs** in one input surface.

***

### More Actors like this

Need another marketplace or a different vertical? Use a **dedicated Actor** below for structured fields. Use this Actor for **Etsy** listings, shops, and categories across ship-to markets.

#### Similar e-commerce scrapers

- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)

#### Prefer another specialized scraper?

If your target has a specialized Actor below, use that first — usually cheaper and more structured than a generic scrape.

**Jobs & Freelance**

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)

**Real Estate**

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)

**Travel & Stays**

- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

**Social & Content**

- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)

**Ads Intelligence**

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

**Local & Maps**

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

**General Tools**

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ See the full catalog in [Related Actors](#related-actors) below, or browse [apify.com/lentic\_clockss](https://apify.com/lentic_clockss).

***

### How to scrape Etsy listings (no code required)

1. Create a free [Apify](https://apify.com/) account
2. Open [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
3. Choose a **shipTo** market (e.g. `US`, `GB`, `AU`, `DE`)
4. Choose a **mode**: `search`, `search_shops`, `category`, `listing`, `shop`, `categories`, or `featured`
5. Enter a **query**, **categorySlug** (`jewelry` or `jewelry/necklaces`), **listingId**, **shopName**, or **featuredPath**
6. *(Optional)* Set `order`, `priceMin` / `priceMax`, `starSeller`, `readyToShip`, `shipsFrom`, `enrichDetails`, `maxResults`
7. Click **Start** and download the Dataset as JSON, CSV, Excel, or JSONL

Start with `maxResults: 5–10` to verify the query, then scale up.

***

### How much does it cost to scrape Etsy?

This Actor uses **pay-per-event** pricing. You are charged for:

| Event | Price |
| --- | --- |
| Actor Start (`apify-actor-start`) | **$0.005** per start |
| Result (`apify-default-dataset-item`) | **$3.00 / 1,000** results (**$0.003** each) |

**Platform usage costs are included** — you do **not** pay separate Apify compute/proxy usage for this Actor on top of the event prices above (**User pays platform usage costs = No**).

#### Example cost estimates

| Results collected | Approx. event cost\* |
| --- | ---: |
| 100 | ~$0.31 |
| 1,000 | ~$3.01 |
| 10,000 | ~$30.01 |

\*Assumes one Actor start at default memory billing for start events, plus `$0.003` per Dataset item. Exact start billing can scale with allocated memory (one start event per GB, minimum one).

#### Free plan limits

On a **free Apify plan**, this Actor enforces developer limits of **10 runs** and **200 results per run**. Upgrade to a paid Apify plan for unlimited runs (event prices still apply).

***

### Input examples

#### Keyword search (US)

```json
{
  "mode": "search",
  "query": "ceramic mug",
  "shipTo": "US",
  "maxResults": 40,
  "order": "price_asc",
  "starSeller": true
}
```

#### Nested category (GB)

```json
{
  "mode": "category",
  "categorySlug": "jewelry/necklaces",
  "shipTo": "GB",
  "order": "price_asc",
  "maxResults": 30
}
```

#### Listing PDP enrich

```json
{
  "mode": "listing",
  "listingId": "591039492",
  "shipTo": "US",
  "enrichDetails": true
}
```

#### Shop listings

```json
{
  "mode": "shop",
  "shopName": "hardwoodcase",
  "shipTo": "US",
  "maxResults": 50
}
```

#### Search shops / featured

```json
{
  "mode": "search_shops",
  "query": "woodworking",
  "shipTo": "US",
  "maxResults": 20
}
```

```json
{
  "mode": "featured",
  "featuredPath": "/featured/hub",
  "maxResults": 20
}
```

***

### Coverage matrix

| Dimension | Coverage |
| --- | --- |
| Host | `www.etsy.com` |
| Markets (`shipTo`) | 30+ ISO markets + `ROW` (prefs + proxyCountry) |
| Modes | `search` · `search_shops` · `category` · `listing` · `shop` · `categories` · `featured` |
| Category | `/c/{slug}` and nested `/c/{a}/{b}` |
| Sort | Verified: `most_relevant` · `price_asc` · `price_desc` · `date_desc` |
| Filters | price · instantDownload · shipsFrom · readyToShip · starSeller · freeShipping |
| Enrich | PDP JSON-LD + shipping / sales / years / images / variations |
| Identity | `listingId` |

***

### Output example

```json
{
  "listingId": "1150212096",
  "title": "14 Color Ceramic Spoon Rest, Handmade Pottery",
  "price": 18.8,
  "salePrice": 18.8,
  "originalPrice": 47,
  "discountPercent": 60,
  "currency": "USD",
  "ratingValue": 4.8,
  "reviewCount": "3k",
  "imageUrl": "https://i.etsystatic.com/…/il_255x319….jpg",
  "shopName": "ZEEMRusticHomeDecor",
  "shopUrl": "https://www.etsy.com/shop/ZEEMRusticHomeDecor",
  "isAd": true,
  "badges": ["Ad"],
  "url": "https://www.etsy.com/listing/1150212096",
  "shipTo": "US",
  "recordType": "listing"
}
```

***

### Runtime

| Setting | Value |
| --- | --- |
| Default memory | **1024 MB** |
| Min / max memory | 512 / 4096 |
| Proxy | Worker-owned residential egress (`WORKER_PROVIDES_PROXY=1`) |
| Standby | Live View OpenAPI enabled |

***

### FAQ

#### Is this an official Etsy API?

No. This is an **unofficial scraper** for publicly reachable Etsy pages. It is not the [Etsy Open API](https://developers.etsy.com/) and is not affiliated with Etsy.

#### Why scrape Etsy instead of using the Open API?

The Open API requires seller OAuth apps and does not expose the same anonymous SERP / category / featured surfaces. This Actor targets **public search, category, shop, and listing pages** for market research workflows.

#### Can I scrape Etsy by category or shop?

Yes. Use `mode=category` with `categorySlug` (including nested paths like `jewelry/necklaces`), or `mode=shop` with `shopName`. `mode=categories` returns the taxonomy tree.

#### Does ship-to / currency work?

Yes. Set `shipTo` (e.g. `GB`, `DE`, `AU`). The worker applies locale/currency preferences and aligns residential egress to the market. Rows include `currency` when available (or filled from the market default).

#### Why did my free run stop?

Free-plan users get **10 runs** and **200 results/run** — a developer-set policy, not an Apify platform error. Upgrade to a paid Apify plan for unlimited runs (PPE event prices still apply).

#### DataDome / empty results?

Etsy blocks bare HTTP. The worker uses browser automation + residential egress. Hard blocks surface as worker `status=blocked` (HTTP 403), not silent empty success.

#### What is not included?

Login-only member pricing, full review pagination APIs, and official Open API access are out of scope.

***

### Integrations

- [Apify API](https://docs.apify.com/api/v2) / Python / JS client
- Make, Zapier, n8n, and other webhooks via Dataset / run events
- Schedules for recurring price or category monitors

***

### Support

Questions or feature requests? Open an issue on the Actor page or contact the developer via Apify Console.

***

### Related Actors

All **77** public Actors from \[[lentic\_clockss](https://apify.com/lentic_clockss)]. Click a name to open the Store detail page.

#### Jobs & Freelance

- [LinkedIn Jobs Scraper](https://apify.com/lentic_clockss/linkedin-jobs-scraper)
- [Bayt Jobs Scraper](https://apify.com/lentic_clockss/bayt-scraper)
- [Fiverr Gigs Scraper](https://apify.com/lentic_clockss/fiverr-programming-tech-gigs-scraper)
- [Freelancer.com Scraper](https://apify.com/lentic_clockss/freelancer-scraper)
- [Glassdoor Scraper](https://apify.com/lentic_clockss/glassdoor-scraper)
- [Himalayas Jobs Scraper](https://apify.com/lentic_clockss/himalayas-jobs-scraper)
- [Indeed Jobs Scraper](https://apify.com/lentic_clockss/indeed-jobs-scraper)
- [Jobicy Remote Jobs Scraper](https://apify.com/lentic_clockss/jobicy-remote-jobs-scraper)
- [RemoteOK Jobs Scraper](https://apify.com/lentic_clockss/remoteok-all-jobs-scraper)
- [SEEK Jobs Scraper](https://apify.com/lentic_clockss/seek-scraper)
- [Upwork Jobs Scraper](https://apify.com/lentic_clockss/upwork-jobs-scraper)

#### Real Estate

- [Zillow & Zumper Scraper](https://apify.com/lentic_clockss/us-real-estate-scraper)
- [Realtor.com Scraper](https://apify.com/lentic_clockss/realtor-com-scraper)
- [99.co Scraper](https://apify.com/lentic_clockss/ninetynine-co-sg-scraper)
- [Realtor.com Agents Scraper](https://apify.com/lentic_clockss/realtor-com-agents-scraper)
- [Apartments.com Rental Scraper](https://apify.com/lentic_clockss/apartments-com-rental-scraper)
- [Bayut Scraper](https://apify.com/lentic_clockss/bayut-uae-scraper)
- [Craigslist Housing Scraper](https://apify.com/lentic_clockss/craigslist-housing-scraper)
- [Daft.ie Scraper](https://apify.com/lentic_clockss/daft-property-scraper)
- [Dot Property Scraper](https://apify.com/lentic_clockss/dot-property-th-scraper)
- [FINN.no Scraper](https://apify.com/lentic_clockss/finn-scraper)
- [Funda Scraper](https://apify.com/lentic_clockss/funda-scraper)
- [Hepsiemlak Scraper](https://apify.com/lentic_clockss/hepsiemlak-scraper)
- [Idealista Scraper](https://apify.com/lentic_clockss/idealista-scraper)
- [Immobiliare.it Scraper](https://apify.com/lentic_clockss/immobiliare-property-scraper)
- [ImmoScout24 Scraper](https://apify.com/lentic_clockss/immobilienscout24-scraper)
- [Naver Land Scraper](https://apify.com/lentic_clockss/naver-land-scraper)
- [OpenSooq Scraper](https://apify.com/lentic_clockss/opensooq-real-estate-scraper)
- [Otodom Scraper](https://apify.com/lentic_clockss/otodom-scraper)
- [Property Finder Scraper](https://apify.com/lentic_clockss/property-finder-uae-scraper)
- [PropertyGuru Scraper](https://apify.com/lentic_clockss/propertyguru-sg-scraper)
- [realestate.com.au Scraper](https://apify.com/lentic_clockss/realestate-com-au-scraper)
- [Realtor.ca Scraper](https://apify.com/lentic_clockss/realtor-ca-scraper)
- [Rightmove Scraper](https://apify.com/lentic_clockss/rightmove-property-scraper)
- [SeLoger Scraper](https://apify.com/lentic_clockss/seloger-property-scraper)
- [SUUMO Scraper](https://apify.com/lentic_clockss/suumo-property-scraper)
- [Zillow Group Scraper](https://apify.com/lentic_clockss/zillow-group-scraper)

#### E-commerce

- [Shopee Search Scraper](https://apify.com/lentic_clockss/shopee-search-scraper)
- [E-commerce Scraper](https://apify.com/lentic_clockss/ecommerce-scraper)
- [1688 Global Product Search Scraper](https://apify.com/lentic_clockss/1688-global-scraper)
- [Allegro Scraper](https://apify.com/lentic_clockss/allegro-scraper)
- [Amazon Search Scraper](https://apify.com/lentic_clockss/amazon-search-results-collector)
- [ASOS Product Scraper](https://apify.com/lentic_clockss/asos-scraper)
- [Cdiscount Product Scraper](https://apify.com/lentic_clockss/cdiscount-scraper)
- [Costco Product Scraper](https://apify.com/lentic_clockss/costco-scraper)
- [Coupang Product Scraper](https://apify.com/lentic_clockss/coupang-scraper)
- [Etsy Scraper](https://apify.com/lentic_clockss/etsy-scraper)
- [Lazada Scraper](https://apify.com/lentic_clockss/lazada-ph-search-results-collector)
- [MercadoLibre Scraper](https://apify.com/lentic_clockss/mercadolibre-scraper)
- [Mercari Japan Scraper](https://apify.com/lentic_clockss/mercari-scraper)
- [Rakuten Japan Scraper](https://apify.com/lentic_clockss/rakuten-scraper)
- [SHEIN Product Scraper](https://apify.com/lentic_clockss/shein-scraper)
- [Target Product Scraper](https://apify.com/lentic_clockss/target-scraper)
- [Temu Product Scraper](https://apify.com/lentic_clockss/temu-scraper)
- [Walmart Product Scraper](https://apify.com/lentic_clockss/walmart-scraper)

#### Travel & Stays

- [Booking.com & Airbnb Scraper](https://apify.com/lentic_clockss/booking-airbnb-scraper)
- [Agoda Scraper](https://apify.com/lentic_clockss/agoda-scraper)
- [Airbnb Listings Scraper](https://apify.com/lentic_clockss/airbnb-listings-scraper)
- [Booking.com Hotels Scraper](https://apify.com/lentic_clockss/booking-hotels-scraper)
- [Despegar Scraper](https://apify.com/lentic_clockss/despegar-scraper)
- [Expedia Scraper](https://apify.com/lentic_clockss/expedia-scraper)
- [Traveloka Scraper](https://apify.com/lentic_clockss/traveloka-scraper)
- [Travelstart Flights Scraper](https://apify.com/lentic_clockss/travelstart-scraper)
- [Trip.com Scraper](https://apify.com/lentic_clockss/trip-com-scraper)
- [TripAdvisor Scraper](https://apify.com/lentic_clockss/tripadvisor-scraper)

#### Social & Content

- [TikTok Scraper](https://apify.com/lentic_clockss/tiktok-scraper)
- [Reddit Scraper](https://apify.com/lentic_clockss/reddit-scraper)
- [YouTube Shorts Scraper](https://apify.com/lentic_clockss/youtube-shorts-scraper)
- [YouTube Research Scraper](https://apify.com/lentic_clockss/youtube-research-scraper)
- [Hacker News Scraper](https://apify.com/lentic_clockss/hacker-news-scraper)

#### Ads Intelligence

- [Facebook Ad Library Scraper](https://apify.com/lentic_clockss/facebook-ad-library-scraper)
- [Google Ads Transparency VN](https://apify.com/lentic_clockss/google-ads-transparency-center-vn)
- [TikTok Ads Scraper](https://apify.com/lentic_clockss/tiktok-ads-top-ads-actor)

#### Local & Maps

- [Google Maps Scraper](https://apify.com/lentic_clockss/google-maps-scraper)

#### General Tools

- [Stealth Web Scraper](https://apify.com/lentic_clockss/stealth-web-scraper)
- [Email Risk Validator](https://apify.com/lentic_clockss/email-risk-validator)
- [Phone Number Intelligence](https://apify.com/lentic_clockss/phone-number-intelligence)

→ Browse the full profile: [apify.com/lentic\_clockss](https://apify.com/lentic_clockss)

# Actor input Schema

## `mode` (type: `string`):

search | search\_shops | category | listing | shop | categories | featured

## `shipTo` (type: `string`):

ISO-2 ship-to / regional prefs (currency & language). ROW = fallback USD.

## `query` (type: `string`):

Keyword for mode=search or search\_shops

## `searchQueries` (type: `array`):

Optional list; first used if query empty

## `categorySlug` (type: `string`):

Top-level or nested path under /c/ e.g. jewelry or jewelry/necklaces

## `listingId` (type: `string`):

Numeric listing id for mode=listing

## `shopName` (type: `string`):

/shop/{name} for mode=shop

## `featuredPath` (type: `string`):

Path for mode=featured e.g. /featured/hub or /r/curated/...

## `startUrls` (type: `array`):

Optional Etsy URLs (search, /c/, /listing/, /shop/, /featured/, /r/curated/)

## `order` (type: `string`):

Verified URL codes only: most\_relevant (omit) | price\_asc | price\_desc | date\_desc

## `p` (type: `integer`):

SERP page number (page=N)

## `maxResults` (type: `integer`):

Maximum rows to return (free plan capped at 200)

## `enrichDetails` (type: `boolean`):

Open PDPs for JSON-LD + shipping/sales/images enrichment

## `priceMin` (type: `number`):

Optional min filter (URL min=)

## `priceMax` (type: `number`):

Optional max filter (URL max=)

## `instantDownload` (type: `boolean`):

true/false → instant\_download=; omit for all

## `shipsFrom` (type: `string`):

Ships-from / location facet (locationQuery)

## `readyToShip` (type: `boolean`):

Short EDD window filter (edd=1)

## `starSeller` (type: `boolean`):

is\_star\_seller=true

## `freeShipping` (type: `boolean`):

free\_shipping=true

## `language` (type: `string`):

Optional language preference override

## `currency` (type: `string`):

Optional currency preference override (USD, GBP, …)

## `workerBaseUrl` (type: `string`):

Optional HTTPS allowlisted Cloud Run URL override

## Actor input object example

```json
{
  "mode": "search",
  "shipTo": "US",
  "order": "most_relevant",
  "p": 1,
  "maxResults": 50,
  "enrichDetails": false
}
```

# Actor output Schema

## `results` (type: `string`):

Normalized Etsy listing / shop / category rows from the default dataset.

## `runSummary` (type: `string`):

Structured summary record stored in the default key-value store.

## `inputEcho` (type: `string`):

Normalized input saved at run start.

## `errorSummary` (type: `string`):

Present when a failed run stores structured terminal error information.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("lentic_clockss/etsy-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("lentic_clockss/etsy-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call lentic_clockss/etsy-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lentic_clockss/etsy-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/acts/MYl69tvvJahafC2He/builds/ZgBKCLRU0GImNWbuA/openapi.json