Fashionphile Scraper

Scrape Fashionphile — one of the largest resale marketplaces for authenticated pre-owned luxury handbags, jewelry, watches, and accessories. Search by keyword, browse by brand or category, pull new arrivals, or fetch full condition-graded details for specific product URLs. No account, cookies, or API key required — every mode uses Fashionphile's public storefront data.

What this actor does

• Five modes: search (keyword), byBrand (83 designer brands), byCategory (61 categories/collections), newArrivals, productDetails (by URL)
• Authoritative condition grading: Fashionphile's own condition grade (New/Excellent/Shows Wear/Worn/Fair), a 0-12 wear score, per-component condition notes, "comes with" info, and measurements
• Filters: price range, color, material, in-stock only
• Automatic pagination up to maxItems
• Empty fields are omitted — no null, empty-string, or empty-array fields in any record
• No account, cookies, or proxy required

Output per listing

Each record represents one luxury item listing.

• productId — Fashionphile internal product ID
• sku — internal SKU / listing number
• handle — URL handle / slug
• title — full product title
• description — full product description
• brand — brand name (e.g. Louis Vuitton, Chanel)
• category — product type (e.g. Bags, Jewelry, Accessories)
• color — color, best-effort parsed from the title (not always present)
• material — material, best-effort parsed from the title (not always present)
• condition — Fashionphile's own condition grade (New/Excellent/Shows Wear/Worn/Fair); requires fetchConditionDetails or mode=productDetails, otherwise a best-effort tag guess when present
• conditionScore — numeric wear score, 0 (New) to 12 (Fair); requires fetchConditionDetails or mode=productDetails
• conditionDetails — per-component condition notes, e.g. "Exterior: Edge wear\nHandle: Edge wear\nHardware: Scratch(es)"; requires fetchConditionDetails or mode=productDetails
• comesWith — what the item ships with, e.g. "FASHIONPHILE Certificate of Authenticity"; requires fetchConditionDetails or mode=productDetails
• measurements — item dimensions, e.g. "Base length: 12.75 in\nWidth: 5.75 in\nHeight: 11 in"; requires fetchConditionDetails or mode=productDetails; not every item has published measurements
• listedAt — ISO 8601 timestamp the listing went live for sale
• price — asking price in USD
• originalRetailPrice — original retail price, when Fashionphile lists one
• currency — currency code (USD)
• available — whether the item is currently in stock
• imageUrl — primary product image URL
• imageUrls — every product image URL (when more than one)
• productUrl — direct link to the product on Fashionphile
• tags — store tags (marketing/merchandising tags, not condition ratings)
• recordType — always luxuryProduct
• scrapedAt — UTC timestamp when the record was scraped

Input

Field	Type	Default	Description
mode	string	search	search / byBrand / byCategory / newArrivals / productDetails
keyword	string	Louis Vuitton	Search term (mode=search); also a brand-name fallback for mode=byBrand
brand	string	–	One of 83 designer brands (mode=byBrand; also narrows mode=search)
category	string	–	One of 61 categories/collections (mode=byCategory)
productUrls	array	–	Product URLs to fetch (mode=productDetails)
color	string	–	Filter by color parsed from the title (optional, best-effort)
material	string	–	Filter by material parsed from the title (optional, best-effort)
minPrice	integer	–	Minimum price in USD
maxPrice	integer	–	Maximum price in USD
inStockOnly	boolean	false	Only return items confirmed available
fetchConditionDetails	boolean	false	Fetch condition grade, wear score, condition notes, "comes with" info, and measurements for every item (one extra request per item). Always applied for productDetails regardless of this setting.
maxItems	integer	50	Maximum number of results (1–5000)

Example: search by keyword

{
  "mode": "search",
  "keyword": "Louis Vuitton Neverfull",
  "maxItems": 50
}

Example: browse a brand under a price cap

{
  "mode": "byBrand",
  "brand": "hermes",
  "maxPrice": 5000,
  "maxItems": 100
}

Example: browse a category with condition details

{
  "mode": "byCategory",
  "category": "jewelry",
  "fetchConditionDetails": true,
  "maxItems": 100
}

Example: fetch specific product pages

{
  "mode": "productDetails",
  "productUrls": [
    "https://www.fashionphile.com/products/louis-vuitton-monogram-neverfull-mm",
    "https://www.fashionphile.com/products/chanel-classic-flap-medium"
  ]
}

Example record

{
  "productId": "15852051005743",
  "sku": "1871522",
  "handle": "hermes-buffle-skipper-gallop-tote-gold-1871522",
  "title": "Buffle Skipper Gallop Tote Gold",
  "description": "This is an authentic HERMES Buffle Skipper Gallop Tote PM in Gold...",
  "brand": "Hermes",
  "category": "Bags",
  "color": "Gold",
  "price": 1795.0,
  "originalRetailPrice": 1795.0,
  "available": true,
  "imageUrl": "https://cdn.shopify.com/s/files/1/0894/3186/7695/files/68d4cfa7fb4e66688c8d9701b71e4d4e.jpg",
  "productUrl": "https://www.fashionphile.com/products/hermes-buffle-skipper-gallop-tote-gold-1871522",
  "currency": "USD",
  "recordType": "luxuryProduct",
  "scrapedAt": "2026-07-13T12:00:00+00:00"
}

Supported brands

