Hardly Ever Worn It Scraper

Extract pre-owned luxury fashion listings from hardlyeverwornit.com — a UK-based consignment marketplace for designer clothing, handbags, shoes, jewelry, and accessories from brands like Hermès, Chanel, Louis Vuitton, Gucci, Prada, and more.

What does this actor do?

This actor scrapes the public Shopify product API of Hardly Ever Worn It to retrieve pre-owned luxury fashion listings. It supports three modes:

• Search by keyword — find listings matching a query such as "Hermes bag" or "Chanel jacket"
• Browse by category — browse all listings in a specific category (bags, shoes, dresses, jewelry, watches, etc.)
• Browse by brand — retrieve all listings for a specific designer brand (Hermès, Chanel, Gucci, Dior, etc.)

No account, API key, or proxy is required.

---

Input

Field	Type	Description
mode	Select	search, byCategory, or byBrand
query	Text	Search keyword (mode=search), e.g. "Hermes bag"
category	Select	Category handle (mode=byCategory), e.g. bags, bags-women, shoes-women
brand	Select	Designer brand (mode=byBrand), e.g. hermes, chanel, gucci
condition	Select	Filter by item condition: Very Good, New with tags, Good, B+, etc.
maxItems	Integer	Maximum number of listings to return (1–200, default 30)

Example inputs

Search for Hermès bags:

{
  "mode": "search",
  "query": "Hermes bag",
  "maxItems": 50
}

Browse women's bags:

{
  "mode": "byCategory",
  "category": "bags-women",
  "maxItems": 100
}

Browse Chanel listings:

{
  "mode": "byBrand",
  "brand": "chanel",
  "condition": "New with tags",
  "maxItems": 50
}

---

Output

Each record includes:

Field	Type	Description
listingId	String	Unique Shopify product ID
title	String	Listing title (e.g. "Hermès Birkin 30 Togo Leather")
brand	String	Designer brand (e.g. "Hermès", "Chanel")
category	String	Product category (e.g. "Bags", "Shoes")
subcategory	String	More specific category (e.g. "Shoulder bag", "Bucket bag")
condition	String	Item condition (e.g. "Very Good", "New with tags", "B+")
size	String	Size label (e.g. "38", "M", "one size")
color	String	Primary color (e.g. "Black", "Etoupe")
gender	String	Gender classification ("Women", "Men", "Unisex")
material	String	Primary material (e.g. "Leather", "Cotton")
price	Float	Current listing price in GBP
originalRetailPrice	Float	Original retail price (if available)
currency	String	Always "GBP"
available	Boolean	Whether the item is currently available
inclusions	Array	What is included (e.g. ["auth_card", "dust_bag", "box"])
countryOfOrigin	String	Country of manufacture (e.g. "France", "Italy")
imageUrl	String	Primary listing image URL
listingUrl	String	Direct URL to the listing on hardlyeverwornit.com
publishedAt	String	ISO 8601 date the listing was published
scrapedAt	String	ISO 8601 UTC timestamp when the record was scraped
recordType	String	Always "luxuryListing"

Sample output record

{
  "listingId": "9256811888878",
  "title": "Hermès Etoupe Watch Strap",
  "brand": "Hermes",
  "category": "Accessories",
  "subcategory": "Accessories",
  "condition": "Very Good",
  "size": "one size",
  "color": "Brown",
  "gender": "Women",
  "material": "Leather",
  "price": 202.0,
  "currency": "GBP",
  "available": true,
  "inclusions": ["auth_card", "dust_bag"],
  "countryOfOrigin": "France",
  "imageUrl": "https://cdn.shopify.com/s/files/1/0755/1431/4990/files/hermes_strap.jpg",
  "listingUrl": "https://www.hardlyeverwornit.com/products/9733aa-hermes",
  "publishedAt": "2026-04-29T10:00:00-04:00",
  "scrapedAt": "2026-06-04T10:00:00+00:00",
  "recordType": "luxuryListing"
}

---

Categories available

The following category handles are supported for mode=byCategory:

• bags / bags-women / bags-men
• shoes-women / shoes-men
• clothing-women / clothing-men
• accessories / accessories-women / accessories-men
• fine-jewellery-women / fashion-jewellery-women
• watches-women / watches-men
• dresses / evening-dresses-women / day-dresses-women
• jackets / jackets-women / jackets-men
• knitwear-women / knitwear-men
• jeans / jeans-women / jeans-men
• heeled-shoes-women / flat-shoes-women
• sneakers-women / sneakers-men
• boots-women / boots-men
• belts-women / belts-men
• hats-women / hats-men
• cross-body-bags-women / backpacks-women

Brands available

Top designer brands supported for mode=byBrand:

• hermes / chanel / louis-vuitton / gucci / prada
• dior / balenciaga / bottega-veneta-new / fendi / givenchy
• balmain / dolce-gabbana / valentino / saint-laurent / celine
• loewe / burberry / versace / alexander-mcqueen
• alaia / amiri / amina-muaddi / jimmy-choo

---

Frequently Asked Questions

Does this require an API key or login? No. Hardly Ever Worn It is powered by Shopify and its product API is publicly accessible without any authentication.

Are prices in USD or GBP? All prices are in GBP (British Pounds Sterling) as this is a UK-based marketplace.

What does the condition field mean?

• New with tags — brand new, original tags attached
• New without tags — unused but tags removed
• Very Good — lightly used, minimal signs of wear
• Good — gently used with minor wear
• B+ — gently worn, good condition
• AB — well loved but structurally sound

How many items can I scrape? The maxItems parameter goes up to 200 per run. For larger scrapes, run multiple jobs with different categories or brands.

Can I filter by size or color? Currently the actor supports filtering by condition. Size and color are included in every output record so you can post-filter your dataset.

How fresh is the data? The actor hits the live Shopify API, so data is real-time. Items sell quickly on luxury resale platforms, so listings may be sold by the time you visit.

---

Data Source

Data is sourced from the public Shopify JSON API of hardlyeverwornit.com. No scraping of rendered HTML pages is performed.