APIs / Marketplaces / Etsy
from 10 credits per call1 endpoint2 datapoints
Etsy API
Etsy API for listing details as JSON: price and discount, stock, variations, materials, images, shop and favourites. 10 credits per successful call.
{
"success": true,
"data": {
"listing_id": "1241528786",
"url": "https://www.etsy.com/listing/1241528786/personalized-leather-rfid-wallet",
"title": "Personalized Leather RFID Wallet, Engraved Genuine Leather Custom Wallet, Anniversary Gift For Him, Husband, Boyfriend, Men, Father, Dad",
"description": "This Personalized Leather RFID Wallet is the perfect Engraved Genuine Leather Custom Wallet, ideal as an Anniversary Gift for Him, Husband, Boyfriend, Men, Father, or Dad. Show your loved one you care with a timeless and practical gift.\n\nWe…",
"category": [
"Wallets"
],
"price": {
"current": 28,
"original": 70,
"discount_percent": 60,
"currency": "USD"
},
"availability": "InStock",
"quantity_available": 1333,
"rating": {},
"images": [
{
"url": "https://i.etsystatic.com/35016605/r/il/a5f633/4007318605/il_fullxfull.4007318605_mj36.jpg",
"thumbnail": "https://i.etsystatic.com/35016605/r/il/a5f633/4007318605/il_340x270.4007318605_mj36.jpg"
},
{
"url": "https://i.etsystatic.com/35016605/r/il/4ca749/3959645938/il_fullxfull.3959645938_mdoe.jpg",
"thumbnail": "https://i.etsystatic.com/35016605/r/il/4ca749/3959645938/il_340x270.3959645938_mdoe.jpg"
},
{
"url": "https://i.etsystatic.com/35016605/r/il/1e93ec/4668917675/il_fullxfull.4668917675_aqlz.jpg",
"thumbnail": "https://i.etsystatic.com/35016605/r/il/1e93ec/4668917675/il_340x270.4668917675_aqlz.jpg"
}
],
"materials": [
"Leather",
"Nylon"
],
"variations": [
{
"name": "Engraving Side",
"options": [
{
"id": "2705057689",
"label": "No Engraving"
},
{
"id": "2682504520",
"label": "Front Side Only"
},
{
"id": "2705057695",
"label": "Inside Left Only"
}
]
},
{
"name": "Color",
"options": [
{
"id": "2682504516",
"label": "Light Brown"
},
{
"id": "2705057691",
"label": "Coffee Brown"
},
{
"id": "2705057693",
"label": "Black"
}
]
}
],
"shipping": {
"origin_country": "US"
},
"shop": {
"id": "35016605",
"name": "PremiumEngrave",
"url": "https://www.etsy.com/shop/PremiumEngrave"
},
"favorites_count": 19378,
"listed_on": "2026-11-12"
},
"meta": {
"endpoint_family": "etsy-listing",
"attempts": 1,
"request_id": "req_cef5a95241574a968fd0fb23440aff7d",
"credits_charged": 10,
"credits_remaining": 1934
}
}Sample data
What one call returns
A recorded run of product: the fields and shapes you will get, shortened to 3 items.
| # | urlurl | thumbnailurl |
|---|---|---|
| 1 | https://i.etsystatic.com/35016605/r/il/a5f633/4007318605/il_fullxfull.4007318605_mj36.jpg | https://i.etsystatic.com/35016605/r/il/a5f633/4007318605/il_340x270.4007318605_mj36.jpg |
| 2 | https://i.etsystatic.com/35016605/r/il/4ca749/3959645938/il_fullxfull.3959645938_mdoe.jpg | https://i.etsystatic.com/35016605/r/il/4ca749/3959645938/il_340x270.3959645938_mdoe.jpg |
| 3 | https://i.etsystatic.com/35016605/r/il/1e93ec/4668917675/il_fullxfull.4668917675_aqlz.jpg | https://i.etsystatic.com/35016605/r/il/1e93ec/4668917675/il_340x270.4668917675_aqlz.jpg |
[
{
"url": "https://i.etsystatic.com/35016605/r/il/a5f633/4007318605/il_fullxfull.4007318605_mj36.jpg",
"thumbnail": "https://i.etsystatic.com/35016605/r/il/a5f633/4007318605/il_340x270.4007318605_mj36.jpg"
},
{
"url": "https://i.etsystatic.com/35016605/r/il/4ca749/3959645938/il_fullxfull.3959645938_mdoe.jpg",
"thumbnail": "https://i.etsystatic.com/35016605/r/il/4ca749/3959645938/il_340x270.3959645938_mdoe.jpg"
},
{
"url": "https://i.etsystatic.com/35016605/r/il/1e93ec/4668917675/il_fullxfull.4668917675_aqlz.jpg",
"thumbnail": "https://i.etsystatic.com/35016605/r/il/1e93ec/4668917675/il_340x270.4668917675_aqlz.jpg"
}
]url,thumbnail https://i.etsystatic.com/35016605/r/il/a5f633/4007318605/il_fullxfull.4007318605_mj36.jpg,https://i.etsystatic.com/35016605/r/il/a5f633/4007318605/il_340x270.4007318605_mj36.jpg https://i.etsystatic.com/35016605/r/il/4ca749/3959645938/il_fullxfull.3959645938_mdoe.jpg,https://i.etsystatic.com/35016605/r/il/4ca749/3959645938/il_340x270.3959645938_mdoe.jpg https://i.etsystatic.com/35016605/r/il/1e93ec/4668917675/il_fullxfull.4668917675_aqlz.jpg,https://i.etsystatic.com/35016605/r/il/1e93ec/4668917675/il_340x270.4668917675_aqlz.jpg
Recorded from our API · 3 items shown · 2 datapoints per itemGET /v1/etsy/product?listing_id=1241528786
2 datapoints
Contact
- urlurl
Other
- thumbnailurl
Playground
Run this API
curl "https://api.perceptlayer.com/v1/etsy/product?listing_id=1241528786" \
-H "X-API-Key: $API_KEY"Etsy · 1 endpoint
Endpoints
Every endpoint takes the same key. Open one for its parameters and an example request.
| Endpoint | Required parameters | Cost |
|---|---|---|
GET/v1/etsy/product | none+2 optional | 10 credits |
Overview
About the Etsy API
What you can get
The Etsy API returns Etsy listing data as JSON through 1 endpoint.
- Listings:
producttakes alisting_idor a listingurl.
The recorded listing returns listing_id, url, title, description, category, price (current, original, discount_percent and currency), availability, quantity_available, rating, images (each with url and thumbnail), materials, variations (each with a name and its options), shipping with origin_country, shop (id, name and url), favorites_count and listed_on.
How a call works
Look up a listing: GET /v1/etsy/product?listing_id=1241528786 with your key in the X-API-Key header. The listing_id is the number in the listing's URL, or pass the whole url instead. The response's shop gives the shop's id, name and url. Every successful call costs 10 credits; failed calls cost nothing.
More marketplaces APIs
Use cases
Track prices and discounts for a list of Etsy listings
Use the Etsy API to track prices and discounts for a list of Etsy listingsWatch stock with `quantity_available`
Use the Etsy API to watch stock with `quantity_available`Compare variations and materials across similar listings
Use the Etsy API to compare variations and materials across similar listingsFollow listing popularity through `favorites_count`
Use the Etsy API to follow listing popularity through `favorites_count`FAQ
Questions
How much does the Etsy API cost?
Each successful `product` call costs 10 credits; failed calls cost nothing. New accounts get free credits to start, and credit packs bring the price down as you scale.
Can I pass a listing URL instead of an id?
Yes. `product` takes either a `listing_id` or the listing's `url`.
Do I need an Etsy account?
No. You call this Etsy API with your Perceptlayer key in the `X-API-Key` header, with no Etsy login.
What format are responses in?
Every endpoint returns JSON, with no HTML parsing on your side.
Should I build an Etsy scraper instead?
You can, but an Etsy scraper is code you maintain: page changes break it, requests get blocked, and Etsy's terms govern how you collect data. The Etsy API gives you 1 endpoint of named JSON fields for 10 credits per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.
Try the Etsy API with 100 free credits
No credit card. Failed calls are never billed.