Etsy: scrapers and the official API, compared

Route map

Each line is one way to get Etsy data; each stop is a field you probably need. Green lines are catalogue Actors, ranked by the published formula.

Field matrix: who returns what

Every tool with a published output schema, against the 6 fields most Etsy jobs need. A dot means the field name appears in the schema; rows can still leave it empty.

Field dictionary: the exact keys

The same core field has a different key in each Actor's output. Map these before you merge datasets; a dash means the published schema has no matching key. Need a field that is not listed here, such as email? Search every Etsy Actor by field.

Download this comparison: CSV · JSON (every tool with a published schema, matching keys per core field, price and score).

All 9 tools, scored

Catalogue Actors link to their detail pages; the score (0 to 100) is the published formula, identical for every tool. Other Store tools follow in their own table, for reference. Price is the published primary-result rate per 1,000 (the Free-plan rate where the price is tiered; higher Apify plans pay less); start events and platform usage are excluded.

Other Store tools, for reference

Scored with the same published formula and listed for comparison only; this site does not link or recommend them.

What to check before you choose

Etsy listing prices support assortment research, shop comparisons and tracking of competing offers. Keep currency and advertising status alongside each result so that comparisons retain the context of the listing.

Search collection suits discovery across a product category, while shop collection suits following a particular seller's assortment. The official API offers a separate route for applications that can meet its authentication, scope and rate-limit requirements.

Checklist

• Confirm that priceValue is paired with currencyCode. A price comparison needs both.
• Check whether the tool collects search results or a shop's listings, and retain isAd where available when comparing result placement.
• Verify identifiers and review detail before planning joins or text analysis. The Etsy Product Listings & Shop Research Scraper publishes url, rating and reviewCount, but its published schema does not include listing_id or review text.

Where the data is incomplete

The published schema for Etsy Product Listings & Shop Research Scraper includes priceValue and currencyCode.

Ratings and review counts summarize feedback without exposing individual review text or its timing.

Official API route

Terms and personal data

Keep scraping to public listing information and check Etsy's terms and API terms for the collection route you choose. Review reuse permissions before republishing listing text or images. This is general information, not legal advice.

Read Etsy's terms. Keep to public data, do not bypass logins or access controls, and check whether personal data is involved before you collect it. The can-I-scrape checklist walks through it.

How to start

1. Enter a narrowly defined product search using the supported inputs, then start a small collection.
2. Inspect the resulting dataset for listing links, price currency and shop attribution before exporting it in an available format.

Call Etsy Product Listings & Shop Research Scraper from code

The example input uses the Actor's published defaults; set your own Etsy query before you run it. You need an Apify API token.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "searchQueries": [
        "handmade jewelry"
    ],
    "maxItems": 1,
    "includeDetails": False,
    "minPrice": 0,
    "maxPrice": 0,
    "freeShippingOnly": False,
    "starSellerOnly": False,
    "country": "US"
}

run = client.actor("nimbryxo-studio/etsy-product-listings-and-shop-research-scraper").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "searchQueries": [
        "handmade jewelry"
    ],
    "maxItems": 1,
    "includeDetails": false,
    "minPrice": 0,
    "maxPrice": 0,
    "freeShippingOnly": false,
    "starSellerOnly": false,
    "country": "US"
};

const run = await client.actor("nimbryxo-studio/etsy-product-listings-and-shop-research-scraper").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/nimbryxo-studio~etsy-product-listings-and-shop-research-scraper/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"searchQueries":["handmade jewelry"],"maxItems":1,"includeDetails":false,"minPrice":0,"maxPrice":0,"freeShippingOnly":false,"starSellerOnly":false,"country":"US"}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=nimbryxo-studio/etsy-product-listings-and-shop-research-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

Questions people ask

More on Etsy

• Topic groupEcommerce data: every website compared
• ToolWhich Etsy route fits your job?
• ToolEtsy cost by Apify plan, rows and runs

Related websites

• Amazon12 Actors
• eBay4 Actors
• Pinterest6 Actors

Sources

• Etsy Product Listings & Shop Research Scraper on Apify Store
• Etsy Open API v3 documentation
• Etsy terms