Skip to content

Structured Etsy data: send urls. Single lookup, 1 credit per successful call.

GET · POST1 credit / successful callSingle lookupLong-running
GEThttps://api.scrapier.io/api/v2/etsy-product-info-by-url/Open in Playground

Call GET /api/v2/etsy-product-info-by-url/ with urls. The results are in data.product. 5 optional parameters refine the call (see Parameters).

Terminal window
curl -G "https://api.scrapier.io/api/v2/etsy-product-info-by-url/" \
-H "X-API-Key: YOUR_API_KEY" \
--data-urlencode "urls=https://www.etsy.com/listing/1215970085/custom-air-freshener" \
--max-time 210
NameTypeRequiredDefaultDescription
X-API-Key headerstringyes—Your API key from the dashboard.
urlsstringyese.g. https://www.etsy.com/listing/1215970085/custom-air-freshenerEtsy listing URL or bare listing id. One record per call.
cursorstringno—Pagination cursor returned in the previous response's next_cursor. Pass it back unchanged to fetch the next page. When next_cursor is null, you have reached the last page.
countrystringnoUSShip-to country, ISO-2.
locked in cursor
currencystringnoUSDISO 4217 price currency.
locked in cursor
languagestringnoen-USListing copy language.
locked in cursor
renderstringnoautoauto = HTTP (no browser) with browser fallback; http = never a browser.
autohttpbrowser
Advanced
NameTypeDefaultDescription
use_proxybooleantrueRoute the request through Scrapier's residential proxy pool. Default: true. Leave as is unless support tells you otherwise.
raw_databooleanfalseWhen true, the response carries the full raw upstream payload(s) the scraper received (GraphQL / JSON API bodies, HTML, embedded JSON-LD -- exactly as the platform returned them) under raw_responses, in place of the formatted items. When false (default) you get the formatted output. Pagination (cursor / next_cursor) works the same in both modes.
{
"success": true,
"data": {
"urls": "https://www.etsy.com/listing/1215970085/custom-air-freshener",
"product": {
"input_url": "https://www.etsy.com/listing/1215970085/custom-air-freshener",
"listing_id": "1215970085",
"status": "active",
"id": "1215970085",
"url": "https://www.etsy.com/listing/1215970085/custom-air-freshener-picture-air",
"title": "Custom Air Freshener, Picture Air Freshener, Cute Car Accessories, Photo Freshener, Car Freshies, Car Decor",
"description": "NEW improved print quality! We're proud to offer the highest...",
"seller": "TheFreshener",
"brand": "TheFreshener",
"price": {
"current": 12.95,
"original": 12.95,
"currency": "USD",
"discount_percent": 0,
"min": 12.95,
"max": 12.95
},
"rating": {
"average": 5,
"count": 14661
},
"image_urls": [
"https://i.etsystatic.com/35332887/r/il/e41fa0/5469863166/il_fullxfull.5469863166_6sgn.jpg"
],
"availability": "in_stock",
"reviews_count": 14661,
"seller_id": "35332887",
"available_quantity": 80840,
"favorites": 55433,
"is_bestseller": true,
"is_top_rated": true,
"materials": [
"Cotton"
],
"taxonomy_path": "electronics_and_accessories.car_parts_and_accessories.car_accessories.car_air_fresheners",
"when_made": "made_to_order",
"user_id": "628346348",
"is_star_seller": true,
"is_etsys_pick": true,
"state": "active",
"tags": [
"car freshener funny",
"cute car air fresh",
"funny car freshener"
],
"section_name": "Custom Car Fresheners",
"listed_on": "Sep 24, 2026",
"created_at": "2026-09-24T11:07:33Z",
"shop_url": "https://www.etsy.com/shop/TheFreshener",
"shop_reviews_count": 19906,
"urgency_signal": "In 20+ carts",
"shipping": {
"ships_from": "Jacksonville, FL",
"origin_country": "US",
"origin_region": "FL",
"cost": 6.07,
"cost_currency": "USD",
"free_shipping": false,
"free_shipping_threshold": 35,
"estimated_delivery": "Sep 29-Oct 1",
"accepts_returns": false,
"accepts_exchanges": false
},
"country": "US",
"currency": "USD",
"language": "en-US",
"scraped_at": "2026-09-24T13:31:17.054Z"
},
"next_cursor": null
}
}

Sample from the live catalog; arrays trimmed to 3 items. Results are in data.product.

FieldTypeExampleDescription
urlsstringhttps://www.etsy.com/listing/1215970085/custo…—
productobject{…}The results.
next_cursornullnullPass back as cursor for the next page. null on the last page.
product.input_urlstringhttps://www.etsy.com/listing/1215970085/custo…—
product.listing_idstring1215970085—
product.statusstringactive—
product.idstring1215970085—
product.urlstringhttps://www.etsy.com/listing/1215970085/custo…—
product.titlestringCustom Air Freshener, Picture Air Freshener, …—
product.descriptionstringNEW improved print quality! We're proud to of…—
product.sellerstringTheFreshener—
product.brandstringTheFreshener—
product.priceobject{…}—
product.ratingobject{…}—
product.image_urlsarray[1 item]—
product.availabilitystringin_stock—
product.reviews_countinteger14661—
product.seller_idstring35332887—
product.available_quantityinteger80840—
product.favoritesinteger55433—
product.is_bestsellerbooleantrue—
product.is_top_ratedbooleantrue—
product.materialsarray[1 item]—
product.taxonomy_pathstringelectronics_and_accessories.car_parts_and_acc…—
product.when_madestringmade_to_order—
product.user_idstring628346348—
product.is_star_sellerbooleantrue—
product.is_etsys_pickbooleantrue—
product.statestringactive—
product.tagsarray[3 items]—
product.section_namestringCustom Car Fresheners—
product.listed_onstringSep 24, 2026—
product.created_atstring2026-09-24T11:07:33Z—
product.shop_urlstringhttps://www.etsy.com/shop/TheFreshener—
product.shop_reviews_countinteger19906—
product.urgency_signalstringIn 20+ carts—
product.shippingobject{…}—
product.countrystringUS—
product.currencystringUSD—
product.languagestringen-US—
product.scraped_atstring2026-09-24T13:31:17.054Z—

Returns everything in one call; next_cursor is always null.

Failed calls are free. Branch on the HTTP status and read the message from error (or detail). Full details in Errors.

StatusMeaningRetry?Charged?
400Bad or missing input.No — fix the paramsNo
401 / 403Missing, invalid or revoked API key.No — fix the keyNo
402Out of credits (body has balance).No — top upNo
404Unknown endpoint slug.No — check the slugNo
429 / 503Busy or throttled.Yes — after Retry-AfterNo
5xxTarget site or upstream failure, or timeout.Yes — with backoffNo
  • This endpoint can take several minutes. Set your client timeout to at least 210 seconds.
  • Etsy Product Reviews — Structured Etsy data: send urls. Cursor-paginated, 1 credit per successful call.
  • Etsy Search by Keyword — Structured Etsy data: send queries. Cursor-paginated, 1 credit per successful call.
  • Etsy Search Suggestions — Structured Etsy data: send queries. Cursor-paginated, 1 credit per successful call.
  • Etsy Shop Products — Structured Etsy data: send urls. Cursor-paginated, 1 credit per successful call.