etsy-search
The listings on an Etsy search results page: listing id, title, the listing's link without its tracking keys, the price as shown, its currency code, star rating, the shop's review count, shop name, image, whether it ships free, and whether it carries the Bestseller badge. query is the search; page reads a later results page; limit caps the rows (a page holds up to 64). A few seconds; when the page cannot be read, a second source answers page 1 in about 3 minutes.
Recipes are not open yet.
What this recipe returned on its last run. No key needed to look.
Fields
11 columns on every row. null means the site does not state it.| field | type | meaning |
|---|---|---|
| listing_id | string | Etsy's id of the listing (digits, as a string). |
| title | string | The listing's title. |
| url | string | The listing's page, https://www.etsy.com/listing/<id>/<name>, without tracking keys. |
| price | string | The price charged, written as Etsy shows it with the currency symbol ("$34.99"); a sale's old price is left out. |
| currency | string | The currency code of the price ("USD"); Etsy picks it from where the visitor is. |
| rating | number | The star rating, 0 to 5. |
| reviews | integer | How many reviews the shop has. The page rounds it ("16.8k" gives 16800); the second source gives the exact count. |
| shop | string | The shop's name. |
| image | string | The listing's first photo; the second source gives the full-size copy. |
| free_shipping | boolean | true when Etsy says shipping is free; null on the second source when it shows no shipping line. |
| bestseller | boolean | true when the card carries Etsy's Bestseller badge; null on the second source. |
null means the site does not state it.
How it behaves
Cost. 2 units · 1 record per row on fallback. A failed run costs 0.
Freshness 10 min. The same input within 10 min is served from cache at 0 units.
Questions about this recipeQuestions
Short answers. The API reference has the long ones.
Call POST /recipes/etsy-search with your key and query and page and limit. You get rows with the 11 fields above. The recipe is tested against the live site every 6 hours.
2 units · 1 record per row on fallback. A failed run costs 0. The same input within 10 min costs 0.
Yes. Sign up with Google, GitHub or email for a free key with 1,000 credits every month. No credit card.
The health check runs every 6 hours against the live site. A failing recipe shows as failing on this page until we fix it.
Extra fields, higher volume, or a private copy with a freshness SLA. We build it on Enterprise.
Request a changeMore for e-commerce and catalogs
All 12 recipes →One Amazon product page: ASIN, title, price, star rating, review count, brand, availability, the feature bullets, the main image and the…
The products on an Amazon search results page: ASIN, title, price, star rating, review count, the product's link, image, and whether the…
One game on Steam: name, price and discount in the chosen store region, developers, publishers, release date, genres, feature tags…
For developers
Get a free API key and run your first crawl.
1,000 credits every month. No credit card. Your self-hosted setup keeps working.
For teams
Talk to us about volume, regions and an SLA.
A 30-minute call with the team that writes the crawler. DPA on request, invoice billing, your choice of US, EU or Singapore.