Etsy API

Our Etsy API gives you programmatic access to Etsy data that isn't available through any official API. Get data on Product details including images, seller information, pricing, variations, highlights, and more. And the best part? You can try the Etsy API entirely for free, no credit card required.

Try Etsy API

Trusted by industry leaders all over the world

Integrate our Etsy API

Access the Etsy API using Python, JavaScript, CLI, cURL, OpenAPI, or MCP. Choose your preferred option and start extracting Etsy data in minutes.

Python

JavaScript

HTTP

MCP

1from apify_client import ApifyClient
2
3# Initialize the ApifyClient with your Apify API token
4# Replace '<YOUR_API_TOKEN>' with your token.
5client = ApifyClient("<YOUR_API_TOKEN>")
6
7# Prepare the Actor input
8run_input = {
9    "startUrls": [
10        "https://www.etsy.com/listing/743657804/sheepskin-slippers-wool-slippers-fur?ga_order=most_relevant&ga_search_type=all&ga_view_type=gallery&ga_search_query=&ref=sc_gallery-5-1&plkey=89e47f49c28602795b44fc71559e2839056339d8%3A743657804&frs=1",
11        "https://www.etsy.com/c/clothing-and-shoes?ref=catnav-10923",
12        "https://www.etsy.com/search?q=apple%20watch",
13        "https://www.etsy.com/shop/PetiteFraise?ref=simple-shop-header-name&listing_id=490831663&page=2#items",
14    ],
15    "maxItems": 10,
16    "endPage": 1,
17    "extendOutputFunction": """($) => {
18    const result = {};
19    // Uncomment to add a title to the output
20    // result.title = $('title').text().trim();
21
22    return result;
23}""",
24    "customMapFunction": "(object) => { return {...object} }",
25    "proxy": {
26        "useApifyProxy": True,
27        "apifyProxyGroups": ["RESIDENTIAL"],
28    },
29}
30
31# Run the Actor and wait for it to finish
32run = client.actor("epctex/etsy-scraper").call(run_input=run_input)
33
34# Fetch and print Actor results from the run's dataset (if there are any)
35print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
36for item in client.dataset(run["defaultDatasetId"]).iterate_items():
37    print(item)
38
39# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

Etsy API in Python

Etsy API in JavaScript

Etsy MCP server

Etsy API in CLI

Get data with Etsy API

Extract Etsy data by providing search keywords, product URLs, category URLs, or store URLs. The Etsy Scraper returns structured JSON data with product names, images, seller details, pricing, variations, reviews, listing dates, and related searches.

Input

{
 "search": "apple watch",
 "endPage": 6,
 "maxItems": 100,
 "startUrls": [
  "<https://www.etsy.com/c/clothing-and-shoes?ref=pagination&page=4>"
 ],
 "includeDescription": true
}

Output

{
 "url": "<https://www.etsy.com/listing/498417899/edc-slim-valet-personalized-pocket?ga_order=most_relevant&ga_search_type=all&ga_view_type=gallery&ga_search_query=&ref=sr_gallery-4-29&frs=1&cns=1&col=1>",
 "name": "EDC Slim Valet - Personalized Pocket Organizer, Handmade in the USA\\nRegions Etsy does business in:",
 "Price": "$49.00+",
 "images": [
  "<https://i.etsystatic.com/13963159/r/il/3d1876/3180744258/il_794xN.3180744258_olzc.jpg>",
  "<https://i.etsystatic.com/13963159/r/il/a3c7cf/1617748881/il_794xN.1617748881_1o26.jpg>",
  "<https://i.etsystatic.com/13963159/r/il/9eb645/1570294448/il_794xN.1570294448_oe8w.jpg>",
  "<https://i.etsystatic.com/13963159/r/il/6b2a6a/1570293332/il_794xN.1570293332_8z6i.jpg>",
  "<https://i.etsystatic.com/13963159/r/il/39f7ad/3180744724/il_794xN.3180744724_2baa.jpg>",
  "<https://i.etsystatic.com/13963159/r/il/08b20b/3180745230/il_794xN.3180745230_95a2.jpg>",
  "<https://i.etsystatic.com/13963159/r/il/31e60f/3494515703/il_794xN.3494515703_54ci.jpg>",
  "<https://i.etsystatic.com/13963159/r/il/352b64/3458390857/il_794xN.3458390857_4ity.jpg>"
 ],
 "seller": {
  "url": "<https://www.etsy.com/uk/shop/OnMyWristCo?ref=shop-header-name&listing_id=1515784194&from_page=listing>",
  "name": "OnMyWristCo",
  "rating": 3.9179,
  "numberOfReviews": 12000
 },
 "listedOn": "Dec 26, 2022",
 "favorites": 806,
 "highlights": [
  "Handmade",
  "Materials: leather, metal rivets"
 ],
 "variations": [
  {
   "label": "Color",
   "values": [
    "Dark Chocolate",
    "Mahogany",
    "Cordovan"
   ]
  },
  {
   "label": "Personalize / Monogram",
   "values": [
    "None ($49.00)",
    "Monogram ($59.00)"
   ]
  }
 ],
 "numberOfReviews": 78,
 "relatedSearches": [
  {
   "link": "<https://www.etsy.com/market/edc_pocket_organizer?ref=seller_tag_bottom_image-0>",
   "name": "EDC Pocket Organizer"
  },
  {
   "link": "<https://www.etsy.com/market/edc_wallet?ref=seller_tag_bottom_image-1>",
   "name": "EDC Wallet"
  },
  {
   "link": "<https://www.etsy.com/market/edc_organizer?ref=seller_tag_bottom_image-2>",
   "name": "EDC Organizer"
  },
  {
   "link": "<https://www.etsy.com/market/edc_pocket?ref=seller_tag_bottom_image-3>",
   "name": "EDC Pocket"
  },
  {
   "link": "<https://www.etsy.com/market/everyday_carry_gear?ref=seller_tag_bottom_image-4>",
   "name": "Everyday Carry Gear"
  },
  {
   "link": "<https://www.etsy.com/market/pocket_organizer?ref=seller_tag_bottom_image-5>",
   "name": "Pocket Organizer"
  },
  {
   "link": "<https://www.etsy.com/market/leather_organizer?ref=seller_tag_bottom_image-6>",
   "name": "Leather Organizer"
  },
  {
   "link": "<https://www.etsy.com/market/edc?ref=seller_tag_bottom_image-7>",
   "name": "EDC"
  },
  {
   "link": "<https://www.etsy.com/market/edc_gear?ref=seller_tag_bottom_image-8>",
   "name": "EDC Gear"
  },
  {
   "link": "<https://www.etsy.com/market/minimalist_edc?ref=seller_tag_bottom_image-9>",
   "name": "Minimalist EDC"
  },
  {
   "link": "<https://www.etsy.com/market/gift_for_men?ref=seller_tag_bottom_image-10>",
   "name": "Gift for Men"
  },
  {
   "link": "<https://www.etsy.com/market/holiday_gift?ref=seller_tag_bottom_image-11>",
   "name": "Holiday Gift"
  },
  {
   "link": "<https://www.etsy.com/market/rutsu_designs?ref=seller_tag_bottom_text-0>",
   "name": "Rutsu Designs"
  }
 ]
}

