EXAMPLE OUTPUT

See the data

Saved sample
urlhttps://www.etsy.com/uk/listing/751685489/set-of-two-unique-ceramic-mugs-handmade
product_id751685489
nameSet of two unique ceramic mugs || Handmade pottery mugs with leaf impressions, Leaf mugs, coffee mugs for gardener lovers, Clay nature mugs
price88.36
currencyGBP
in_stocktrue
sku751685489
categoryHome & Living < Kitchen & Dining < Drink & Bar Accessories < Drinkware < Mugs
breadcrumbs[ "Home & Living", "Kitchen & Dining", "Drink & Bar Accessories", "Drinkware", "Mugs" ]
breadcrumb_urls
[ "https://www.etsy.com/uk/c/home-and-living?explicit=1&ref=breadcrumb_listing", "https://www.etsy.com/uk/c/home-and-living/kitchen-and-dining?explicit=1&ref=breadcrumb_listing…
[
  "https://www.etsy.com/uk/c/home-and-living?explicit=1&ref=breadcrumb_listing",
  "https://www.etsy.com/uk/c/home-and-living/kitchen-and-dining?explicit=1&ref=breadcrumb_listing",
  "https://www.etsy.com/uk/c/home-and-living/kitchen-and-dining/drink-and-barware?explicit=1&ref=breadcrumb_listing",
  "https://www.etsy.com/uk/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware?explicit=1&ref=breadcrumb_listing",
  "https://www.etsy.com/uk/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware/mugs?explicit=1&ref=breadcrumb_listing"
]
main_imagehttps://i.etsystatic.com/18944861/r/il/93afa5/2077372526/il_fullxfull.2077372526_kik6.jpg
images
[ "https://i.etsystatic.com/18944861/r/il/93afa5/2077372526/il_fullxfull.2077372526_kik6.jpg", "https://i.etsystatic.com/18944861/r/il/828b66/2077374472/il_fullxfull.2077374472…
[
  "https://i.etsystatic.com/18944861/r/il/93afa5/2077372526/il_fullxfull.2077372526_kik6.jpg",
  "https://i.etsystatic.com/18944861/r/il/828b66/2077374472/il_fullxfull.2077374472_9k52.jpg",
  "https://i.etsystatic.com/18944861/r/il/273b53/2077372720/il_fullxfull.2077372720_b2md.jpg",
  "https://i.etsystatic.com/18944861/r/il/c45516/2077372884/il_fullxfull.2077372884_p5yk.jpg",
  "https://i.etsystatic.com/18944861/r/il/0d2ffb/2077372372/il_fullxfull.2077372372_9ds5.jpg",
  "https://i.etsystatic.com/18944861/r/il/e7e793/2077371426/il_fullxfull.2077371426_axcy.jpg",
  "https://i.etsystatic.com/18944861/r/il/9f8b36/2124933627/il_fullxfull.2124933627_l690.jpg",
  "https://i.etsystatic.com/18944861/r/il/0227f3/2077371138/il_fullxfull.2077371138_t9lj.jpg",
  "https://i.etsystatic.com/18944861/r/il/5a7a9a/2124933809/il_fullxfull.2124933809_nhmn.jpg"
]
descriptionHand-wash only! NOT DISHWASHER SAFE! Impressions may be slightly different! MICROWAVE SAFE. Set of two unique ceramic mugs. Capacity: 13.3 fluid ounces the shape of mugs and impressions may be slightly different!
description_html
<p>Hand-wash only! NOT DISHWASHER SAFE! Impressions may be slightly different! MICROWAVE SAFE. Set of two unique ceramic mugs. Capacity: 13.3 fluid ounces the shape of mugs and…
<p>Hand-wash only! NOT DISHWASHER SAFE! 
Impressions may be slightly different! 
MICROWAVE SAFE.

Set of two unique ceramic mugs.
Capacity: 13.3 fluid ounces

the shape of mugs and impressions may be slightly different!</p>
materialCeramic
rating_value5
review_count8
seller_nameMagicCeramicsShop
seller_urlhttps://www.etsy.com/uk/shop/MagicCeramicsShop
seller_addressUkraine
canonical_urlhttps://www.etsy.com/uk/listing/751685489/set-of-two-unique-ceramic-mugs-handmade
scraped_at2026-08-20T17:32:37.099Z

Collect structured marketplace listing data from Etsy product and category URLs.

Issues and feature requests

If you encounter an issue or need a field added, open an issue on the Actor page or write to hello@123webdata.com.

Output Example (simplified)

The overview shows the most useful fields in a table. Product images are displayed as thumbnails when the website provides them.

Image Product URL Product ID Product name Current price Regular price Currency In stock Seller Scraped at
https://www.etsy.com/uk/listing/751685489/set-of-two-unique-ceramic-mugs-handmade 751685489 Set of two unique ceramic mugs || Handmade pottery mugs with leaf impressions, Leaf mugs, coffee mugs for gardener lovers, Clay nature mugs 88.36 GBP true MagicCeramicsShop 2026-08-20T17:32:37.099Z

How to scrape supported list pages

This Actor accepts individual product links in productUrls. It accepts category pages in categoryUrls.

  1. Open a supported list page in your browser.
  2. Choose a category you need.
  3. Copy the final URL from the address bar and paste it into categoryUrls.

The Actor follows the products shown on that page.

Features

  • Scrapes detailed handmade, vintage, and marketplace listing information from Etsy product pages
  • Accepts individual product URLs and category pages
  • Lets you limit the number of saved products and choose whether to continue through additional result pages
  • Returns structured prices and availability, listing images and descriptions, and seller and review details for viewing, export, and analysis

Pricing

This Actor uses pay-per-event pricing. Its running costs are included.

  • Actor start: $0.03 once per run — One fixed charge for starting a run.
  • Result: $0.00099 each ($0.99 per 1,000) — A product record collected directly from a supported list page.
  • Product detail: $0.00399 each ($3.99 per 1,000) — A full product record collected from its product page.

The start charge applies once per run. Each saved product is charged either as a Result or a Product detail, never both.

Results in one run Result Product detail
100 $0.13 $0.43
1,000 $1.02 $4.02

Apify's Free plan currently includes $5 in monthly usage credits. If the full $5 is available for this Actor, one run covers about 5,020 Results or 1,245 Product details. Other Apify usage reduces the available credit.

Input

The Actor accepts the following input parameters:

Field Type Description
productUrls array Product URLs to scrape
categoryUrls array Supported list pages: category pages
maxResultsPerScrape integer Maximum number of product records to save
usePagination boolean Whether to continue through additional result pages
scrapeProductDetails boolean Enabled returns Product detail records with the product-page fields listed below. Disabled returns Result records with the list-level fields.

What data you get in each mode

Every saved product is stored as one record. scrapeProductDetails decides which mode you receive; the lists below name every field each mode can return. A field is empty when the website does not show that information.

Result

A list-level product record with 15 declared fields:

url, product_id, name, price, regular_price, currency, sku, main_image, images, rating_value, review_count, seller_name, badges, canonical_url, scraped_at

Product detail

A full product record with 23 declared fields:

url, product_id, name, price, currency, in_stock, sku, category, breadcrumbs, breadcrumb_urls, main_image, images, description, description_html, material, rating_value, review_count, seller_name, seller_url, seller_address, canonical_url, scraped_at, badges

Output Example (full)

The Actor stores one structured record per product. Card-only records contain only fields available on the list; detail-only fields are omitted.

{
  "url": "https://www.etsy.com/uk/listing/751685489/set-of-two-unique-ceramic-mugs-handmade",
  "product_id": "751685489",
  "name": "Set of two unique ceramic mugs || Handmade pottery mugs with leaf impressions, Leaf mugs, coffee mugs for gardener lovers, Clay nature mugs",
  "price": 88.36,
  "currency": "GBP",
  "in_stock": true,
  "sku": "751685489",
  "category": "Home & Living < Kitchen & Dining < Drink & Bar Accessories < Drinkware < Mugs",
  "breadcrumbs": [
    "Home & Living",
    "Kitchen & Dining",
    "Drink & Bar Accessories",
    "Drinkware",
    "Mugs"
  ],
  "breadcrumb_urls": [
    "https://www.etsy.com/uk/c/home-and-living?explicit=1&ref=breadcrumb_listing",
    "https://www.etsy.com/uk/c/home-and-living/kitchen-and-dining?explicit=1&ref=breadcrumb_listing",
    "https://www.etsy.com/uk/c/home-and-living/kitchen-and-dining/drink-and-barware?explicit=1&ref=breadcrumb_listing",
    "https://www.etsy.com/uk/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware?explicit=1&ref=breadcrumb_listing",
    "https://www.etsy.com/uk/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware/mugs?explicit=1&ref=breadcrumb_listing"
  ],
  "main_image": "https://i.etsystatic.com/18944861/r/il/93afa5/2077372526/il_fullxfull.2077372526_kik6.jpg",
  "images": [
    "https://i.etsystatic.com/18944861/r/il/93afa5/2077372526/il_fullxfull.2077372526_kik6.jpg",
    "https://i.etsystatic.com/18944861/r/il/828b66/2077374472/il_fullxfull.2077374472_9k52.jpg",
    "https://i.etsystatic.com/18944861/r/il/273b53/2077372720/il_fullxfull.2077372720_b2md.jpg",
    "https://i.etsystatic.com/18944861/r/il/c45516/2077372884/il_fullxfull.2077372884_p5yk.jpg",
    "https://i.etsystatic.com/18944861/r/il/0d2ffb/2077372372/il_fullxfull.2077372372_9ds5.jpg",
    "https://i.etsystatic.com/18944861/r/il/e7e793/2077371426/il_fullxfull.2077371426_axcy.jpg",
    "https://i.etsystatic.com/18944861/r/il/9f8b36/2124933627/il_fullxfull.2124933627_l690.jpg",
    "https://i.etsystatic.com/18944861/r/il/0227f3/2077371138/il_fullxfull.2077371138_t9lj.jpg",
    "https://i.etsystatic.com/18944861/r/il/5a7a9a/2124933809/il_fullxfull.2124933809_nhmn.jpg"
  ],
  "description": "Hand-wash only! NOT DISHWASHER SAFE! \nImpressions may be slightly different! \nMICROWAVE SAFE.\n\nSet of two unique ceramic mugs.\nCapacity: 13.3 fluid ounces\n\nthe shape of mugs and impressions may be slightly different!",
  "description_html": "<p>Hand-wash only! NOT DISHWASHER SAFE! \nImpressions may be slightly different! \nMICROWAVE SAFE.\n\nSet of two unique ceramic mugs.\nCapacity: 13.3 fluid ounces\n\nthe shape of mugs and impressions may be slightly different!</p>",
  "material": "Ceramic",
  "rating_value": 5,
  "review_count": 8,
  "seller_name": "MagicCeramicsShop",
  "seller_url": "https://www.etsy.com/uk/shop/MagicCeramicsShop",
  "seller_address": "Ukraine",
  "canonical_url": "https://www.etsy.com/uk/listing/751685489/set-of-two-unique-ceramic-mugs-handmade",
  "scraped_at": "2026-08-20T17:32:37.099Z"
}

Use Cases

  • Track marketplace listing prices and availability
  • Compare sellers, ratings, materials, and product descriptions
  • Build Etsy listing research datasets

Integrate with AI and automation

Use with AI through MCP

Connect your AI assistant to the Apify MCP server. It can discover and run Actors, then access the results in the same conversation. For example, ask your assistant to scrape a list of products from Etsy, compare prices, or summarize the collected data.

Run on a schedule

After one successful run, use Apify Schedules to repeat the same task hourly, daily, weekly, or with a custom cron schedule. Saved tasks are useful when you want to keep the same URLs and settings for every run.

Connect with n8n

Create an n8n account and add the verified Apify node to a workflow. Choose Run an Actor and Get Dataset when the workflow should start this Actor, wait for completion, and receive the product rows for the next node. See the Apify integration for n8n.

Connect with Make

Create a Make account and add the Apify Run an Actor module. Follow it with Get Dataset Items to pass the product rows to Google Sheets, a database, email, or another Make module. For longer runs, use Watch Actor Runs followed by Get Dataset Items.

Read the Make integration guide.

Input schema
{
  "title": "Etsy Scraper Input",
  "type": "object",
  "schemaVersion": 1,
  "properties": {
    "productUrls": {
      "title": "Product URLs",
      "type": "array",
      "description": "Product URLs on Etsy.",
      "prefill": [
        "https://www.etsy.com/listing/782905249/ceramic-mug-handmade-hand-painted"
      ],
      "default": [],
      "editor": "stringList"
    },
    "categoryUrls": {
      "title": "Category URLs",
      "type": "array",
      "description": "Category URLs on Etsy.",
      "prefill": [
        "https://www.etsy.com/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware/mugs"
      ],
      "default": [],
      "editor": "stringList"
    },
    "maxResultsPerScrape": {
      "title": "Maximum results",
      "type": "integer",
      "description": "Maximum number of product records to save.",
      "default": 20,
      "minimum": 1,
      "maximum": 100000
    },
    "usePagination": {
      "title": "Use pagination",
      "type": "boolean",
      "description": "Enqueue the bounded pagination lookahead exposed by this actor.",
      "default": true
    },
    "scrapeProductDetails": {
      "title": "Include product details",
      "type": "boolean",
      "default": true,
      "description": "Enabled returns Product detail records with the product-page fields listed in the README. Disabled returns Result records with the list-level fields."
    }
  }
}
Output schema
{
  "actorSpecification": 1,
  "fields": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "url": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "product_id": {
        "type": [
          "string",
          "null"
        ],
        "description": "Stable source-side product identifier."
      },
      "name": {
        "type": [
          "string",
          "null"
        ]
      },
      "price": {
        "type": [
          "number",
          "null"
        ]
      },
      "currency": {
        "type": [
          "string",
          "null"
        ],
        "description": "ISO 4217 currency code."
      },
      "in_stock": {
        "type": [
          "boolean",
          "null"
        ]
      },
      "sku": {
        "type": [
          "string",
          "null"
        ]
      },
      "category": {
        "type": [
          "string",
          "null"
        ]
      },
      "breadcrumbs": {
        "type": "array",
        "items": {
          "type": "string"
        }
      },
      "breadcrumb_urls": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "main_image": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "images": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "uri"
        }
      },
      "description": {
        "type": [
          "string",
          "null"
        ]
      },
      "description_html": {
        "type": [
          "string",
          "null"
        ],
        "description": "Sanitized rich-text product description with structural HTML only."
      },
      "material": {
        "type": [
          "string",
          "null"
        ]
      },
      "rating_value": {
        "type": [
          "number",
          "null"
        ]
      },
      "review_count": {
        "type": [
          "integer",
          "null"
        ]
      },
      "seller_name": {
        "type": [
          "string",
          "null"
        ]
      },
      "seller_url": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "seller_address": {
        "type": [
          "string",
          "null"
        ]
      },
      "canonical_url": {
        "type": [
          "string",
          "null"
        ],
        "format": "uri"
      },
      "scraped_at": {
        "type": "string",
        "format": "date-time"
      },
      "regular_price": {
        "type": [
          "number",
          "null"
        ]
      },
      "badges": {
        "type": "array",
        "items": {
          "type": "string"
        },
        "description": "Badges and ribbons displayed on the product card, such as Star Seller or Sponsored."
      }
    },
    "required": [
      "url",
      "name"
    ]
  },
  "views": {
    "overview": {
      "title": "Overview",
      "transformation": {
        "fields": [
          "main_image",
          "url",
          "product_id",
          "name",
          "price",
          "regular_price",
          "currency",
          "in_stock",
          "seller_name",
          "scraped_at"
        ]
      },
      "display": {
        "component": "table",
        "properties": {
          "main_image": {
            "label": "Image",
            "format": "image"
          },
          "url": {
            "label": "Product URL",
            "format": "link"
          },
          "product_id": {
            "label": "Product ID",
            "format": "text"
          },
          "name": {
            "label": "Product name",
            "format": "text"
          },
          "price": {
            "label": "Current price",
            "format": "number"
          },
          "regular_price": {
            "label": "Regular price",
            "format": "number"
          },
          "currency": {
            "label": "Currency",
            "format": "text"
          },
          "in_stock": {
            "label": "In stock",
            "format": "boolean"
          },
          "seller_name": {
            "label": "Seller",
            "format": "text"
          },
          "scraped_at": {
            "label": "Scraped at",
            "format": "datetime"
          }
        }
      }
    }
  }
}
CUSTOM REQUIREMENTS

Need something different?

Tell us the website, fields, and delivery format you need. We’ll reply by email.