3.1 Phillip Lim, Alaïa, Alexander McQueen, Alexander Wang, Anita Ko, Audemars Piguet, Balenciaga, Bottega Veneta, Boucheron, Breitling, Bulgari, Burberry, Cartier, Celine, Chanel, Chloe, Chopard, Christian Dior, Christian Louboutin, Chrome Hearts, Damiani, David Yurman, Delvaux, Dolce & Gabbana, Fendi, Foundrae, Franck Muller, Givenchy, Goyard, Graff, Gucci, Harry Winston, Hermès, Hublot, Irene Neuwirth, IWC, Jacquemus, Jennifer Meyer, Jimmy Choo, John Hardy, Judith Leiber, Khaite, Lanvin, Loewe, Loro Piana, Louis Vuitton, Mansur Gavriel, Marc Jacobs, Marco Bicego, MCM, Messika, Mikimoto, Miu Miu, Moynat, Mulberry, Off-White, Oliver Peoples, Omega, Panerai, Parker & West by FASHIONPHILE, Pasquale Bruni, Piaget, Pomellato, Prada, Proenza Schouler, Rimowa, Roberto Coin, Rolex, Saint Laurent, Salvatore Ferragamo, Stella McCartney, Suzanne Kalan, TAG Heuer, Telfar, Temple St. Clair, The Row, Tiffany & Co., Tom Ford, Tudor, Vacheron Constantin, Valentino Garavani, Van Cleef & Arpels, Versace — plus any other brand reachable via mode=search.

Supported categories

Handbags, All bags, Wallets, Jewelry, Fine jewelry, Watches, Luxury watches, Men's watches, Women's watches, Fashion watches, Shoes, Sunglasses, Belts, Scarves, Accessories, Travel & luggage, Totes, Shoulder bags, Crossbody bags, Clutches & evening bags, Bucket bags, Hobo bags, Backpacks, Top handle bags, Belt bags, East-west bags, Boots & booties, Sandals, Flats, Sneakers, Pumps, Bracelets, Necklaces, Earrings, Rings, Pins & brooches, Wallets (by style), Bag charms, Cosmetic cases, Pouches, Gloves, Hats, Hair accessories, Key rings, Luggage tags, Extra/replacement straps, Phone & tablet cases, Pet accessories, Agendas, Professional/work bags, Lifestyle, Best of sale, All discounted items, Over 50% off retail, Rare finds, Editors' picks, The Archive, The Hidden Gems Edit, Cardi B favorites, Recently sold (price research), All items (entire catalog).

Use cases

• Price research — track resale value trends for a designer brand or specific bag model over time
• Market intelligence — monitor luxury resale inventory, pricing, and availability across categories
• Authentication reference — pull Fashionphile's condition grading and measurements as a reference dataset
• Reseller sourcing — find in-stock items under a price threshold in a target brand or category
• Trend tracking — watch new arrivals and "Recently sold" items to gauge demand for specific pieces
• Comparison shopping — build a dataset of comparable listings across brands and categories

Limitations

• Color and material are inferred, not authoritative. Fashionphile's public data does not expose structured color/material fields; the scraper best-effort parses them from the listing title using a curated vocabulary. A listing without a recognizable color/material word in its title simply omits that field — it is never fabricated.
• Condition grading and measurements require an extra request per item, fetched automatically for mode=productDetails or when fetchConditionDetails=true. Not every item has published measurements (e.g. small jewelry pieces often don't); when absent, the field is simply omitted.
• mode=search beyond the top 10 relevance-ranked matches performs a bounded catalog scan for additional keyword matches. Extremely rare or highly specific search terms may return fewer than maxItems if the scan doesn't turn up enough matches — use mode=byBrand or mode=byCategory for exhaustive browsing of a known brand/category instead.
• Sorting a collection is not supported — collection order reflects Fashionphile's own storefront curation, not price/date.
• Fashionphile's collection/product endpoints are occasionally rate-limited platform-wide (a shared-infrastructure condition, not specific to any one run). The actor retries with backoff and falls back to Apify's free proxy automatically; mode=search and mode=byBrand/mode=byCategory additionally fall back to keyword search so they keep returning real results. mode=newArrivals and mode=productDetails have no keyword-search equivalent to fall back to, so during a rate-limited window they may return fewer results than requested.
• "Similar items" / recommendations are not supported — Fashionphile doesn't expose a public recommendations endpoint.
• No account, cookies, or API key is required for any mode.

FAQ

Do I need an account or API key? No. The scraper uses Fashionphile's public storefront pages, which require no authentication.

What does Fashionphile sell? Fashionphile specializes in authenticated pre-owned luxury handbags, wallets, fine jewelry, watches, sunglasses, and shoes from top designer brands, plus smaller accessories (bag charms, key rings, hair accessories) and curated collections (the Archive, Hidden Gems, Cardi B favorites). See "Supported categories" above for the full browsable list.

How does condition grading work? Fashionphile authenticates and grades every item before listing it on a New / Excellent / Shows Wear / Worn / Fair scale with a 0-12 wear score and per-component notes. Set fetchConditionDetails=true (or use mode=productDetails) to include it in the output.

How many results can I get? Use maxItems to set your limit (up to 5,000 per run). mode=byBrand, mode=byCategory, and mode=newArrivals paginate exhaustively through the underlying collection; mode=search is bounded, as described in Limitations.

Can I filter by color or material? Yes, via the color and material inputs — matches are based on the listing title, so coverage isn't 100% (see Limitations).

Can I fetch a single specific product? Yes — use mode=productDetails with one or more Fashionphile product URLs in productUrls. Condition grading and measurements are always included in this mode.

Does the price include Fashionphile's original retail price? When available, originalRetailPrice reports what the item retailed for new; not every listing has this field populated.

Is this an official Fashionphile tool? No — this is an independent, third-party actor that reads Fashionphile's public storefront data. It is not affiliated with or endorsed by Fashionphile.

Are sold-out items included? By default, yes (marked available: false). Set inStockOnly=true to exclude them.

How fresh is the data? Listings reflect Fashionphile's live inventory at the time the actor runs.