Etsy API Python Client

Extract Etsy data with our Etsy API Python client. Get programmatic access to seller information, variations, highlights, product details including images, pricing, and more using simple Python code. Start free, no credit card required.

Try Etsy API Python Client

Trusted by industry leaders all over the world

Integrate our Etsy API

The Apify API client for Python is the official library that allows you to use Etsy API in Python, providing convenience functions and automatic retries on errors. Get started with simple pip installation and robust error handling built-in.

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

Etsy API in JavaScript

Etsy MCP server

Etsy API in CLI

Get data with Etsy API Python client

Use our Python API client to extract Etsy data by providing search keywords, product URLs, category URLs, or store URLs. The API returns structured data, including 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

Install Apify Python client02

Install the Apify Python client using pip: pip install apify-client. This package provides a simple interface to interact with Etsy API from your Python applications.

Get your Apify API token03

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 Etsy API04

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. Use the provided Python code examples to integrate Etsy API into your Python application.

Open Etsy Python API

Get your Etsy data via API05

The Etsy API returns structured JSON data that works perfectly with pandas, NumPy, and other Python data analysis libraries.

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!

Python-ready Etsy data extraction

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, Etsy does not provide an official Python API client. That's why the Etsy Data Extractor actor serves as a crucial bridge to access Etsy's marketplace data. This Python scraper fills the gap by providing comprehensive access to product listings, search results, and category data that would otherwise be unavailable through official Python API channels.

Yes, you can try the Etsy Python API client for free using Apify's free tier. The Python client 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 using Python 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 Python API client 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 using a Python API client, 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 Python API client is designed to operate ethically within these guidelines.

Getting started with our Etsy Python API is easy — simply create a free Apify account, get your API token, and start using the Etsy API in Python, JavaScript, CLI, cURL, OpenAPI, or MCP.