Etsy Discover by Keyword

🧭 Overview

The Etsy Discover by Keyword Actor allows you to fetch structured product listings from Etsy using keyword-based discovery. It's perfect for developers, marketers, and data analysts seeking up-to-date e-commerce insights across Etsy's marketplace.

🎯 Why choose this actor?

Unlike general search APIs, this Actor focuses specifically on Etsy and gives you direct access to high-quality product metadata, seller details, category hierarchies, and visual content. This makes it a valuable tool for product research, competitor analysis, and price intelligence—without needing proxies or custom scraping logic.

🔍 Use Cases

• Track top-selling or trending products by niche keyword.
• Monitor competitors in Etsy categories.
• Build a database of products for affiliate marketing.
• Analyze product pricing and discounting strategies.
• Explore visual trends via product images and reviews.

🛠 Key Features

• No proxy setup required.
• Fetch multiple listings per keyword with clean metadata.
• Includes product variations, reviews, images, seller links, and more.
• High-resolution images + review photos available.
• Fast execution with clean structured output.

🔄 How It Works

You provide one or more keywords (e.g., "dog collar", "vintage lamp"), and the Actor scrapes relevant listings from Etsy’s search results. For each listing, it extracts details like price, rating, variations, seller info, and reviews. You can configure the number of results per keyword with the max_results_per_input parameter.

🧾 Input Parameters

Field	Type	Description	Example
keywords	array	List of keywords to search on Etsy.	["dog collar", "vintage lamp"]
max_results_per_input	integer	Number of results per keyword. Must be multiple of 10.	20

📦 Output (Full Example)

{
  "title": "Personalized Dog Collar | Customized | Personalize | Custom | Tribal",
  "product_id": "692233213",
  "url": "https://www.etsy.com/listing/692233213/personalized-dog-collar-customized",
  "final_price": 19.02,
  "initial_price": 19.02,
  "discount_percentage": 0,
  "currency": "USD",
  "rating": 5,
  "reviews_count_shop": 14465,
  "reviews_count_item": 0,
  "seller_name": "John Doe",
  "seller_shop_name": "SampleShopName",
  "seller_shop_url": "https://www.etsy.com/shop/SampleShopName",
  "breadcrumbs": [
    {
      "name": "Pet Supplies",
      "url": "https://www.etsy.com/c/pet-supplies"
    },
    {
      "name": "Pet Collars & Leashes",
      "url": "https://www.etsy.com/c/pet-supplies/pet-collars-and-leashes"
    }
  ],
  "category_tree": [
    "Pet Supplies",
    "Pet Collars & Leashes"
  ],
  "root_category": "Pet Collars & Leashes",
  "images": [
    "https://example.com/image1.jpg",
    "https://example.com/image2.jpg"
  ],
  "photos_from_reviews": [
    "https://example.com/review_photo1.jpg"
  ],
  "top_reviews": [
    {
      "reviewr_name": "Jane D.",
      "date": "2025-07-20",
      "the_review": "Amazing product!",
      "rating": 5
    }
  ],
  "item_details": [
    "High-quality, vibrant collars with engraved labels."
  ],
  "product_specifications": [
    {
      "specification_name": "Size",
      "specification_values": "Small, Medium, Large"
    }
  ],
  "variation": [
    {
      "type": "Pattern",
      "value": "Select an option"
    }
  ],
  "variations": [
    {
      "type": "Size",
      "value": [
        "Small ($21.30)",
        "Medium ($24.35)"
      ]
    }
  ],
  "videos": [
    "https://example.com/video.mp4"
  ],
  "variation_url": "https://www.etsy.com/listing/sample-variation-url",
  "shipping_return_policies": [
    "Free shipping",
    "No returns accepted"
  ],
  "input": {
    "url": "https://www.etsy.com/sample-product"
  },
  "discovery_input": {
    "keywords": "dog collar"
  },
  "timestamp": "2025-07-21T06:49:26.167Z"
}

💵 Pricing

• Free User: First 10 results per keyword.
• Pay-as-you-go: $2.50 per 1,000 results.

⚠️ Legal Disclaimer

This Actor is designed for ethical and lawful use. You are solely responsible for ensuring compliance with Etsy’s Terms of Service and relevant data privacy regulations.

🔁 Update Policy

We maintain this Actor regularly to ensure compatibility with Etsy’s frontend structure. Breaking changes in Etsy’s layout may temporarily affect scraping performance.

❓ FAQ

Does this actor require proxies?
NO — THIS ACTOR DOES NOT USE PROXIES.

How many results can I retrieve?
You can request any number of results, but results will always round up to the nearest multiple of 10.

Are there any free usage limits?
Yes. ONLY 10 RESULTS ARE FREE IF YOU ARE A FREE USER.

Does it scrape email addresses?
No, this Actor does not extract emails or contact details.

Can I use it for commercial product research?
Yes, this Actor is ideal for eCommerce intelligence and market research.

Does it work with Etsy Germany or other locales?
Yes. Results are retrieved regardless of domain version (etsy.com, etsy.de, etc.).