# ๐ฐ Etsy Scraper โ Product Research, Tags, Prices & Sales (`yumitori/etsy-search-scraper`) Actor
Etsy product research without the guesswork. Search any keyword and get every listing's tags, prices, views and demand โ plus each shop's sales. The Etsy data the official API won't give you. No API key, no login, no extension.
- **URL**: https://apify.com/yumitori/etsy-search-scraper.md
- **Developed by:** [Yakugusa Yumitori](https://apify.com/yumitori) (community)
- **Categories:** E-commerce
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet
## Pricing
$6.00 / 1,000 results
This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
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.
In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md):
```bash
pip install apify-client
```
In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):
````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash
In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md).
If your project is in a different language, use 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 โ Product Research, Tags, Prices & Sales Data
**The pay-per-result alternative to eRank, EverBee, Marmalead, Sale Samurai and EtsyHunt** โ raw Etsy data instead of a $10โ30/month dashboard. No API key, no login, no Chrome extension. Structured data for product research, ChatGPT/Claude, spreadsheets, and analytics pipelines.
*Live output for `stickers` โ every ranking listing with its views, views/day, favorites, favorite-rate, price, quantity and age. Sort any column; the winners rise to the top.*
---
### ๐ AI tools can't see Etsy โ this scraper is their eyes
Etsy sellers run product research through ChatGPT, Claude, Gemini, and Copilot every day โ but those models have **no real-time access to Etsy**. They guess from stale training data. This **Etsy scraper** returns live marketplace data you feed straight into your AI tool, spreadsheet, or pipeline.
Type a keyword โ get every ranking listing with its **tags, price, views, favorites, demand velocity, and the shop's sales.** In seconds, not an afternoon of copy-paste.
---
### ๐ Etsy product research in one row per listing
| Field | What it tells you |
|---|---|
| `title` | The keywords winners actually put in titles |
| `tags` | Up to 13 tags โ the SEO strategy hidden from Etsy's UI |
| `price` ยท `quantity` ยท `age_days` | Pricing sweet spots, stock, proven-winner age |
| `views` | โก Listing views โ hidden from everyone but the shop owner |
| `views_per_day` | โก Velocity โ what's trending *right now* vs coasting |
| `favorers` ยท `fav_rate_pct` | Favorites, and favorites รท views (buyer intent) |
| `who_made` ยท `made_in` ยท `partner_name` ยท `partner_location` | Handmade vs manufactured, and who makes it |
| `shop_name` ยท `shop_sales` ยท `shop_followers` ยท `shop_rating` | Who's winning the niche + their totals |
> ๐ก **Search like a shopper, not a seller.** Etsy reads your search as **individual keywords, not one phrase** โ it pulls apart your words and matches on the pieces. So pasting a whole listing title (`Handcrafted Personalized Ceramic Coffee Mug Custom Name Giftโฆ`) confuses the match and returns almost nothing. Use the **1โ3 words a buyer would actually type** (`personalized mug`).
---
### ๐ท๏ธ Extract the tags top sellers rank for
Etsy hides a listing's tags from the page โ but they're the exact SEO strategy behind every winner. This works as an **Etsy tag extractor**: pull the up-to-13 `tags` off the highest-demand listings for your keyword and see the vocabulary Etsy's algorithm is actually rewarding โ no guessing, no separate keyword tool.
---
### ๐ Spot what's trending โ and what's already winning
The two questions every seller Googles โ *"what's trending on Etsy"* and *"what are the best sellers"* โ both come straight out of one run, from live data instead of a stale trends page:
- **Trending right now** โ sort by `views_per_day`. A listing pulling 100+ views a day is heating up *this week*, even if its lifetime total is still small. That's the early signal before a niche gets crowded.
- **Proven best sellers** โ sort by `views` and `shop_sales`. High lifetime views on an older listing (`age_days`) is a product that's been converting for months โ a real winner, not a fluke.
Run any keyword and the climbers and the established winners sit side by side: the trend, and the proof it pays.
---
### ๐ฏ Who uses this
- **๐ค AI-powered sellers** โ feed real competitor data into ChatGPT/Claude instead of a guess. Paste results, ask *"what patterns and gaps do you see?"*
- **๐ Product researchers** โ sort by `views_per_day` for what's trending, `fav_rate_pct` for what buyers want, `shop_sales` for whether the niche pays.
- **๐ Print-on-demand & dropshippers** โ spot what's genuinely handmade vs manufactured, and read the declared production partner.
- **๐ป Developers** โ clean JSON with computed metrics, ready for databases, ML, or AI pipelines.
---
### ๐ Example output
*Live output for `candles` (84k monthly searches) โ one row per listing. Here's a real top-demand result as raw JSON:*
```json
{
"rank": 6,
"title": "Soy Candle Wax for Candle Making, Kit Includes Premium Natural Soy Wax Flakes, Cotton Candle Wicks, Wick Stickers",
"views": 164350,
"views_per_day": 88.1,
"favorers": 6615,
"fav_rate_pct": 4.02,
"price": 34.99,
"age_days": 1864,
"who_made": "I made it",
"tags": "Candle making kit, Candle supplies, DIY Candles, Soy Wax, Candle Wicks, โฆ",
"shop_name": "DIYcraftZone",
"shop_sales": 13987,
"shop_rating": 4.73,
"search_term": "candles"
}
````
And here's the other side โ a top-demand `dad hat` listing that *reads* like a cute niche gift, but the data reveals its supply chain. It's declared as made by another company, and `partner_name` + `partner_location` name the factory:
```json
{
"rank": 3,
"title": "Dog Dad Hat, Embroidered Baseball Cap, Gift for Dog Lovers",
"price": 14.99,
"views": 76309,
"views_per_day": 34.1,
"favorers": 4072,
"fav_rate_pct": 5.34,
"who_made": "Another company / person",
"made_in": "Zhejiang, China",
"partner_name": "GoldtopHat",
"partner_location": "Zhejiang, China",
"tags": "dog dad hat, dog dad gift, dog lover hat, embroidered hat, baseball cap, pet dad gift, fathers day gift, โฆ",
"shop_name": "HatphileMade",
"shop_sales": 24489,
"search_term": "dad hat"
}
```
> โ ๏ธ **A blank production-partner field is not proof of "handmade."** Etsy requires sellers to declare a partner only when someone other than the seller made the item โ a blank means they didn't disclose one. We show exactly what was declared (like the Zhejiang factory above); you decide what an empty column means.
***
### ๐ซ Why not the official Etsy API?
Most sellers Google "**etsy api**" looking for data โ then hit a wall. Here's why this is easier:
| | This scraper | Official Etsy API |
|---|:---:|:---:|
| API key / OAuth / app approval | **none** | required |
| Search Etsy by keyword across shops | โ
| โ *not supported* |
| Daily request limit | **none to manage** | ~1,000/day until Etsy grants commercial approval |
| Setup | keyword in, data out | dev account + code |
| Runs from ChatGPT / n8n / Sheets | โ
| โ ๏ธ you build it |
The official API can't even search Etsy by keyword. This can.
***
### ๐ธ A no-subscription alternative to EverBee, eRank, Marmalead, Sale Samurai & EtsyHunt
**EverBee**, **eRank**, **Marmalead**, **Sale Samurai**, **Alura**, and **EtsyHunt** are $10โ30/month dashboards. This is a **pay-per-result alternative** โ run it only when you need it, and pipe the raw Etsy data straight into your own spreadsheets, database, or AI.
| | This scraper | eRank / EverBee / Marmalead |
|---|:---:|:---:|
| Pricing | **pay per result** (no subscription) | $10โ30 / month |
| Chrome extension / account | **neither** | account (EverBee needs an extension) |
| Raw data export (JSON / CSV) | โ
| โ ๏ธ dashboard-first |
| Feeds ChatGPT / Claude / n8n / API | โ
| โ |
| Competitor views & shop sales | โ
| โ
|
| Run it in an automation / on a schedule | โ
| โ |
If you searched *"eRank alternative,"* *"EverBee alternative,"* or *"EverBee vs eRank"* โ this is the no-subscription, raw-data option: the same competitor and product-research data, on your terms.
***
### ๐ Use it with ChatGPT / Claude, n8n, or Sheets
Run it, export the CSV, and paste into ChatGPT with a prompt like *"Here's live Etsy data for 'personalized mug' โ top listings with views, favorites, price and tags. What tags am I missing and is my price in range?"* Or connect the actor directly via Apify's [MCP server](https://docs.apify.com/integrations/mcp), automate with the [Apify n8n node](https://docs.apify.com/platform/integrations/n8n), or one call:
```bash
curl -X POST "https://api.apify.com/v2/acts/YOUR_USERNAME~etsy-search-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
-H "Content-Type: application/json" -d '{ "searchTerms": ["personalized mug"], "maxResultsPerTerm": 100 }'
```
Or drive it from **Python** โ no Etsy API, no scraping code to maintain:
```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_TOKEN")
run = client.actor("YOUR_USERNAME/etsy-search-scraper").call(
run_input={"searchTerms": ["personalized mug"], "maxResultsPerTerm": 100}
)
for row in client.dataset(run["defaultDatasetId"]).iterate_items():
print(row["title"], row["views"], row["views_per_day"], row["price"])
```
***
### ๐งฐ More Etsy research tools
- [**Etsy Keyword Research + Reverse Keyword Tool**](https://apify.com/yumitori/etsy-keyword-tool) โ score keywords on Etsy's own live demand data
- [**Etsy Dropshipping & POD Supplier Finder**](https://apify.com/yumitori/etsy-manufacturer-finder) โ who actually makes a product
- [**Etsy Shop & Seller Scraper**](https://apify.com/yumitori/etsy-shop-finder) โ find shops by niche in bulk
- [**Etsy Listing Scraper โ Live Carts & Pricing**](https://apify.com/yumitori/etsy-listing-inspector) โ deep per-listing intel
***
### FAQ
**Do I need an Etsy account, API key, or login?** No โ none of them. You enter a keyword and get data back. No OAuth, no developer account, no Chrome extension.
**How fresh is the data?** Live. Views, favorites, prices, and shop sales are pulled at the moment the run happens โ nothing is cached between runs.
**How many results can I get per keyword?** Up to **300** (three pages). Etsy stops serving *new unique* listings past ~3 pages and starts recycling ones you've already seen, so 300 is the real ceiling of unique results per term. To cover more of a market, use more specific keywords.
**Can I search multiple keywords in one run?** Yes โ add as many as you want; each is scraped separately and tagged with its `search_term`.
**My results are thin โ why?** Your keyword is too long. Etsy matches on individual words, not your whole phrase, so a full listing title returns almost nothing. Use the 1โ3 words a buyer would type (`personalized mug`, not the whole title).
**Is `shop_sales` real or estimated?** Real โ it's each shop's true lifetime sales number (the one on their shop page), pulled for every result at once so you don't click 50 shops. It is **not** an estimate like the subscription tools use. *Per-listing* sales aren't exposed by Etsy to anyone; use `views_per_day` and `favorers` as the per-listing demand read.
**Can I see a listing's views?** Yes. Etsy hides listing views from the public (only the shop owner sees them), but this returns them for every result โ one of the few numbers you genuinely can't get by browsing.
**Can I find trending Etsy products?** Yes โ sort the results by `views_per_day`. A listing gaining 100+ views a day is climbing right now, so it surfaces what's heating up this week rather than what topped the charts a year ago.
**Can I find Etsy best sellers for a keyword?** Yes โ sort by `views` and `shop_sales`. High lifetime views on an older listing (`age_days`) marks a proven seller that's been converting for months, so you can separate real winners from one-off spikes.
**My Etsy sales dropped โ can this help?** It can show you the competitive picture: run your main keywords and see who's ranking now, their prices, tags, and demand. It won't diagnose your own shop's analytics (Etsy only shows those to you), but it tells you what the current winners are doing differently.
**Can I use it from Python?** Yes โ call it with the `apify-client` package (see the Python snippet above). You get structured rows with computed metrics, no scraping or Etsy API code to maintain.
**Can I get competitor tags?** Yes โ the `tags` field returns the up-to-13 tags each listing ranks for, which Etsy hides from the listing page. It works as an Etsy tag extractor.
**Can I filter the results?** Yes โ by category, shop country, price range, listing age / date, minimum views or favorites, and who-made.
**What export formats are supported?** JSON, CSV, Excel, XML, HTML, and RSS โ plus the live API endpoint and Google Sheets sync.
**Can I use it with ChatGPT or Claude?** Yes โ export the results and paste them into your AI with a prompt, or connect the actor directly via Apify's MCP server so the AI runs it for you. See the *Use it with ChatGPT / Claude* section above.
**Can I automate it or run it on a schedule?** Yes โ schedule runs in Apify and pipe the output into Google Sheets, Airtable, Notion, a database, or Slack via n8n, Make, Zapier, or webhooks.
**Does it work for print-on-demand and dropshipping research?** Yes. Sort by demand to spot winning products, and read `who_made` + `partner_name` + `partner_location` to see what's genuinely handmade versus manufactured.
**Which countries does it cover?** You can restrict to a seller country (US, UK, CA, AU, and more) with the shop-location filter, or leave it open for all countries.
**Why are the `partner_name` / `partner_location` columns empty on most listings?** Because most sellers don't declare a production partner. Etsy only requires it when someone other than the seller made the item โ a blank field means it wasn't disclosed, not that the item is definitely handmade.
**Does it collect reviews or buyer data?** No. It returns shop-level rating and public listing data only โ no individual reviews text, no buyer information, no private or login-gated data.
**Will I get blocked, or do I need proxies?** No โ proxying, retries, and blocking are handled for you. You just enter a keyword.
**How much does it cost?** Pay-per-result โ you're only charged for the listings you receive, with no monthly subscription. See the **Pricing** tab for the current rate.
**How is this different from eRank, EverBee, or Marmalead?** Those are monthly-subscription dashboards (often extension-locked). This is a pay-per-result tool that hands you the **raw** data to pipe into your own spreadsheets, database, or AI โ no subscription, no extension, no lock-in.
***
### โ๏ธ Disclaimer
This is an independent tool and is **not affiliated with, endorsed by, sponsored by, or connected to Etsy, Inc.** in any way. "Etsy" and all related names, marks, and logos are trademarks of Etsy, Inc., used here only for descriptive and comparison purposes (nominative fair use). All third-party product names mentioned โ including eRank, EverBee, Marmalead, Sale Samurai, Alura, and EtsyHunt โ are trademarks of their respective owners and are referenced solely for comparison.
This actor collects only **publicly available data** shown on Etsy's public search and listing pages โ the same information any visitor can see in a browser. It does **not** access private accounts, buyer information, messages, payment data, or any login-gated content, and it collects **no personal data of individuals**.
You are solely responsible for how you use the data and for complying with all applicable laws and terms โ including **Etsy's Terms of Service**, and data-protection regulations such as **GDPR** and **CCPA** โ in your own jurisdiction and use case. Use this tool for legitimate research and analytics purposes only.
***
etsy scraper ยท etsy product research ยท etsy api ยท etsy scraper python ยท etsy scraper api ยท etsy tags ยท etsy tag extractor ยท etsy seo ยท scrape etsy ยท ecommerce scraper ยท marketplace scraper ยท etsy competitors ยท etsy competitor analysis ยท etsy trends ยท trending on etsy ยท etsy trending products ยท etsy best sellers ยท best selling items on etsy ยท etsy niche finder ยท etsy dropshipping ยท everbee alternative ยท erank alternative ยท marmalead alternative ยท sale samurai alternative ยท etsyhunt alternative ยท alura alternative ยท no-code etsy scraper ยท etsy data extraction ยท print on demand etsy ยท what to sell on etsy ยท etsy sales down
# Actor input Schema
## `searchTerms` (type: `array`):
One or more keywords to search Etsy for. Each term is paged independently.
## `maxResultsPerTerm` (type: `integer`):
How many listings to collect per search term (100 per page, max 3 pages = 300). Etsy recycles the same listings beyond ~3 pages, so 300 is the real unique-result ceiling per keyword.
## `sortOn` (type: `string`):
Etsy relevance ('score' = default search order), newest, price, or last-updated.
## `sortOrder` (type: `string`):
Descending (high to low) or ascending (low to high) for the selected sort field.
## `sortResultsBy` (type: `string`):
How the final results are ordered in the dataset. The 'Sort by' above controls WHICH listings Etsy returns; this re-orders what you got (e.g. put the highest-view listings first). Applied after collection.
## `minPrice` (type: `integer`):
Minimum price in whole units of the shop currency (e.g. 10 = $10). Leave empty for no minimum.
## `maxPrice` (type: `integer`):
Maximum price in whole units of the shop currency. Leave empty for no maximum.
## `taxonomyId` (type: `string`):
Restrict to an Etsy category (seller taxonomy). Type to search. Leave as Any for all categories.
## `shopLocation` (type: `string`):
Restrict to sellers in a country (native Etsy filter). Leave as Any for all countries.
## `createdAfter` (type: `string`):
Only listings first created on/after this date. Tip: pair with Sort by = Newest for a fast run.
## `createdBefore` (type: `string`):
Only listings first created on/before this date.
## `updatedWithinDays` (type: `integer`):
Only listings edited / re-listed in the last N days (e.g. 7 = refreshed this week). Pair with Sort by = Recently updated for a fast run.
## `minViews` (type: `integer`):
Only listings with at least this many all-time views (demand floor).
## `minFavorers` (type: `integer`):
Only listings with at least this many favorites.
## `whoMade` (type: `string`):
Filter by Etsy's who\_made field.
## `includeImages` (type: `boolean`):
Add the main listing photo as a column (rendered as a thumbnail). Fetched in cheap batches of 100. On by default.
## `includeDescription` (type: `boolean`):
Add the listing's full description text as a column. Off by default because descriptions are long and bloat the CSV.
## `raw` (type: `boolean`):
Push the full untouched Etsy listing object instead of the clean flat record.
## Actor input object example
```json
{
"searchTerms": [
"resin coaster"
],
"maxResultsPerTerm": 300,
"sortOn": "score",
"sortOrder": "down",
"sortResultsBy": "",
"taxonomyId": "",
"shopLocation": "",
"whoMade": "any",
"includeImages": true,
"includeDescription": false,
"raw": false
}
```
# 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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"searchTerms": [
"resin coaster"
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("yumitori/etsy-search-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = { "searchTerms": ["resin coaster"] }
# Run the Actor and wait for it to finish
run = client.actor("yumitori/etsy-search-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 '{
"searchTerms": [
"resin coaster"
]
}' |
apify call yumitori/etsy-search-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=yumitori/etsy-search-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "๐ฐ Etsy Scraper โ Product Research, Tags, Prices & Sales",
"description": "Etsy product research without the guesswork. Search any keyword and get every listing's tags, prices, views and demand โ plus each shop's sales. The Etsy data the official API won't give you. No API key, no login, no extension.",
"version": "0.1",
"x-build-id": "WI2ZeaA1RbGNV5eiN"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/yumitori~etsy-search-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-yumitori-etsy-search-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
},
"/acts/yumitori~etsy-search-scraper/runs": {
"post": {
"operationId": "runs-sync-yumitori-etsy-search-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor and returns information about the initiated run in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/runsResponseSchema"
}
}
}
}
}
}
},
"/acts/yumitori~etsy-search-scraper/run-sync": {
"post": {
"operationId": "run-sync-yumitori-etsy-search-scraper",
"x-openai-isConsequential": false,
"summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
"tags": [
"Run Actor"
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/inputSchema"
}
}
}
},
"parameters": [
{
"name": "token",
"in": "query",
"required": true,
"schema": {
"type": "string"
},
"description": "Enter your Apify token here"
}
],
"responses": {
"200": {
"description": "OK"
}
}
}
}
},
"components": {
"schemas": {
"inputSchema": {
"type": "object",
"required": [
"searchTerms"
],
"properties": {
"searchTerms": {
"title": "Search terms",
"type": "array",
"description": "One or more keywords to search Etsy for. Each term is paged independently.",
"items": {
"type": "string"
}
},
"maxResultsPerTerm": {
"title": "Max results per term",
"minimum": 1,
"maximum": 300,
"type": "integer",
"description": "How many listings to collect per search term (100 per page, max 3 pages = 300). Etsy recycles the same listings beyond ~3 pages, so 300 is the real unique-result ceiling per keyword.",
"default": 300
},
"sortOn": {
"title": "Sort by",
"enum": [
"score",
"created",
"price",
"updated"
],
"type": "string",
"description": "Etsy relevance ('score' = default search order), newest, price, or last-updated.",
"default": "score"
},
"sortOrder": {
"title": "Sort order",
"enum": [
"down",
"up"
],
"type": "string",
"description": "Descending (high to low) or ascending (low to high) for the selected sort field.",
"default": "down"
},
"sortResultsBy": {
"title": "Order results by",
"enum": [
"",
"views",
"views_per_day",
"favorers",
"shop_sales",
"price_high",
"price_low"
],
"type": "string",
"description": "How the final results are ordered in the dataset. The 'Sort by' above controls WHICH listings Etsy returns; this re-orders what you got (e.g. put the highest-view listings first). Applied after collection.",
"default": ""
},
"minPrice": {
"title": "Min price",
"minimum": 0,
"type": "integer",
"description": "Minimum price in whole units of the shop currency (e.g. 10 = $10). Leave empty for no minimum."
},
"maxPrice": {
"title": "Max price",
"minimum": 0,
"type": "integer",
"description": "Maximum price in whole units of the shop currency. Leave empty for no maximum."
},
"taxonomyId": {
"title": "Category",
"enum": [
"",
"6980",
"12380",
"6714",
"877",
"12620",
"12368",
"2914",
"1",
"133",
"2024",
"7051",
"106",
"264",
"1585",
"1318",
"2845",
"6541",
"6542",
"6546",
"6307",
"6936",
"2172",
"6098",
"2848",
"914",
"283",
"6468",
"920",
"1121",
"6759",
"6250",
"6057",
"6838",
"1665",
"1136",
"2072",
"6782",
"6086",
"1586",
"1180",
"1262",
"1242",
"1290",
"6704",
"893",
"12643",
"1360",
"12189",
"2355",
"2070",
"6866",
"1182",
"184",
"17",
"317",
"66",
"335",
"2097",
"129",
"6756",
"12493",
"6862",
"1865",
"49",
"1868",
"452",
"2160",
"826",
"12313",
"7047",
"6906",
"6321",
"200",
"1263",
"1581",
"2910",
"7046",
"377",
"135",
"207",
"403",
"1332",
"136",
"12654",
"12652",
"12655",
"7043",
"1412",
"867",
"2044",
"11265",
"132",
"6280",
"931",
"609",
"6303",
"2322",
"6514",
"12647",
"7064",
"6961",
"1537",
"1333",
"6745",
"1561",
"2003",
"43",
"1232",
"1194",
"2014",
"1097",
"1334",
"1055",
"309",
"1183",
"1528",
"6658",
"7019",
"220",
"1863",
"2365",
"2366",
"1166",
"1658",
"2037",
"199",
"210",
"310",
"1915",
"901",
"311",
"1916",
"312",
"904",
"900",
"902",
"11650",
"906",
"1917",
"903",
"11647",
"84",
"833",
"832",
"6636",
"1699",
"905",
"9181",
"6287",
"6288",
"6296",
"6985",
"6954",
"9190",
"1195",
"1218",
"6238",
"9205",
"981",
"284",
"2397",
"9124",
"12455",
"912",
"911",
"968",
"969",
"12396",
"1352",
"1890",
"6531",
"12459",
"6081",
"1184",
"1185",
"6770",
"3",
"6278",
"4",
"6095",
"2",
"12369",
"982",
"990",
"6803",
"1219",
"2087",
"201",
"2356",
"2357",
"1563",
"11118",
"6840",
"6538",
"1154",
"2392",
"6672",
"336",
"12611",
"1361",
"1956",
"1417",
"1957",
"1264",
"932",
"116",
"6314",
"325",
"1265",
"6797",
"9188",
"913",
"6242",
"467",
"11112",
"2101",
"12642",
"2058",
"512",
"378",
"554",
"249",
"1554",
"6655",
"1478",
"2343",
"2342",
"6801",
"2071",
"2382",
"1181",
"313",
"379",
"11113",
"6487",
"6771",
"50",
"6442",
"7057",
"6956",
"6087",
"2036",
"6812",
"1122",
"328",
"329",
"6441",
"12441",
"337",
"12202",
"6587",
"983",
"330",
"12478",
"331",
"332",
"324",
"6345",
"323",
"991",
"827",
"11117",
"11116",
"539",
"1514",
"1431",
"1432",
"6525",
"6899",
"12613",
"1057",
"1058",
"6668",
"6370",
"11120",
"6624",
"603",
"10783",
"11253",
"51",
"12616",
"1565",
"185",
"1544",
"1044",
"2019",
"1255",
"1829",
"1827",
"462",
"6671",
"1167",
"1786",
"6371",
"2371",
"375",
"1430",
"2119",
"2121",
"1193",
"6277",
"514",
"6971",
"515",
"360",
"933",
"12224",
"1656",
"1243",
"2079",
"11261",
"11257",
"1666",
"169",
"1828",
"9196",
"941",
"250",
"6769",
"1201",
"1929",
"934",
"9336",
"1777",
"142",
"1778",
"6216",
"233",
"6602",
"314",
"6845",
"1927",
"922",
"6269",
"974",
"271",
"1583",
"881",
"1319",
"221",
"2310",
"2919",
"6957",
"2088",
"6994",
"6882",
"1304",
"192",
"1045",
"6524",
"6720",
"6270",
"1168",
"836",
"835",
"6240",
"6381",
"513",
"1395",
"2308",
"2821",
"1046",
"1660",
"9121",
"935",
"354",
"6919",
"1220",
"839",
"866",
"868",
"1698",
"1697",
"869",
"840",
"838",
"516",
"1566",
"12629",
"2213",
"2789",
"2792",
"2212",
"2791",
"1661",
"1004",
"2214",
"940",
"9183",
"272",
"6083",
"6898",
"2346",
"6897",
"6669",
"6252",
"6217",
"7",
"1836",
"1895",
"12419",
"12420",
"12421",
"1894",
"846",
"2665",
"942",
"1555",
"6578",
"457",
"6975",
"6375",
"1871",
"1870",
"1034",
"12315",
"453",
"1418",
"7028",
"2399",
"11114",
"12314",
"12358",
"12348",
"12360",
"847",
"6537",
"6545",
"1869",
"1336",
"1074",
"9119",
"1137",
"1196",
"6283",
"193",
"1221",
"2225",
"992",
"6407",
"6760",
"6753",
"1098",
"1059",
"1934",
"12186",
"1204",
"2195",
"202",
"2925",
"76",
"6409",
"834",
"1197",
"1222",
"6426",
"6239",
"194",
"2388",
"12213",
"6530",
"6822",
"2389",
"338",
"2391",
"6907",
"6682",
"943",
"1223",
"12210",
"12479",
"12212",
"1273",
"6109",
"1460",
"2208",
"11266",
"134",
"2539",
"7004",
"1244",
"6911",
"6683",
"2039",
"6281",
"6350",
"9186",
"6835",
"924",
"919",
"1320",
"6844",
"1205",
"1999",
"1016",
"1810",
"1433",
"6219",
"12437",
"11347",
"6279",
"374",
"137",
"1202",
"380",
"925",
"1206",
"157",
"1060",
"1061",
"952",
"993",
"951",
"894",
"12630",
"2340",
"2314",
"1909",
"12602",
"12371",
"68",
"1035",
"318",
"11299",
"6592",
"2852",
"2171",
"2781",
"1771",
"2850",
"67",
"117",
"2808",
"6751",
"339",
"7021",
"107",
"6937",
"12466",
"340",
"1780",
"12469",
"6733",
"851",
"850",
"251",
"6363",
"956",
"218",
"1337",
"2027",
"1266",
"6284",
"11355",
"994",
"12190",
"6574",
"6543",
"11335",
"1005",
"6372",
"12480",
"12196",
"12191",
"341",
"6498",
"6059",
"2307",
"936",
"1036",
"1033",
"1106",
"2323",
"1362",
"6389",
"837",
"6362",
"6902",
"6929",
"6443",
"2051",
"2379",
"6413",
"604",
"517",
"141",
"143",
"6",
"1761",
"12644",
"1768",
"1434",
"1760",
"10",
"381",
"998",
"1935",
"195",
"1636",
"11124",
"1462",
"1063",
"6551",
"12379",
"562",
"6408",
"2642",
"6955",
"10842",
"85",
"11560",
"11556",
"2057",
"2349",
"12160",
"6285",
"2909",
"86",
"6976",
"555",
"1839",
"2336",
"2381",
"87",
"158",
"6728",
"1152",
"1224",
"1207",
"1198",
"6763",
"52",
"57",
"53",
"937",
"6854",
"234",
"12639",
"1919",
"12638",
"12443",
"2182",
"1178",
"6603",
"9133",
"2325",
"1037",
"6559",
"6318",
"1038",
"12394",
"6316",
"2364",
"186",
"2033",
"6473",
"1445",
"1208",
"12627",
"855",
"1064",
"1657",
"6241",
"12491",
"1003",
"1640",
"12446",
"222",
"6064",
"6586",
"12489",
"2913",
"1018",
"12628",
"12207",
"273",
"1403",
"1305",
"12426",
"1000",
"2813",
"12397",
"1793",
"1001",
"985",
"12203",
"149",
"11502",
"12438",
"2184",
"11488",
"203",
"2350",
"1556",
"2351",
"2041",
"6718",
"6594",
"9187",
"77",
"12318",
"2078",
"1043",
"975",
"973",
"976",
"1047",
"2895",
"6750",
"1083",
"6675",
"2280",
"6920",
"1138",
"1997",
"12162",
"12195",
"861",
"862",
"1419",
"6067",
"12165",
"1019",
"6245",
"6793",
"1587",
"1604",
"6792",
"1605",
"1606",
"1607",
"1584",
"1612",
"2393",
"1931",
"12237",
"12450",
"2107",
"780",
"1998",
"2289",
"9325",
"1964",
"783",
"75",
"6576",
"1463",
"9326",
"6677",
"12452",
"445",
"11133",
"454",
"970",
"986",
"408",
"2911",
"6861",
"6660",
"6992",
"6963",
"1054",
"12149",
"152",
"1862",
"852",
"2025",
"2406",
"2034",
"361",
"2026",
"1099",
"11346",
"6535",
"170",
"2290",
"917",
"6424",
"2901",
"6297",
"2211",
"2900",
"6290",
"12139",
"30",
"1210",
"6289",
"1203",
"6262",
"12448",
"1274",
"6700",
"6325",
"6802",
"1091",
"1608",
"825",
"865",
"6666",
"6425",
"88",
"12382",
"6988",
"12607",
"6422",
"108",
"1267",
"6291",
"9323",
"12372",
"2178",
"1245",
"6324",
"979",
"6599",
"6647",
"6398",
"6410",
"1529",
"2315",
"215",
"120",
"12481",
"296",
"6523",
"12653",
"7066",
"246",
"247",
"297",
"243",
"11358",
"12651",
"2089",
"244",
"6272",
"245",
"242",
"6451",
"6246",
"6811",
"9340",
"6757",
"248",
"6100",
"12138",
"12112",
"252",
"6788",
"298",
"11",
"300",
"301",
"150",
"1911",
"895",
"1727",
"1757",
"6697",
"11351",
"12492",
"6088",
"1348",
"6430",
"204",
"1389",
"7044",
"6747",
"89",
"9755",
"6305",
"6526",
"1123",
"6880",
"82",
"10847",
"12161",
"6865",
"130",
"69",
"6940",
"6436",
"6692",
"12408",
"10792",
"9141",
"6893",
"2063",
"6220",
"6096",
"1616",
"10797",
"1296",
"1974",
"1973",
"1108",
"12219",
"1972",
"1975",
"2398",
"1472",
"1567",
"9328",
"1568",
"1923",
"1006",
"12472",
"841",
"6333",
"11274",
"1922",
"1048",
"6521",
"1473",
"2334",
"927",
"2814",
"996",
"781",
"6625",
"6348",
"6618",
"6622",
"6800",
"1020",
"6116",
"2080",
"1124",
"6619",
"2038",
"1569",
"6646",
"1308",
"2292",
"930",
"151",
"6513",
"6304",
"2367",
"2185",
"390",
"6445",
"1968",
"6650",
"253",
"6746",
"216",
"6259",
"6257",
"6218",
"10801",
"1233",
"2047",
"12632",
"2929",
"1268",
"6274",
"6826",
"1125",
"2210",
"6863",
"944",
"6505",
"967",
"6605",
"875",
"12214",
"12617",
"2151",
"1557",
"12192",
"1553",
"1169",
"1117",
"1109",
"1110",
"12410",
"1112",
"1339",
"171",
"542",
"543",
"1211",
"6748",
"6648",
"465",
"1485",
"2122",
"484",
"1504",
"1269",
"121",
"6852",
"1257",
"12482",
"6604",
"1254",
"1664",
"1667",
"357",
"401",
"1440",
"2120",
"1791",
"1532",
"6352",
"104",
"6834",
"2782",
"2889",
"60",
"61",
"59",
"6417",
"6428",
"12445",
"12645",
"16",
"6540",
"6223",
"9116",
"2390",
"6787",
"1570",
"2086",
"1479",
"12205",
"1270",
"2931",
"109",
"1271",
"6529",
"1875",
"2809",
"6752",
"6503",
"1873",
"6652",
"2639",
"1113",
"12483",
"1261",
"2293",
"1979",
"1978",
"1114",
"6726",
"1668",
"11271",
"11269",
"11273",
"6662",
"1340",
"343",
"2015",
"2376",
"219",
"12179",
"217",
"12168",
"229",
"7020",
"1692",
"228",
"231",
"1641",
"12650",
"6114",
"7023",
"224",
"12178",
"235",
"7024",
"232",
"7025",
"226",
"2113",
"12403",
"12449",
"556",
"6684",
"1980",
"1115",
"2231",
"6706",
"260",
"12167",
"11245",
"9202",
"1617",
"6970",
"156",
"12193",
"45",
"7042",
"1860",
"11259",
"1275",
"10799",
"2043",
"11132",
"2017",
"6762",
"7069",
"138",
"6676",
"11316",
"1646",
"25",
"12649",
"7067",
"7022",
"225",
"12456",
"2644",
"2645",
"828",
"344",
"1912",
"6981",
"1446",
"2153",
"6934",
"305",
"230",
"1126",
"1960",
"958",
"957",
"1480",
"11297",
"1962",
"782",
"345",
"159",
"2377",
"1272",
"6072",
"891",
"12490",
"892",
"1002",
"2858",
"779",
"12206",
"2927",
"907",
"1849",
"382",
"12648",
"6268",
"6711",
"6273",
"1170",
"1212",
"6258",
"2010",
"2395",
"2380",
"544",
"528",
"953",
"6871",
"1533",
"1809",
"346",
"2354",
"1571",
"2790",
"1971",
"1572",
"1065",
"12624",
"1989",
"6510",
"1199",
"6617",
"9139",
"1007",
"1008",
"12239",
"6060",
"110",
"6366",
"9191",
"6415",
"6517",
"6085",
"1452",
"1451",
"358",
"6634",
"1291",
"1294",
"1292",
"1289",
"1672",
"11348",
"1913",
"896",
"392",
"962",
"6901",
"6667",
"1077",
"470",
"2206",
"1179",
"6102",
"6905",
"12621",
"6674",
"1685",
"6918",
"1216",
"12185",
"6913",
"2353",
"463",
"12246",
"12475",
"6841",
"6837",
"6597",
"326",
"1808",
"1573",
"2664",
"2666",
"2663",
"2667",
"1950",
"6470",
"509",
"1280",
"12229",
"12223",
"12245",
"12241",
"2907",
"2344",
"6829",
"277",
"1933",
"12422",
"12232",
"6472",
"856",
"1899",
"1898",
"1896",
"853",
"165",
"164",
"2116",
"2023",
"980",
"6719",
"437",
"1031",
"977",
"1864",
"12461",
"1073",
"11837",
"1076",
"6221",
"6508",
"1806",
"1574",
"6346",
"1859",
"90",
"6983",
"12383",
"6990",
"7061",
"2326",
"6224",
"6582",
"12173",
"12180",
"12171",
"12170",
"6616",
"1322",
"6453",
"1171",
"6506",
"10811",
"12364",
"12352",
"1090",
"12351",
"1089",
"166",
"857",
"871",
"1901",
"1900",
"872",
"863",
"897",
"1225",
"6974",
"6725",
"12235",
"6656",
"139",
"2230",
"1172",
"11350",
"926",
"12353",
"1575",
"12458",
"6405",
"1611",
"6353",
"6394",
"6883",
"545",
"510",
"12183",
"870",
"2062",
"842",
"12108",
"1878",
"122",
"6915",
"6687",
"12423",
"2296",
"6670",
"12356",
"10812",
"1088",
"1092",
"10813",
"1095",
"10816",
"6334",
"1867",
"1086",
"10809",
"1081",
"1354",
"6512",
"511",
"1654",
"519",
"6364",
"2091",
"256",
"257",
"2092",
"1187",
"258",
"255",
"1779",
"1309",
"2011",
"347",
"123",
"1414",
"1413",
"6518",
"989",
"2309",
"1538",
"1435",
"1226",
"2108",
"1877",
"6657",
"945",
"211",
"6715",
"2407",
"6566",
"1281",
"6641",
"1155",
"168",
"12069",
"172",
"173",
"153",
"91",
"2854",
"6308",
"6330",
"6567",
"2387",
"1116",
"6339",
"6600",
"6601",
"876",
"241",
"261",
"145",
"262",
"259",
"6685",
"2829",
"6914",
"12218",
"6784",
"9327",
"2067",
"6068",
"1558",
"1951",
"2031",
"1618",
"78",
"6406",
"180",
"963",
"12110",
"946",
"2370",
"1066",
"1949",
"1447",
"2090",
"6500",
"9195",
"12140",
"6536",
"319",
"320",
"321",
"12454",
"6494",
"6924",
"11315",
"1139",
"70",
"432",
"1458",
"2117",
"1789",
"6074",
"1145",
"274",
"12612",
"12484",
"6853",
"1100",
"181",
"6355",
"1158",
"1897",
"362",
"1234",
"71",
"1959",
"6649",
"2899",
"2898",
"1798",
"12375",
"1021",
"1282",
"1764",
"111",
"10802",
"99",
"6593",
"6496",
"6495",
"6082",
"6497",
"1022",
"1539",
"302",
"784",
"6227",
"196",
"854",
"1906",
"2401",
"1227",
"124",
"2402",
"6785",
"1928",
"100",
"2885",
"6868",
"2081",
"1465",
"7001",
"6260",
"6310",
"6539",
"2006",
"355",
"1283",
"6501",
"2306",
"1765",
"12387",
"1062",
"1811",
"6637",
"1236",
"1228",
"1986",
"356",
"125",
"2054",
"1886",
"6795",
"369",
"359",
"1423",
"2012",
"1407",
"265",
"9131",
"1995",
"1992",
"9132",
"1996",
"9137",
"266",
"146",
"267",
"1993",
"9136",
"268",
"269",
"1994",
"263",
"12622",
"1078",
"12465",
"1953",
"6099",
"1140",
"1217",
"54",
"7038",
"6925",
"7037",
"7032",
"9117",
"92",
"7033",
"1355",
"1363",
"12485",
"6402",
"6960",
"529",
"1093",
"972",
"1188",
"6796",
"1189",
"6959",
"1310",
"1311",
"6455",
"1146",
"205",
"7056",
"10804",
"2040",
"1096",
"1101",
"1102",
"999",
"112",
"12354",
"6516",
"9125",
"12457",
"11121",
"275",
"1295",
"6577",
"1857",
"101",
"12468",
"1105",
"12240",
"6061",
"2867",
"1173",
"12464",
"526",
"1756",
"174",
"479",
"446",
"1525",
"1436",
"206",
"2176",
"6534",
"2333",
"2374",
"11226",
"6416",
"102",
"6248",
"6421",
"6249",
"105",
"6237",
"1819",
"393",
"6554",
"6423",
"1969",
"6253",
"2887",
"2363",
"1947",
"520",
"383",
"424",
"103",
"1250",
"6836",
"6122",
"1299",
"12376",
"1103",
"12431",
"6580",
"882",
"880",
"12194",
"6607",
"6611",
"1331",
"6851",
"1349",
"1347",
"1350",
"1341",
"1342",
"1330",
"175",
"6544",
"79",
"6412",
"521",
"938",
"6825",
"40",
"1984",
"1118",
"1982",
"1983",
"1985",
"1276",
"6343",
"6229",
"2404",
"80",
"6403",
"81",
"6411",
"6404",
"2196",
"1229",
"6427",
"6401",
"6236",
"2400",
"6783",
"2313",
"11233",
"270",
"12487",
"1369",
"1353",
"1396",
"1356",
"2229",
"1375",
"1390",
"1370",
"1406",
"1358",
"1371",
"1374",
"1368",
"11286",
"1384",
"1383",
"1376",
"1364",
"1404",
"1377",
"1378",
"1391",
"1388",
"1746",
"1394",
"1401",
"1426",
"1405",
"1397",
"1385",
"1379",
"1402",
"1365",
"1386",
"1380",
"1387",
"1357",
"1427",
"1373",
"1409",
"2638",
"1398",
"2228",
"1381",
"1366",
"1399",
"1415",
"1372",
"1351",
"1382",
"1367",
"1416",
"1428",
"1410",
"1411",
"522",
"858",
"873",
"1902",
"1903",
"6589",
"7045",
"115",
"843",
"1343",
"2021",
"363",
"2207",
"2099",
"370",
"154",
"1784",
"1024",
"12361",
"2321",
"939",
"11486",
"6420",
"2654",
"11327",
"1009",
"1925",
"9203",
"7026",
"6623",
"12614",
"1190",
"7029",
"7050",
"6886",
"6548",
"7035",
"39",
"6798",
"41",
"1056",
"1807",
"1647",
"6454",
"6511",
"1939",
"1938",
"1067",
"2324",
"2103",
"2102",
"1344",
"1393",
"6688",
"12476",
"6627",
"6890",
"6881",
"6876",
"6874",
"1130",
"1119",
"1120",
"6663",
"6356",
"6467",
"1049",
"1481",
"2538",
"1400",
"1794",
"1613",
"1795",
"6931",
"6689",
"848",
"10814",
"785",
"11352",
"6654",
"12427",
"12619",
"55",
"2830",
"349",
"6807",
"1540",
"2348",
"2000",
"6943",
"9339",
"447",
"6813",
"6438",
"236",
"2832",
"2383",
"947",
"6661",
"6382",
"1783",
"1670",
"2847",
"1312",
"6590",
"6286",
"1948",
"6070",
"2295",
"12430",
"2861",
"1946",
"1039",
"6721",
"182",
"212",
"2312",
"6488",
"2159",
"254",
"1156",
"1153",
"1157",
"12234",
"1141",
"1963",
"12208",
"6591",
"961",
"12106",
"6716",
"2299",
"1614",
"948",
"6698",
"6418",
"6581",
"6987",
"6256",
"119",
"1313",
"887",
"1246",
"2168",
"6789",
"6927",
"6558",
"6053",
"12227",
"458",
"1526",
"1941",
"1940",
"1880",
"7059",
"6320",
"12608",
"1615",
"160",
"6469",
"6814",
"11296",
"1620",
"6978",
"12618",
"1559",
"9335",
"93",
"916",
"1987",
"1876",
"6374",
"1576",
"1466",
"1812",
"12242",
"9321",
"12217",
"11122",
"878",
"6939",
"2052",
"6231",
"285",
"62",
"2930",
"2922",
"1314",
"2923",
"2921",
"6347",
"830",
"371",
"2045",
"1174",
"12440",
"12373",
"350",
"147",
"1075",
"1142",
"351",
"1143",
"1150",
"1277",
"1151",
"1161",
"1163",
"1891",
"2020",
"6357",
"279",
"12463",
"12610",
"6429",
"2174",
"1624",
"1421",
"1518",
"2828",
"6104",
"1237",
"1689",
"6103",
"1231",
"12317",
"1147",
"1148",
"9333",
"6276",
"2291",
"439",
"879",
"2920",
"12623",
"1625",
"1893",
"2394",
"2098",
"1991",
"12388",
"1990",
"6749",
"6695",
"176",
"6499",
"2008",
"2186",
"11175",
"12216",
"12439",
"6386",
"1159",
"6833",
"6702",
"6632",
"2345",
"6831",
"6466",
"94",
"929",
"9329",
"6916",
"1966",
"6859",
"2862",
"315",
"6373",
"6786",
"7030",
"6447",
"1160",
"1050",
"2793",
"12357",
"303",
"12172",
"6653",
"1577",
"1437",
"6941",
"6942",
"12226",
"12169",
"95",
"2288",
"2298",
"1293",
"6319",
"2049",
"6921",
"2926",
"46",
"42",
"2009",
"352",
"6312",
"6828",
"1094",
"6504",
"1626",
"6585",
"6909",
"126",
"6255",
"1213",
"10805",
"6690",
"10806",
"1967",
"128",
"6419",
"6664",
"6367",
"6315",
"1023",
"959",
"12424",
"6889",
"6888",
"1132",
"6292",
"118",
"6439",
"2819",
"1051",
"1052",
"440",
"6293",
"96",
"6717",
"9185",
"6989",
"276",
"12640",
"1619",
"238",
"1408",
"1926",
"1988",
"2056",
"523",
"6712",
"6317",
"282",
"286",
"287",
"288",
"6066",
"47",
"372",
"1924",
"918",
"6440",
"12155",
"1175",
"12151",
"2215",
"444",
"12332",
"140",
"1453",
"12615",
"1454",
"6395",
"6265",
"9197",
"1176",
"1457",
"1455",
"1456",
"1429",
"395",
"425",
"1068",
"161",
"1191",
"239",
"1918",
"908",
"2197",
"2903",
"6982",
"6823",
"1690",
"2844",
"6358",
"12204",
"11353",
"12390",
"1564",
"1482",
"327",
"2360",
"2287",
"292",
"299",
"412",
"11166",
"1838",
"6948",
"1834",
"532",
"441",
"12646",
"6225",
"1474",
"844",
"11252",
"1534",
"1483",
"997",
"1438",
"524",
"1519",
"1420",
"2301",
"6110",
"155",
"6084",
"965",
"6267",
"2029",
"1439",
"12159",
"2358",
"2359",
"9130",
"1920",
"909",
"1921",
"9129",
"9127",
"308",
"2368",
"12486",
"6938",
"883",
"396",
"472",
"384",
"2369",
"6879",
"6645",
"6547",
"6964",
"9199",
"1238",
"6639",
"1648",
"1284",
"2175",
"966",
"72",
"316",
"322",
"10795",
"281",
"6493",
"12243",
"1079",
"6958",
"6696",
"6723",
"1149",
"1135",
"6791",
"213",
"6804",
"1040",
"1826",
"1475",
"376",
"1560",
"183",
"73",
"113",
"6509",
"1239",
"2055",
"6638",
"6368",
"6369",
"6299",
"6365",
"6232",
"2386",
"12405",
"864",
"12197",
"6967",
"10807",
"6794",
"1240",
"1303",
"1315",
"2869",
"1914",
"2035",
"12425",
"1861",
"6392",
"6842",
"6598",
"971",
"831",
"845",
"2403",
"1326",
"1317",
"6923",
"6808",
"6809",
"1858",
"2286",
"6651",
"6359",
"978",
"12141",
"1165",
"769",
"237",
"6502",
"1345",
"1792",
"1628",
"6464",
"6254",
"6388",
"6336",
"6234",
"364",
"1214",
"6331",
"6431",
"12474",
"1629",
"6847",
"6631",
"849",
"1129",
"6309",
"2641",
"2640",
"1818",
"48",
"177",
"475",
"455",
"2811",
"64",
"58",
"290",
"2373",
"5",
"459",
"385",
"2170",
"954",
"11123",
"2347",
"398",
"1804",
"1578",
"6549",
"1285",
"2405",
"365",
"449",
"1535",
"2855",
"2815",
"1955",
"1085",
"2928",
"1945",
"1954",
"859",
"874",
"1905",
"1904",
"1346",
"10808",
"1327",
"6772",
"1970",
"448",
"6306",
"6311",
"6917",
"1010",
"12109",
"1965",
"6054",
"1230",
"9338",
"97",
"306",
"6722",
"307",
"304",
"1025",
"955",
"1881",
"1942",
"1069",
"1011",
"1910",
"1943",
"12603",
"1579",
"187",
"1932",
"525",
"208",
"885",
"888",
"1678",
"188",
"2085",
"6878",
"884",
"6588",
"12166",
"1286",
"1278",
"6922",
"7034",
"1287",
"6640",
"6799",
"1215",
"6298",
"1017",
"915",
"1803",
"2851",
"6768",
"1782",
"1484",
"546",
"11240",
"9204",
"2352",
"291",
"2856",
"12444",
"1258",
"1866",
"988",
"12392",
"1192",
"949",
"12442",
"148",
"2028",
"6935",
"6903",
"6730",
"6397",
"6396",
"6235",
"6058",
"1884",
"9174",
"162",
"386",
"399",
"12209",
"6710",
"190",
"910",
"2897",
"2896",
"1630",
"1177",
"1580",
"1552",
"6583",
"2385",
"178",
"1422",
"1424",
"11160",
"12609",
"6584",
"6997",
"11275",
"179",
"2537",
"6377",
"1053",
"2912",
"6659",
"6108",
"2030",
"2362",
"1235",
"6263",
"6069",
"1042",
"2050",
"74",
"950",
"2046",
"12370",
"2048",
"1840",
"6376",
"6729",
"1071",
"560",
"367",
"12182",
"2311",
"6344",
"886",
"11356",
"6932",
"6387",
"1104",
"2016",
"12406",
"1650",
"65",
"464",
"400",
"2396",
"2361",
"6076",
"6094",
"6093",
"6465",
"1872",
"1425",
"12462",
"6553",
"12641",
"1279",
"12362",
"144",
"12470",
"6642",
"1026",
"1622",
"35",
"1695",
"131",
"2849",
"561",
"373",
"890",
"889",
"12316",
"2018",
"6912",
"2375",
"1012",
"1623",
"1464",
"12428",
"1028",
"1027",
"1029",
"12349",
"9337",
"1328",
"197",
"191",
"6112",
"14",
"6986",
"6707",
"214",
"6579",
"1259",
"6474",
"6077",
"6478",
"6476",
"6295",
"9189",
"6477",
"2917",
"2918",
"6475",
"1249",
"1070",
"12225",
"114",
"1133",
"6360",
"12374",
"6724",
"1014",
"9182",
"6665",
"2002",
"1817",
"289",
"899",
"98",
"6984",
"2818",
"1241",
"1288",
"1247",
"2177",
"6055",
"1671",
"2820",
"1801",
"1800",
"2179",
"1633",
"1879",
"12625",
"6703",
"9193",
"2059",
"1134",
"2335",
"2042",
"6550",
"6393",
"240",
"2411",
"2785",
"1631",
"12637",
"786",
"1889",
"1936",
"1937",
"1072",
"1080",
"15",
"1813",
"6391",
"6832",
"2294",
"500",
"1512",
"2118",
"1790",
"6075",
"6361",
"127",
"10796",
"368",
"12626",
"1461",
"9192",
"6385",
"12471",
"1200",
"83",
"1260",
"6891",
"1802",
"1030",
"1645",
"6691",
"2372",
"2831",
"163",
"1316",
"2032",
"2784",
"9330",
"1961",
"6243",
"9322",
"6380",
"7058",
"6962",
"1796",
"1632",
"2653",
"2652",
"189",
"2013",
"2853",
"353",
"167",
"6271",
"1958"
],
"type": "string",
"description": "Restrict to an Etsy category (seller taxonomy). Type to search. Leave as Any for all categories.",
"default": ""
},
"shopLocation": {
"title": "Shop location (country)",
"enum": [
"",
"US",
"GB",
"CA",
"AU",
"DE",
"FR",
"IT",
"ES",
"NL",
"IE",
"IN",
"PL",
"PT",
"SE",
"GR",
"TR",
"UA",
"RO",
"CZ",
"DK",
"FI",
"NO",
"BE",
"AT",
"CH",
"NZ",
"JP",
"CN",
"HK",
"BR",
"MX",
"ZA",
"SG"
],
"type": "string",
"description": "Restrict to sellers in a country (native Etsy filter). Leave as Any for all countries.",
"default": ""
},
"createdAfter": {
"title": "Created after",
"type": "string",
"description": "Only listings first created on/after this date. Tip: pair with Sort by = Newest for a fast run."
},
"createdBefore": {
"title": "Created before",
"type": "string",
"description": "Only listings first created on/before this date."
},
"updatedWithinDays": {
"title": "Updated within N days",
"minimum": 1,
"type": "integer",
"description": "Only listings edited / re-listed in the last N days (e.g. 7 = refreshed this week). Pair with Sort by = Recently updated for a fast run."
},
"minViews": {
"title": "Min views",
"minimum": 0,
"type": "integer",
"description": "Only listings with at least this many all-time views (demand floor)."
},
"minFavorers": {
"title": "Min favorites",
"minimum": 0,
"type": "integer",
"description": "Only listings with at least this many favorites."
},
"whoMade": {
"title": "Who made it",
"enum": [
"any",
"i_did",
"someone_else",
"collective"
],
"type": "string",
"description": "Filter by Etsy's who_made field.",
"default": "any"
},
"includeImages": {
"title": "Include listing photos",
"type": "boolean",
"description": "Add the main listing photo as a column (rendered as a thumbnail). Fetched in cheap batches of 100. On by default.",
"default": true
},
"includeDescription": {
"title": "Include full description",
"type": "boolean",
"description": "Add the listing's full description text as a column. Off by default because descriptions are long and bloat the CSV.",
"default": false
},
"raw": {
"title": "Raw output",
"type": "boolean",
"description": "Push the full untouched Etsy listing object instead of the clean flat record.",
"default": false
}
}
},
"runsResponseSchema": {
"type": "object",
"properties": {
"data": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"actId": {
"type": "string"
},
"userId": {
"type": "string"
},
"startedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"finishedAt": {
"type": "string",
"format": "date-time",
"example": "2025-01-08T00:00:00.000Z"
},
"status": {
"type": "string",
"example": "READY"
},
"meta": {
"type": "object",
"properties": {
"origin": {
"type": "string",
"example": "API"
},
"userAgent": {
"type": "string"
}
}
},
"stats": {
"type": "object",
"properties": {
"inputBodyLen": {
"type": "integer",
"example": 2000
},
"rebootCount": {
"type": "integer",
"example": 0
},
"restartCount": {
"type": "integer",
"example": 0
},
"resurrectCount": {
"type": "integer",
"example": 0
},
"computeUnits": {
"type": "integer",
"example": 0
}
}
},
"options": {
"type": "object",
"properties": {
"build": {
"type": "string",
"example": "latest"
},
"timeoutSecs": {
"type": "integer",
"example": 300
},
"memoryMbytes": {
"type": "integer",
"example": 1024
},
"diskMbytes": {
"type": "integer",
"example": 2048
}
}
},
"buildId": {
"type": "string"
},
"defaultKeyValueStoreId": {
"type": "string"
},
"defaultDatasetId": {
"type": "string"
},
"defaultRequestQueueId": {
"type": "string"
},
"buildNumber": {
"type": "string",
"example": "1.0.0"
},
"containerUrl": {
"type": "string"
},
"usage": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "integer",
"example": 1
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
},
"usageTotalUsd": {
"type": "number",
"example": 0.00005
},
"usageUsd": {
"type": "object",
"properties": {
"ACTOR_COMPUTE_UNITS": {
"type": "integer",
"example": 0
},
"DATASET_READS": {
"type": "integer",
"example": 0
},
"DATASET_WRITES": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_READS": {
"type": "integer",
"example": 0
},
"KEY_VALUE_STORE_WRITES": {
"type": "number",
"example": 0.00005
},
"KEY_VALUE_STORE_LISTS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_READS": {
"type": "integer",
"example": 0
},
"REQUEST_QUEUE_WRITES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_INTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"DATA_TRANSFER_EXTERNAL_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
"type": "integer",
"example": 0
},
"PROXY_SERPS": {
"type": "integer",
"example": 0
}
}
}
}
}
}
}
}
}
}
```