# Vestiaire Collective Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/vestiairecollective/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/vestiairecollective-search |

## Access

This endpoint is **private**. Requests return HTTP 403 until access is granted. There is no self-serve request-access button. Open a support ticket from the dashboard Help desk (https://app.piloterr.com/app?returnTo=help-desk/tickets/new) and include the endpoint path, your use case, target fields, and expected volume.

## Description

Search Vestiaire Collective secondhand luxury listings by keyword or brand and get price, condition, brand, size, and seller info as structured JSON.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/vestiairecollective/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search Gucci bags

```json
{
  "page": 1,
  "results": [
    {
      "id": "65518631",
      "url": "https://us.vestiairecollective.com/women-bags/handbags/gucci/beige-leather-gucci-handbag-65518631.shtml",
      "name": "Leather handbag",
      "size": "One Size",
      "sold": false,
      "brand": "Gucci",
      "color": "Beige",
      "likes": 18,
      "category": "Handbags",
      "universe": "Women",
      "condition": "Very good condition",
      "image_url": "https://images.vestiairecollective.com/produit/65518631-1.jpg",
      "created_at": "2026-04-15T14:22:00Z",
      "is_vintage": false,
      "price_amount": 749,
      "price_currency": "USD",
      "seller_country": "United States",
      "direct_shipping": true,
      "price_formatted": "$749"
    },
    {
      "id": "64184527",
      "url": "https://us.vestiairecollective.com/men-clothing/t-shirts/gucci/white-cotton-gucci-t-shirt-64184527.shtml",
      "name": "T-shirt",
      "size": "M International",
      "sold": false,
      "brand": "Gucci",
      "color": "White",
      "likes": 7,
      "category": "T-shirts",
      "universe": "Men",
      "condition": "Good condition",
      "image_url": "https://images.vestiairecollective.com/produit/64184527-1.jpg",
      "created_at": "2026-04-10T09:45:00Z",
      "is_vintage": false,
      "price_amount": 205,
      "price_currency": "USD",
      "seller_country": "France",
      "direct_shipping": false,
      "price_formatted": "$205"
    }
  ],
  "total_pages": 182,
  "total_results": 4382
}
```

### Search vintage Balenciaga women's clothing

```json
{
  "page": 1,
  "results": [
    {
      "id": "63947128",
      "url": "https://us.vestiairecollective.com/women-clothing/jackets/balenciaga/black-leather-balenciaga-jacket-63947128.shtml",
      "name": "Leather jacket",
      "size": "38 FR",
      "sold": false,
      "brand": "Balenciaga",
      "color": "Black",
      "likes": 34,
      "category": "Jackets",
      "universe": "Women",
      "condition": "Very good condition",
      "image_url": "https://images.vestiairecollective.com/produit/63947128-1.jpg",
      "created_at": "2026-04-08T16:00:00Z",
      "is_vintage": true,
      "price_amount": 1190,
      "price_currency": "USD",
      "seller_country": "Italy",
      "direct_shipping": false,
      "price_formatted": "$1,190"
    }
  ],
  "total_pages": 37,
  "total_results": 891
}
```

## Documentation

## Overview
Vestiaire Collective is the global marketplace for authenticated pre-owned luxury fashion. It uses Cloudflare to block automated access. Piloterr handles the bypass and returns structured search results as clean JSON.

## Quickstart
```
GET https://api.piloterr.com/v2/vestiairecollective/search?query=gucci+bag&universe=women
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Keyword, brand, or category |
| `universe` | string | no | `women`, `men`, or `kids` |
| `category` | string | no | Filter: `bags`, `clothing`, `shoes`, etc. |
| `brand` | string | no | Brand slug (e.g. `gucci`) |
| `condition` | string | no | `never_worn`, `very_good`, `good`, `fair` |
| `min_price` | integer | no | Minimum price in USD |
| `max_price` | integer | no | Maximum price in USD |
| `sort` | string | no | `relevance`, `price_asc`, `newest` |
| `page` | integer | no | Page number |
| `per_page` | integer | no | Results per page (max: 48) |

## Main use cases
- Track resale price trends for specific luxury brands
- Build brand-level resale value reports by condition and size
- Monitor sell-through velocity using the likes field as a demand proxy
- Power sourcing tools that surface underpriced items
- Feed competitive intelligence pipelines with real-time secondhand pricing

Get access at https://www.piloterr.com/pricing