API Reference
Use Crawlora's Vestiaire API endpoints to extract supported public Vestiaire data as structured JSON. This documentation covers 8 active endpoints including Vestiaire Collective's full brand directory, Vestiaire Collective category taxonomy, Vestiaire Collective condition values, Vestiaire Collective listing detail, and related APIs. Developers can use these endpoints for monitoring, enrichment, research dashboards, internal data pipelines, and agent-native workflows without maintaining platform-specific scraping code. Each endpoint page documents authentication, request parameters such as path, q, id, cURL examples, response examples, response schemas, errors, credit cost, and Playground testing. Send requests to the Crawlora API with an x-api-key header, review usage and plan limits on pricing, and test safe sample requests in Playground before moving the workflow into production.
Choose an endpoint, send an authenticated request with the x-api-key header, and inspect the normalized JSON response. The examples below use the public Crawlora API base URL and the same endpoint catalog used by Playground.
curl -X GET "https://api.crawlora.net/api/v1/vestiaire/search?q=coffee&condition_id=1&sort=relevance&page=1" \
-H "x-api-key: $CRAWLORA_API_KEY"These endpoint cards are generated from the active Crawlora endpoint catalog, including method, path, auth mode, credit cost, parameter summary, docs, and Playground links.
/vestiaire/brandsapiKey2 credits/requestReturns 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.
Required params: None
/vestiaire/categoriesapiKey2 credits/requestReturns 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.
Required params: None
/vestiaire/conditionsapiKey2 credits/requestReturns the fixed set of condition ids accepted by /vestiaire/search's condition_id filter, with each id's display name and current listing count.
Required params: None
/vestiaire/productapiKey4 credits/requestReturns 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.
Required params: path:query
/vestiaire/search-sellersapiKey4 credits/requestFinds 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.
Required params: q:query
/vestiaire/searchapiKey4 credits/requestSearches 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.
Required params: None
/vestiaire/sellerapiKey4 credits/requestReturns 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.
Required params: id:query
/vestiaire/suggestapiKey4 credits/requestReturns 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.
Required params: q:query
| Endpoint | API path | Method | Credits | Required params | Docs | Playground |
|---|---|---|---|---|---|---|
| Vestiaire Collective's full brand directory | /vestiaire/brands | GET | 2 credits/request | None | View docs | Try endpoint |
| Vestiaire Collective category taxonomy | /vestiaire/categories | GET | 2 credits/request | None | View docs | Try endpoint |
| Vestiaire Collective condition values | /vestiaire/conditions | GET | 2 credits/request | None | View docs | Try endpoint |
| Vestiaire Collective listing detail | /vestiaire/product | GET | 4 credits/request | path:query | View docs | Try endpoint |
| Search Vestiaire Collective sellers by name | /vestiaire/search-sellers | GET | 4 credits/request | q:query | View docs | Try endpoint |
| Vestiaire Collective listing search | /vestiaire/search | GET | 4 credits/request | None | View docs | Try endpoint |
| Vestiaire Collective seller profile | /vestiaire/seller | GET | 4 credits/request | id:query | View docs | Try endpoint |
| Vestiaire Collective search-box autocomplete | /vestiaire/suggest | GET | 4 credits/request | q:query | View docs | Try endpoint |