# Vestiaire Collective Listing API Documentation

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.

- **Documentation:** [https://scrappa.co/docs/vestiaire-api/vestiaire_product](https://scrappa.co/docs/vestiaire-api/vestiaire_product) - **API group:** Vestiaire Collective API - **Endpoint:** `GET https://scrappa.co/api/vestiaire/product` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `product` | string | Yes | A numeric listing id (e.g. 66976019) or a listing url ending in -{id}.shtml. | | `country` | string | No | 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. | | `locale` | string | No | Language of names and labels: en, it, fr, de or es. Defaults to the language of the country. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A query parameter is missing or invalid. This response is not billable. | | 404 | Not Found | No listing has this id. This response is not billable. | | 503 | Upstream Unavailable | Vestiaire Collective did not answer. Retry in a few seconds. This response is not billable. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)