How to use Etsy API

Sign up for Apify account01

Creating an account is quick and free — no credit card required. Your account gives you access to more than 5,000 scrapers and APIs.

Get started for free

Get your Apify API token02

Go to settings in the Apify console and navigate to the “API & Integrations” tab. There, create a new token and save it for later.

Integrate Google Trends API03

Navigate to the Etsy API page and click on the API dropdown menu in the top right corner. In the dropdown menu, you can see API clients, API endpoints, and more.

Open Etsy API

Get your Etsy data via API04

Now, you can use the API and get the data you need from Etsy.

Why use Apify?

Never get blocked

Every plan (free included) comes with Apify Proxy, which is great for avoiding blocking and giving you access to geo-specific content.

Customers love us

We truly care about the satisfaction of our users and thanks to that we're one of the best-rated data extraction platforms on both G2 and Capterra.

Monitor your runs

With our latest monitoring features, you always have immediate access to valuable insights on the status of your web scraping tasks.

Export to various formats

Your datasets can be exported to any format that suits your data workflow, including Excel, CSV, JSON, XML, HTML table, JSONL, and RSS.

Integrate Apify to your workflow

You can integrate your Apify runs with platforms such as Zapier, Make, Keboola, Google Drive, or GitHub. Connect with practically any cloud service or web app.

Large developer community

Apify is built by developers, so you'll be in good hands if you have any technical questions. Our Discord server is always here to help!

Get AI-ready Etsy data via API

Connect to hundreds of apps right away using ready-made integrations, or set up your own with webhooks and our API.

Frequently asked questions

No, there is no official Etsy API available. That's why the Etsy Data Extractor actor serves as a crucial bridge to access Etsy's marketplace data. This scraper fills the gap by providing comprehensive access to product listings, search results, and category data that would otherwise be unavailable through official channels.

Yes, you can try the Etsy API scraper for free using Apify's free tier. The actor is optimized to run efficiently - it can scrape approximately 50 products in 1 minute using only ~0.04-0.05 compute units. You can start with small scraping jobs to test the functionality before scaling up your data extraction needs.

You can extract comprehensive product data including product names, URLs, images, seller information (name, URL, reviews, ratings), pricing, product variations, highlights, materials, listing dates, number of favorites, reviews count, and related search suggestions. The scraper also supports optional description HTML/text extraction and allows custom filtering through category URLs.

Yes, it is generally legal to scrape public data from Etsy, but you must adhere to Etsy's terms of service and conduct scraping responsibly. Avoid making excessive server requests, respect rate limits, and ensure compliance with personal data privacy regulations. The scraper is designed to operate ethically within these guidelines.

Getting started is simple: create an Apify account, input your target URLs or search keywords into the actor configuration, set optional parameters like maximum pages or items to scrape, configure proxy settings, and run the actor. You can use product URLs, category URLs, search terms, or store URLs as starting points for your data extraction.