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, filtered and category URLs. Very high data coverage: up to 23 fields are available for each product.

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.

For custom requirements, you can also reach out to us by filling this form.

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 and filtered result pages in categoryUrls.

  1. Open a supported list page in your browser.
  2. Choose a category and apply the filters 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.

Add one or more List URLs to scrape. categoryUrls is labelled List URLs in the Console and accepts category pages and filtered result pages.

Scrape Etsy Filtered Result Pages

Pass a results URL with filters applied and the Actor collects only the filtered products. Example: https://www.etsy.com/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware/mugs?explicit=1&attr_225=1144

Scrape Etsy Category Pages

Pass a category URL and the Actor collects every product listed in that category. Example: https://www.etsy.com/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware/mugs

The scrapeProductDetails option (labelled Include product details) decides what each List URL produces. When it is enabled, the Actor visits each product page and returns the full detail records; when it is disabled, the Actor returns one list-level record per product card with the fields that are always included.

Features

  • Scrapes detailed handmade, vintage, and marketplace listing information from Etsy product pages
  • Accepts individual product URLs and category pages and filtered result 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 and filtered result pages
maxResultsPerScrape integer Maximum number of product records to save
usePagination boolean Whether to continue through additional result pages
scrapeProductDetails boolean If the Include product details option is enabled, the Actor visits each product page for the full detail record; if it is disabled, the Actor returns one list-level result record per product card. Both field lists are in "What data you get in each mode" below.

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

You might also like

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": "Add one or more product page URLs to scrape. Example product URLs:\n\n- https://www.etsy.com/listing/782905249/ceramic-mug-handmade-hand-painted",
      "prefill": [
        "https://www.etsy.com/listing/782905249/ceramic-mug-handmade-hand-painted"
      ],
      "default": [],
      "editor": "stringList"
    },
    "categoryUrls": {
      "title": "List URLs",
      "type": "array",
      "description": "Add one or more List URLs to scrape.\n\nSupported page types with examples:\n\n- Filtered result page: https://www.etsy.com/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware/mugs?explicit=1&attr_225=1144\n- Category page: https://www.etsy.com/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware/mugs\n\nLeave blank if using direct product URLs instead.\n\nThe `scrapeProductDetails` option (labelled Include product details) decides what each List URL produces. When it is enabled, the Actor visits each product page and returns the full detail records; when it is disabled, the Actor returns one list-level record per product card with the fields that are always included.",
      "prefill": [
        "https://www.etsy.com/c/home-and-living/kitchen-and-dining/drink-and-barware/drinkware/mugs?explicit=1&attr_225=1144",
        "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": "If this option is enabled and a List URL has more than one page, the Actor continues through the following pages until it reaches the Maximum results limit. If the option is disabled, the Actor only scrapes the first page of each List URL.",
      "prefill": true,
      "default": true
    },
    "scrapeProductDetails": {
      "title": "Include product details",
      "type": "boolean",
      "default": true,
      "description": "If this option is enabled, the Actor visits each product page and adds the full product details to every record. If it is disabled, the Actor returns one list-level result record per product card.\n\nFields that are always included:\n\n- `url`\n- `product_id`\n- `name`\n- `price`\n- `regular_price`\n- `currency`\n- `sku`\n- `main_image`\n- `images`\n- `rating_value`\n- `review_count`\n- `seller_name`\n- `badges`\n- `canonical_url`\n- `scraped_at`\n\nFields that are only added when this option is enabled (set to true), and not added when it is disabled:\n\n- `in_stock`\n- `category`\n- `breadcrumbs`\n- `breadcrumb_urls`\n- `description`\n- `description_html`\n- `material`\n- `seller_url`\n- `seller_address`"
    }
  }
}
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.