Skip to content
All sites
Data API

Etsy Data API

Structured JSON data, on demand, with anti-bot bypass built in.

4 endpointsDataDome · Rate Limit handled for you
etsy.comGET/etsy/productGET/etsy/product/…GET/etsy/search{ } JSON
Example (captured live) Open playground
etsy.com
Example
JSON responseclick the page to trace a field
{
"query": "ceramic mug",
"category": "home-and-living",
"sort": "most_relevant",
"page": 1,
"min_price": 20,
"max_price": 60,
"market": "us",
"source": "search",
"url": "https://www.etsy.com/search/home-and-living?q=ceramic+mug&min=20&max=60",
"currency": "USD",
"total_results": 495416,
"total_pages": 20,
"results": [
{
"listing_id": "4296141840",
"title": "Coffee Mug - KJ Pottery",
"url": "https://www.etsy.com/listing/4296141840/coffee-mug-kj-pottery",
"image": "https://i.etsystatic.com/7825028/r/il/553467/6863380541/il_255x319.6863380541_5poq.jpg",
"price": 60,
"currency": "USD",
"currency_symbol": "$",
"original_price": null,
"discount_percent": null,
"shop_id": "7825028",
"shop_name": "KJPottery",
"shop_rating": 4.9,
"shop_review_count": 3500,
"is_ad": true,
"free_shipping": true,
"badges": [
"Popular now",
"Star Seller"
],
"availability": null,
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "1510223855",
"title": "The Libby Travel Mug hand thrown ceramic mug cup Pottery Travel Mug Cup with attached lid fits in cup holder",
"url": "https://www.etsy.com/listing/1510223855/the-libby-travel-mug-hand-thrown-ceramic",
"image": "https://i.etsystatic.com/8740835/r/il/d4f720/7239142492/il_255x319.7239142492_oym6.jpg",
"price": 34.99,
"currency": "USD",
"currency_symbol": "$",
"original_price": null,
"discount_percent": null,
"shop_id": "8740835",
"shop_name": "StonehousePotteryOH",
"shop_rating": 4.9,
"shop_review_count": 17000,
"is_ad": false,
"free_shipping": false,
"badges": [
"Popular now"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "4568630405",
"title": "Hand Painted Birth Flower Mug, Personalized Birthday Month Flower Cup, Ceramic Floral Mug, Custom Gift for Her, Mom Sister Friend Gift",
"url": "https://www.etsy.com/listing/4568630405/hand-painted-birth-flower-mug",
"image": "https://i.etsystatic.com/58433132/r/il/03d3d2/8474934776/il_255x319.8474934776_aoif.jpg",
"price": 44.76,
"currency": "USD",
"currency_symbol": "$",
"original_price": 68.87,
"discount_percent": 35,
"shop_id": "58433132",
"shop_name": "QuinnDesignsShow",
"shop_rating": 4.9,
"shop_review_count": 71,
"is_ad": false,
"free_shipping": false,
"badges": [
"Popular now",
"Star Seller"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "4575689601",
"title": "Custom Handmade Face Mug From Photo, Underglaze Painting, Couple Mug, Gift for Her",
"url": "https://www.etsy.com/listing/4575689601/custom-handmade-face-mug-from-photo",
"image": "https://i.etsystatic.com/65125655/r/il/382fca/8574464303/il_255x319.8574464303_k8r6.jpg",
"price": 46.59,
"currency": "USD",
"currency_symbol": "$",
"original_price": 75.15,
"discount_percent": 38,
"shop_id": "65125655",
"shop_name": "CeraLumi",
"shop_rating": 5,
"shop_review_count": 96,
"is_ad": false,
"free_shipping": true,
"badges": [
"Popular now"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "4505572813",
"title": "Striped Travel Tumbler, To Go Ceramic Tumbler, Handmade Pottery Mug, Hand-painted Sip Mug, Travel Mug Coffee Cup Unique Gift for Her",
"url": "https://www.etsy.com/listing/4505572813/striped-travel-tumbler-to-go-ceramic",
"image": "https://i.etsystatic.com/56797836/r/il/c18efa/8022358654/il_255x319.8022358654_pen3.jpg",
"price": 33.78,
"currency": "USD",
"currency_symbol": "$",
"original_price": 56.3,
"discount_percent": 40,
"shop_id": "56797836",
"shop_name": "AbbyLimworkshop",
"shop_rating": 4.8,
"shop_review_count": 929,
"is_ad": false,
"free_shipping": true,
"badges": [
"Popular now"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "4454102093",
"title": "Handmade Face Mug – Whimsical Ceramic Coffee Cup",
"url": "https://www.etsy.com/listing/4454102093/handmade-face-mug-whimsical-ceramic",
"image": "https://i.etsystatic.com/57255580/r/il/046964/7686296440/il_255x319.7686296440_to77.jpg",
"price": 36.53,
"currency": "USD",
"currency_symbol": "$",
"original_price": null,
"discount_percent": null,
"shop_id": "57255580",
"shop_name": "TheStudioHL",
"shop_rating": 4.9,
"shop_review_count": 501,
"is_ad": false,
"free_shipping": false,
"badges": [
"Popular now",
"Star Seller"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "1702915637",
"title": "Solstice Mug: Handmade Pottery Mug with Sun Design, Ceramic Coffee Cup in a Variety of Colors",
"url": "https://www.etsy.com/listing/1702915637/solstice-mug-handmade-pottery-mug-with",
"image": "https://i.etsystatic.com/19096197/r/il/00b10c/5918841167/il_255x319.5918841167_7pog.jpg",
"price": 34.87,
"currency": "USD",
"currency_symbol": "$",
"original_price": 38.75,
"discount_percent": 10,
"shop_id": "19096197",
"shop_name": "ShorProducts",
"shop_rating": 5,
"shop_review_count": 1100,
"is_ad": false,
"free_shipping": false,
"badges": [
"Popular now"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "4445911318",
"title": "Striped Ceramic Travel Mug, Custom Name To Go Mug, Handmade Pottery Coffee Mug, Personalized Sippy Mug, Christmas Gift, Bridesmaid Gifts",
"url": "https://www.etsy.com/listing/4445911318/handmade-striped-ceramic-travel-mug-half",
"image": "https://i.etsystatic.com/61275726/r/il/6abf4e/7680722691/il_255x319.7680722691_if3b.jpg",
"price": 35.58,
"currency": "USD",
"currency_symbol": "$",
"original_price": 79.06,
"discount_percent": 55,
"shop_id": "61275726",
"shop_name": "ThienCeramicArtShop",
"shop_rating": 4.9,
"shop_review_count": 397,
"is_ad": false,
"free_shipping": true,
"badges": [
"Popular now",
"Star Seller"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "4317740783",
"title": "Handmade Ceramic Coffee Mugs: Rustic Earth Tone Mug , 12 oz Latte Pottery Cup",
"url": "https://www.etsy.com/listing/4317740783/handmade-ceramic-large-coffee-mug-rustic",
"image": "https://i.etsystatic.com/39354200/r/il/420f97/8122188843/il_255x319.8122188843_kwfp.jpg",
"price": 59.01,
"currency": "USD",
"currency_symbol": "$",
"original_price": null,
"discount_percent": null,
"shop_id": "39354200",
"shop_name": "AnaArtBoutiquestudio",
"shop_rating": 5,
"shop_review_count": 594,
"is_ad": false,
"free_shipping": false,
"badges": [
"Popular now",
"Star Seller"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "223435012",
"title": "Handmade Ceramic Travel Tumbler – Stoneware Mug with Pressed Leaves",
"url": "https://www.etsy.com/listing/223435012/handmade-ceramic-travel-tumbler",
"image": "https://i.etsystatic.com/9103903/r/il/f8a41b/3087870498/il_255x319.3087870498_pj53.jpg",
"price": 48,
"currency": "USD",
"currency_symbol": "$",
"original_price": null,
"discount_percent": null,
"shop_id": "9103903",
"shop_name": "3PointsPottery",
"shop_rating": 4.9,
"shop_review_count": 4300,
"is_ad": false,
"free_shipping": true,
"badges": [
"Bestseller",
"Star Seller"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "4594960067",
"title": "Minimalist Cherry Ceramic Travel Mug – Half Lid, Reusable Coffee Cup (Gift for Her)",
"url": "https://www.etsy.com/listing/4594960067/minimalist-cherry-ceramic-travel-mug",
"image": "https://i.etsystatic.com/67449216/r/il/a599c6/8722137079/il_255x319.8722137079_si6r.jpg",
"price": 26.11,
"currency": "USD",
"currency_symbol": "$",
"original_price": 52.22,
"discount_percent": 50,
"shop_id": "67449216",
"shop_name": "PlayingBallShop",
"shop_rating": 4.8,
"shop_review_count": 13,
"is_ad": false,
"free_shipping": false,
"badges": [
"Popular now"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
},
{
"listing_id": "1383695867",
"title": "18-22oz. Purple mug cup handmade pottery",
"url": "https://www.etsy.com/listing/1383695867/18-20oz-purple-mug-cup-handmade-pottery",
"image": "https://i.etsystatic.com/17907627/r/il/c3f107/5524998849/il_255x319.5524998849_ortr.jpg",
"price": 30,
"currency": "USD",
"currency_symbol": "$",
"original_price": null,
"discount_percent": null,
"shop_id": "17907627",
"shop_name": "RobLindsayPottery",
"shop_rating": 4.9,
"shop_review_count": 1100,
"is_ad": false,
"free_shipping": false,
"badges": [
"Popular now"
],
"availability": "InStock",
"scraped_at": "2026-11-19T10:50:49.602713+00:00"
}
],
"page_listing_ids": [
"1510223855",
"4568630405",
"4575689601",
"4505572813",
"4454102093",
"1702915637",
"4445911318",
"4317740783",
"223435012",
"4594960067",
"1383695867",
"4617238295"
]
}
GET/v1/etsy/search1 credit / run Verified

Search Listings

Search Etsy listings by keyword, optionally inside a category, with sort and price filters. Returns the listing cards on the page (title, price, discount, image, shop, rating, ad flag) plus every listing id on that result page.

Handled for you:DataDomeRate Limit
Parameters
NameTypeReqDescription
querystringyesSearch keywords, e.g. 'ceramic mug'.
Advanced filters
categorystringnoCategory path to search inside, e.g. 'home-and-living' or 'jewelry/rings'.
sortstringnoResult order. (default: most_relevant)
min_pricenumbernoOnly listings priced at or above this amount (market currency).
max_pricenumbernoOnly listings priced at or below this amount (market currency).
pageintegernoResult page (48 listings per page on Etsy). (default: 1)
marketstringnoEtsy storefront. Sets the price currency. (default: us)