Scrape Etsy search results with sort + price filters

2026-10-03 (America/Toronto). Prices updated Oct 28, 2026.

Disclosure: I publish and maintain the Actor this tutorial uses (publicrecords/etsy-search-scraper on Apify).

You have a search query and you need structured listing rows you can filter by price and sort the way Etsy’s own menu does — not a screenshot of page one.

The method

  1. Run on Apify residential proxy (default). Passthrough — Apify bills proxy usage; our PPE has no proxy markup. A blocked page charges no listing rows.
  2. Set sort + price filters with the real input fields. sort is one of relevance, newest, price_asc, price_desc, top_reviews. minPrice / maxPrice are whole currency units.
  3. Cap the run with maxItems and/or maxPages.
  4. Bill only delivered complete rows. As of Oct 28, 2026 (Store pricing): 0.4¢ per listing row on the Free plan (down to 0.34¢ on Gold and up), plus a 0.005¢ start fee once per run, charged only when a complete listing is in hand.
  5. Join to shop velocity when you care about the seller. Companion Actor publicrecords/etsy-shop-velocity.

Doing it for real (Store-page run)

Etsy Search Scraper (publicrecords/etsy-search-scraper).

Proof run (2026-10-03, Store / WEB origin)

FieldValue
Actorpublicrecords/etsy-search-scraper
OriginWEB (Apify Store / console)
StatusSUCCEEDED
Dataset10 items
Sort / pricesort=price_asc, minPrice=10, maxPrice=40
Cost at Oct 28, 2026 prices (Store pricing)10 × 0.4¢ + 0.005¢ → about 4¢ on the Free plan

Input used (from that Store-page run):

{
  "fillLazyCards": true,
  "free_shipping": false,
  "instant_download": false,
  "is_best_seller": false,
  "is_discounted": false,
  "is_handmade_only": false,
  "is_personalizable": false,
  "is_star_seller": false,
  "maxItems": 10,
  "maxPages": 1,
  "maxPrice": 40,
  "minPrice": 10,
  "queries": [
    "ceramic mug"
  ],
  "sort": "price_asc",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}

Output rows (first 3 of 10; full file in the example repo):

[
  {
    "listing_id": "4560879110",
    "url": "https://www.etsy.com/listing/4560879110/1980s-christmas-coffee-mug",
    "title": "1980\u2019s Christmas Coffee Mug",
    "price": 10,
    "currency": "$",
    "shop_id": "11795502",
    "shop_name": "TheNostalgiaHunter",
    "shop_url": "https://www.etsy.com/shop/TheNostalgiaHunter",
    "rating_value": 4.9,
    "review_count": 2200,
    "review_count_approx": true,
    "bestseller": false,
    "popular_now": false,
    "star_seller": false,
    "etsys_pick": false,
    "free_shipping": false,
    "is_ad": null,
    "position": 1,
    "surface": "neu",
    "page": 1,
    "query": "ceramic mug"
  },
  {
    "listing_id": "1658939001",
    "url": "https://www.etsy.com/listing/1658939001/ill-give-you-a-daisy-a-day-mug-11oz-most",
    "title": "Daisy a Day Coffee Mug, 11oz Ceramic Mug",
    "price": 10,
    "currency": "$",
    "shop_id": "48580588",
    "shop_name": "SmugMugMugs",
    "shop_url": "https://www.etsy.com/shop/SmugMugMugs",
    "rating_value": 5,
    "review_count": 51,
    "review_count_approx": false,
    "bestseller": false,
    "popular_now": false,
    "star_seller": false,
    "etsys_pick": false,
    "free_shipping": false,
    "is_ad": null,
    "position": 2,
    "surface": "neu",
    "page": 1,
    "query": "ceramic mug"
  },
  {
    "listing_id": "4523191049",
    "url": "https://www.etsy.com/listing/4523191049/america-250th-birthday-mug-1776",
    "title": "America 250th Birthday Mug | 1776 Bicentennial Style Ceramic Mug | Patriotic Gift | Commemorative Americana Mug",
    "price": 10,
    "currency": "$",
    "shop_id": "28112493",
    "shop_name": "SouthernRoyaltyUS",
    "shop_url": "https://www.etsy.com/shop/SouthernRoyaltyUS",
    "rating_value": 5,
    "review_count": 32,
    "review_count_approx": false,
    "bestseller": false,
    "popular_now": false,
    "star_seller": false,
    "etsys_pick": false,
    "free_shipping": false,
    "is_ad": null,
    "position": 3,
    "surface": "neu",
    "page": 1,
    "query": "ceramic mug"
  }
]

Row count for this sample is 10 (the Store run’s maxItems was 10). Not padded.

Cost math

Store + MCP + one-command example

Actor (Store): https://apify.com/publicrecords/etsy-search-scraper

MCP: https://mcp.apify.com/?tools=publicrecords/etsy-search-scraper

Example repo: GeminiGeorge22/etsy-search-example

apify call publicrecords/etsy-search-scraper --input '{"fillLazyCards": true, "free_shipping": false, "instant_download": false, "is_best_seller": false, "is_discounted": false, "is_handmade_only": false, "is_personalizable": false, "is_star_seller": false, "maxItems": 10, "maxPages": 1, "maxPrice": 40, "minPrice": 10, "queries": ["ceramic mug"], "sort": "price_asc", "proxyConfiguration": {"useApifyProxy": true, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US"}}'
Open on Apify Store →

Disclaimer

Etsy® is a trademark of Etsy, Inc. This post and the Actor are not affiliated with, endorsed by, or sponsored by Etsy.

Disclosure (again): published by the maintainer of publicrecords/etsy-search-scraper (Public Records / publicrecords on Apify).