Pre-owned luxury resale pricing and condition-grade research
Vestiaire Collectiveエンドポイントを使えば、「Pre-owned luxury resale pricing and condition-grade research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
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.
エンドポイントファミリー
6
ドキュメント化されたパラメータ
19
サンプル数
8
ライブカタログスナップショット
稼働エンドポイント
8
メソッド
GET
必須パラメータ
12
スキーマ参照
8
{
"platform": "Vestiaire Collective",
"endpoint": "vestiaire-search",
"method": "GET",
"path": "/vestiaire/search",
"auth": "apiKey"
}ユースケース
Search Vestiaire Collective's pre-owned luxury resale catalog, get listing and seller detail, and browse the category and condition taxonomy as structured JSON.
Vestiaire Collectiveエンドポイントを使えば、「Pre-owned luxury resale pricing and condition-grade research」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Vestiaire Collectiveエンドポイントを使えば、「Category and brand demand tracking」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
Vestiaire Collectiveエンドポイントを使えば、「Seller and marketplace-supply monitoring」をドキュメント化された入力とJSONレスポンスによる再現可能なAPIリクエストに変えられます。
マネージド実行
以下の数値はすべて、稼働中のVestiaire Collectiveエンドポイントカタログから取得しています（エンドポイント8件、ドキュメント化されたリクエストパラメータ19個、公開レスポンススキーマ8件）。DocsとPlaygroundが参照しているカタログと同じものです。
Vestiaire Collectiveのエンドポイントは8件、8つのリクエストファミリーに分類されています（Brands、Categories、Conditionsほか5件）。
これらのVestiaire Collectiveエンドポイントには19個のリクエストパラメータがドキュメント化されており、うち12個が必須です。統合コードを書く前に入力仕様をすべて確認できます。
8件のVestiaire Collectiveエンドポイントのうち8件が実際のサンプルレスポンスを、8件がドキュメント化されたレスポンススキーマを備えています。最初のリクエストの前に実データの形に合わせて実装できます。
Vestiaire Collectiveのエンドポイントは成功時のスキーマに加えてエラーレスポンス（400、404、429、500、503）もドキュメント化しています。ブロック、レート制限、レコード欠損は空データではなく型付きのエラーとして返ります。
Vestiaire Collectiveのエンドポイントは8個のホスト型MCPツールとして提供されており、エージェントは同じパラメータと同じJSON契約のまま、追加の実装なしに同じルートを呼び出せます。
カバレッジマップ
これらのカードは稼働中のエンドポイントカタログから生成されるため、このページはDocsとPlaygroundが使うAPIサーフェスをそのまま反映します。
/vestiaire/brands
/vestiaire/categories
/vestiaire/conditions
/vestiaire/product
/vestiaire/search
/vestiaire/search-sellers
エンドポイントカタログ
/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.
レスポンスに関する注記
- `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ツール 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.
レスポンスに関する注記
- `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ツール 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.
レスポンスに関する注記
- 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ツール 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ツール 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ツール 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.
レスポンスに関する注記
- `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ツール 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.
レスポンスに関する注記
- `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ツール 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.
レスポンスに関する注記
- `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ツール vestiaire_suggest
関連API
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.
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.