Pre-owned luxury resale pricing and condition-grade research
Mit Vestiaire Collective-Endpunkten verwandelst du pre-owned luxury resale pricing and condition-grade research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Turn Vestiaire Collective's public pre-owned luxury resale marketplace into structured JSON — keyword, category, brand, and condition search with live facet counts and a price range across the full filtered result set, full listing detail with seller summary, a seller's public storefront profile, and the complete universe/category and condition-grade taxonomy. Normalized JSON, credential-free.
Search Vestiaire Collective's pre-owned luxury resale catalog, get listing and seller detail, and browse the category and condition taxonomy as structured JSON.
Endpunkt-Familien
6
Dokumentierte Parameter
19
Beispiele
8
Live-Katalog-Snapshot
Aktive Endpunkte
8
Methoden
GET
Pflichtparameter
12
Schema-Referenzen
8
{
"platform": "Vestiaire Collective",
"endpoint": "vestiaire-search",
"method": "GET",
"path": "/vestiaire/search",
"auth": "apiKey"
}Use Cases
Search Vestiaire Collective's pre-owned luxury resale catalog, get listing and seller detail, and browse the category and condition taxonomy as structured JSON.
Mit Vestiaire Collective-Endpunkten verwandelst du pre-owned luxury resale pricing and condition-grade research in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Vestiaire Collective-Endpunkten verwandelst du category and brand demand tracking in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Mit Vestiaire Collective-Endpunkten verwandelst du seller and marketplace-supply monitoring in wiederholbare API-Requests mit dokumentierten Inputs und JSON-Antworten.
Managed Execution
Jede Zahl unten stammt direkt aus dem Live-Vestiaire Collective-Endpunktkatalog — 8 Endpunkte, 19 dokumentierte Request-Parameter und 8 veröffentlichte Response-Schemas — demselben Katalog, gegen den auch Docs und Playground laufen.
8 documented Vestiaire Collective endpoints, grouped into 8 request families — Brands, Categories and Conditions, plus 5 more.
19 request parameters are documented across those Vestiaire Collective endpoints, 12 of them required — the full input contract is public before you write any integration code.
8 of the 8 Vestiaire Collective endpoints ship a recorded example response, and 8 carry a documented response schema — you can code against the real JSON before the first request.
Vestiaire Collective endpoints document their error responses (400, 404, 429, 500 and 503) alongside the success schema, so a block, a rate limit, or a missing record comes back as a typed error rather than silently empty data.
8 hosted MCP tools back the Vestiaire Collective endpoints, so an agent can call the same routes with the same parameters and the same JSON contract, with no custom glue.
Abdeckungskarte
Diese Karten werden aus dem aktiven Endpunktkatalog generiert, damit die Landingpage dieselbe API-Oberfläche widerspiegelt, die auch Docs und Playground nutzen.
/vestiaire/brands
/vestiaire/categories
/vestiaire/conditions
/vestiaire/product
/vestiaire/search
/vestiaire/search-sellers
Endpunktkatalog
/vestiaire/searchSearches Vestiaire Collective's public pre-owned luxury resale catalog by keyword, category, brand, and condition, with sort and pagination. `sort` values: `relevance`, `price_asc`, `price_desc`, `recency`. `category_id` and `condition_id` come from /vestiaire/categories and /vestiaire/conditions. `page` * `per_page` cannot exceed an offset of 1000 (the upstream service's own pagination limit) -- narrow the query instead of paging deeper. Public data, sourced from Vestiaire Collective's own search service.
Hinweise zur Response
- `facets` summarizes brand/category/condition counts for the current query and filters — a useful way to discover a `brand_id` before narrowing a search further. - `price_range` is the minimum/maximum price (in cents) across the current filtered result set, not just the current page. - Each item's `url` is usable directly as the `path` query parameter to [`/vestiaire/product`](vestiaire-product.md). - An invalid `sort` or `condition_id` returns `400` before any upstream request is made. - Vestiaire Collective's own search service caps how deep a query can page: `page` × `per_page` cannot exceed an offset of 1000. Requesting a deeper page returns `400` before any upstream request is made — narrow the query with `q`, `category_id`, `brand_id`, or `condition_id` instead of paging further. Example response: ```json { "code": 200, "msg": "OK", "data": { "q": "chanel bag", "sort": "relevance", "page": 1, "per_page": 24, "total_items": 10000, "total_pages": 417, "price_range": { "min_cents": 700, "max_cents": 9765700 }, "facets": { "brands": [{ "id": "50", "name": "Chanel", "count": 119169 }], "categories": [{ "id": "5", "name": "Bags", "count": 119040 }], "conditions": [{ "id": "3", "name": "Very good condition", "count": 71026 }] }, "items": [ { "id": "70816051", "name": "Timeless/Classique Chain leather backpack", "brand": "Chanel", "brand_id": "50", "color": "Black", "price_cents": 270000, "currency": "USD", "country": "US", "sold": false, "in_stock": false, "likes": 1, "pictures": ["https://images.vestiairecollective.com/produit/70816051-1_2.jpg"], "url": "https://www.vestiairecollective.com/women-bags/backpacks/chanel/black-leather-timeless-classique-chain-chanel-backpack-70816051.shtml", "created_at": "2026-09-08T10:00:03Z" } ], "source_url": "https://www.vestiairecollective.com/search/?q=chanel+bag", "fetched_at": "2026-09-09T12:00:00Z" } } ```
MCP-Tool vestiaire_search
/vestiaire/productReturns a single Vestiaire Collective listing's public detail: price, brand, category, condition, material, color, size, seller summary, and photos. `path` is the listing's URL or site-relative path, as returned by /vestiaire/search's `url` field -- the numeric id alone cannot be resolved to a page. Public data, sourced from Vestiaire Collective's own listing page.
Hinweise zur Response
- `seller` is a public summary only (username, country, badge, and aggregate sold/listed counts) — no contact or account information. - An unresolvable `path` returns `404`. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "70860454", "name": "Leather biker jacket", "description": "Black leather jacket from Off-White for women. Never worn.", "brand": { "id": "6444", "name": "Off-White" }, "category": { "id": "611", "name": "Leather jackets", "parent_id": "2" }, "condition": "Never worn", "material": "Leather", "color": "Black", "universe": "Women", "size": "L", "size_standard": "International", "price_cents": 31100, "currency": "USD", "sold": false, "reserved": false, "negotiable": true, "available": true, "in_stock": false, "like_count": 2, "pictures": ["https://images.vestiairecollective.com/produit/70860454-8_3.jpg"], "seller": { "id": "36526194", "username": "michelle36526194", "country": "United States", "country_iso": "US", "badge": "Common", "products_sold": 8, "products_listed": 23 }, "url": "https://www.vestiairecollective.com/women-clothing/biker-jackets/off-white/black-leather-off-white-biker-jacket-70860454.shtml", "source_url": "https://www.vestiairecollective.com/women-clothing/biker-jackets/off-white/black-leather-off-white-biker-jacket-70860454.shtml", "fetched_at": "2026-09-09T12:00:00Z" } } ```
MCP-Tool vestiaire_product
/vestiaire/sellerReturns a Vestiaire Collective seller's public storefront profile: username, country, segment, aggregate sold/listed/bought counts, and follower/following counts. `id` is the numeric seller id, as returned by /vestiaire/search's `seller_id` field or /vestiaire/product's `seller.id`. Public data, sourced from Vestiaire Collective's own seller profile page.
Hinweise zur Response
- Only what any visitor sees on the seller's own public page — no contact or account information. - An unresolvable `id` returns `404`. Example response: ```json { "code": 200, "msg": "OK", "data": { "id": "36526194", "username": "michelle36526194", "firstname": "michelle", "country": "United States", "country_iso": "US", "segment": "C2C", "products_sold": 8, "products_listed": 23, "products_bought": 0, "followers": 26, "following": 11, "community_rank": 0, "url": "https://www.vestiairecollective.com/profile/36526194", "source_url": "https://www.vestiairecollective.com/profile/36526194", "fetched_at": "2026-09-09T12:00:00Z" } } ```
MCP-Tool vestiaire_seller
/vestiaire/categoriesReturns the full Vestiaire Collective category taxonomy: universes (Women, Men, Kids) at the root, with up to three nested category levels beneath each. Every id returned here is accepted by /vestiaire/search's category_id filter.
MCP-Tool vestiaire_categories
/vestiaire/conditionsReturns the fixed set of condition ids accepted by /vestiaire/search's condition_id filter, with each id's display name and current listing count.
MCP-Tool vestiaire_conditions
/vestiaire/brandsReturns Vestiaire Collective's full brand directory (id, name, url), not just brands with active listings for a given search -- resolves search's otherwise-opaque brand_id filter, and a search response's facets.brands, to the complete set of valid ids. Public data, sourced from Vestiaire Collective's own brand-directory page.
Hinweise zur Response
- `brands` is sorted by numeric `id` for a deterministic order. - `id` is the same id `/vestiaire/search`'s `brand_id` filter accepts. - Only active brands are included; inactive/delisted brand entries are filtered out. Example response: ```json { "code": 200, "msg": "OK", "data": { "total": 13693, "brands": [ {"id": "50", "name": "Chanel", "url": "https://www.vestiairecollective.com/chanel/"}, {"id": "4476", "name": "& Other Stories", "url": "https://www.vestiairecollective.com/other-stories/"} ] } } ```
MCP-Tool vestiaire_brands
/vestiaire/search-sellersFinds Vestiaire Collective sellers by username or first name. A matched result's id can be passed directly to GET /vestiaire/seller for that seller's full public storefront profile. Public data, sourced from Vestiaire Collective's own member-search service.
Hinweise zur Response
- `name` reflects whatever the seller has set as their first name; it may differ from `username`. - `avatar_url` is omitted when the seller has no profile picture set. - A missing `q` returns `400` before any upstream request is made. - A query with no matching sellers returns `200` with `"sellers": []`. Example response: ```json { "code": 200, "msg": "OK", "data": { "q": "michelle", "sellers": [ { "id": "515578", "username": "michelle_", "name": "Michelle", "avatar_url": "https://images.vestiairecollective.com/profil/515578-c15a06b33eba94f4e2513f8c946218d0.jpg" }, { "id": "14773271", "username": "michelle0", "name": "Michelle" } ] } } ```
MCP-Tool vestiaire_search_sellers
/vestiaire/suggestReturns Vestiaire Collective's own search-box autocomplete suggestions for a partial query: matching brands plus completed search phrases. Public data, sourced from Vestiaire Collective's own search-suggestions service.
Hinweise zur Response
- `brands` lists brand matches for the query, each with the same `id` accepted by [`GET /vestiaire/search`](vestiaire-search.md)'s `brand_id` filter. - `suggestions` lists completed search phrases (plain strings) for the query. - A missing `q` returns `400` before any upstream request is made. - A query with no matches returns `200` with empty `brands`/`suggestions`. Example response: ```json { "code": 200, "msg": "OK", "data": { "q": "chane", "brands": [ {"id": "50", "name": "Chanel", "url": "https://www.vestiairecollective.com/chanel/"}, {"id": "9705", "name": "Chanel x Pharrell Williams", "url": "https://www.vestiairecollective.com/chanel-x-pharrell-williams/"} ], "suggestions": ["chane", "chanel", "chanel bag", "chanel shoes", "chanel sunglasses"] } } ```
MCP-Tool vestiaire_suggest
Verwandte APIs
Marketplaces & Retail
Collect marketplace product signals from Amazon without building brittle storefront scrapers.
Marketplaces & Retail
Build resale, pricing, and marketplace workflows from structured eBay data.
Marketplaces & Retail
Turn public Shop.app product and merchant pages into structured JSON for e-commerce product intelligence, price research, shop monitoring, and marketplace discovery workflows.
So scrapst du Vestiaire Collective
Crawlora's five Vestiaire Collective endpoints return search, listing, seller, category, and condition data as normalized JSON with one API key — categories and conditions are the two discovery endpoints for search's own category_id and condition_id filters, both cached for reference-data stability.
Call /vestiaire/categories for the full universe (Women, Men, Kids) and up to three nested category levels beneath each, and /vestiaire/conditions for the fixed 5-tier condition scale (ids 1 through 5, Never worn with tag through Fair condition) — both with live listing counts, and both exactly what /vestiaire/search's category_id and condition_id filters accept.
Send q, category_id, brand_id, and/or condition_id to /vestiaire/search, with sort (relevance, price_asc, price_desc, or recency) and page/per_page (up to 60 per page). facets in the response summarizes brand/category/condition counts for the current filters — a way to discover a brand_id before narrowing further — and price_range reports the min/max price in cents across the whole filtered set, not just the current page.
Pass a search result's own url to /vestiaire/product's path parameter for full detail — brand, category, condition, material, color, size, and a public seller summary. The numeric listing id alone cannot be resolved to a page, since Vestiaire Collective's URLs are SEO slugs, not derivable from the id.
Pass a seller's numeric id (from a search result's seller_id or a product's seller.id) to /vestiaire/seller for their public storefront profile — username, country, segment, and aggregate sold/listed/bought/follower counts, the same as any visitor sees on their profile page.
FAQ
page times per_page cannot exceed an offset of 1000 — the upstream search service's own paging cap. Requesting a deeper page returns 400 before any upstream request is made; narrow with q, category_id, brand_id, or condition_id instead of paging further.
Run a keyword or category search first and read the response's facets.brands field, which lists matching brands with their id and live count. There is no separate standalone brand-directory endpoint — facets is the discovery path.
/vestiaire/conditions returns the fixed 5-tier scale: 1 (Never worn, with tag), 2 (Never worn), 3 (Very good condition), 4 (Good condition), and 5 (Fair condition), each with a live listing count. Pass any id as condition_id to /vestiaire/search.
Cents in price_range and price_cents fields (e.g. price_cents: 270000 is $2,700.00) — divide by 100 before displaying or comparing. This matches how the upstream search service itself reports price.
No — only your Crawlora API key. Search, listing, seller, category, and condition data are collected from Vestiaire Collective's public, credential-free marketplace surface.