Vestiaire Collective Listing API Documentation Read one Vestiaire Collective listing by id or url. The item has the full description, price, original price and discount percent, the price breakdown (seller price, seller earning, buyer fee), brand, model, category path, condition, material, colour, size, measurements, all photos in full size and resized, likes, stock and the seller (username, country, badges, items sold and listed, rating badge). A sold listing shows sold, sold_at and the listing date. The authenticity block has the receipt flag and whether the buyer fee includes authentication fees. Both can be null when the site does not send them. The price is the listing price. Vestiaire Collective publishes no separate sold price. Private seller data is not returned. An unknown id gives a 404 and costs nothing. Cost: 1 credit per request, only for successful requests.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
string
Required
A numeric listing id (e.g. 66976019) or a listing url ending in -{id}.shtml.
example
string
Optional
Market: GB (GBP), US (USD), IT, FR, DE or ES (EUR). FR, DE and ES share the EU listing pool with IT. Defaults to GB.
US
string
Optional
Language of names and labels: en, it, fr, de or es. Defaults to the language of the country.
en-US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"item": {
"id": 44128866,
"url": "https://www.vestiairecollective.com/women-shoes/boots/prada/black-suede-prada-boots-44128866.shtml",
"name": "Boots",
"size": {
"id": 32,
"label": "37",
"standard": "EU"
},
"sold": true,
"brand": {
"id": 60,
"name": "Prada"
},
"color": {
"id": 14,
"name": "Black"
},
"likes": 80,
"model": null,
"price": {
"amount": 17.38,
"currency": "GBP"
},
"images": [
{
"alt": "Boots Prada",
"url": "https://images.vestiairecollective.com/produit/44128866-1_2.jpg",
"resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/44128866-1_2.jpg"
},
{
"alt": "Buy Prada Boots online",
"url": "https://images.vestiairecollective.com/produit/44128866-2_2.jpg",
"resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/44128866-2_2.jpg"
},
{
"alt": "Luxury Prada Boots Women",
"url": "https://images.vestiairecollective.com/produit/44128866-3_2.jpg",
"resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/44128866-3_2.jpg"
},
{
"alt": "Second hand Shoes Women",
"url": "https://images.vestiairecollective.com/produit/44128866-4_2.jpg",
"resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/44128866-4_2.jpg"
},
{
"alt": "Boots Prada",
"url": "https://images.vestiairecollective.com/produit/44128866-5_2.jpg",
"resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/44128866-5_2.jpg"
},
{
"alt": "Boots Prada",
"url": "https://images.vestiairecollective.com/produit/44128866-6_2.jpg",
"resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/44128866-6_2.jpg"
},
{
"alt": "Boots Prada",
"url": "https://images.vestiairecollective.com/produit/44128866-7_2.jpg",
"resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/44128866-7_2.jpg"
},
{
"alt": "Boots Prada",
"url": "https://images.vestiairecollective.com/produit/44128866-8_2.jpg",
"resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/44128866-8_2.jpg"
},
{
"alt": "Boots Prada",
"url": "https://images.vestiairecollective.com/produit/44128866-9_2.jpg",
"resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/44128866-9_2.jpg"
}
],
"seller": {
"id": 3766695,
"badges": [
"expert-seller",
"fashion-activist"
],
"username": "al3766695",
"country_code": "HK",
"rating_badge": "Expert",
"products_sold": 68,
"products_listed": 22
},
"sold_at": "2026-10-05T01:24:33Z",
"category": [
{
"id": 3,
"name": "Shoes"
},
{
"id": 62,
"name": "Boots"
},
{
"id": 237,
"name": "Others"
}
],
"in_stock": false,
"material": {
"id": 4,
"name": "Suede"
},
"reserved": false,
"universe": {
"id": 1,
"name": "Women"
},
"available": true,
"condition": {
"id": 3,
"name": "Very good condition"
},
"listed_at": "2024-05-13T04:45:46Z",
"description": "Prada black suede heeled boots\n\nComes with spare heel lifts and original box\n\nRarely worn\n\nHeel height 7.5cm\n\nSoles have cracks possibly from storage and ageing (photos provided)",
"authenticity": {
"receipt": true,
"includes_authentication_fees": null
},
"measurements": [
{
"name": "Heel height",
"unit": "cm",
"value": "7.5"
}
],
"original_price": null,
"direct_shipping": false,
"price_breakdown": null,
"discount_percent": null
},
"locale": "en",
"country": "GB"
},
"meta": {
"billable": true,
"endpoint_family": "product"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A query parameter is missing or invalid. This response is not billable.
{
"errors": {
"product": [
"Send a listing id or a listing url as product."
]
},
"message": "The request validation failed"
}Not Found
No listing has this id. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "product"
},
"error": {
"code": "NOT_FOUND",
"message": "Vestiaire Collective has no listing with this id."
},
"success": false
}Upstream Unavailable
Vestiaire Collective did not answer. Retry in a few seconds. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "Vestiaire Collective is temporarily unavailable. Please retry."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.