Sign inGet a free API keyDashboard
Menu

APIs / Marketplaces / Vestiaire Collective

1 credit per call2 endpoints19 datapoints

Vestiaire Collective API

Vestiaire Collective API for pre-owned luxury search by brand, condition and price, sold items and product details as JSON. 1 credit per successful call.

Get a free API keyRun it below
Vestiaire Collective
GET/v1/vestiaire/search?query=prada&price_max=300&sort=price-asc&country=GB
{
  "success": true,
  "data": {
    "items": [
      {
        "id": 68777751,
        "name": "Sunglasses",
        "description": "Prada spr 57n silver tortoise brown logo y2k sunglasses\n\nPerfect condition",
        "url": "https://www.vestiairecollective.com/men-accessories/sunglasses/prada/silver-metal-prada-sunglasses-68777751.shtml",
        "brand": {
          "id": 60,
          "name": "Prada"
        },
        "condition": {
          "id": 3,
          "name": "Very good condition"
        },
        "category": {
          "id": 42,
          "name": "Sunglasses"
        },
        "parent_category": {
          "id": 14,
          "name": "Accessories"
        },
        "colors": [
          {
            "id": 15,
            "name": "Silver"
          }
        ],
        "price": {
          "amount": 300,
          "currency": "GBP"
        },
        "images": [
          {
            "url": "https://images.vestiairecollective.com/produit/68777751-1_2.jpg",
            "resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/68777751-1_2.jpg"
          }
        ],
        "seller": {
          "id": 22860387,
          "first_name": "eloessa",
          "badge": "Trusted",
          "is_official_store": false
        },
        "seller_country": "PL",
        "sold": false,
        "stock": false,
        "likes": 0,
        "listed_at": "2026-07-07T13:18:02Z",
        "editor_picks": {
          "vintage": false,
          "we_love": false,
          "hot": false,
          "deal_eligible": false,
          "exceptional_pieces": false
        },
        "universe_id": 2
      },
      {
        "id": 64237295,
        "name": "Leather wallet",
        "description": "Prada wallet\n\nCognac-colored saffiano, outer compartment with zipper, several compartments inside, one with zipper and removable card holder.\n\nMarked \"PRADA MADE IN ITALY\" approx. 19x3x9 cm\n\nWear from use. Letters with minor wear",
        "url": "https://www.vestiairecollective.com/women-accessories/wallet/prada/camel-leather-prada-wallet-64237295.shtml",
        "brand": {
          "id": 60,
          "name": "Prada"
        },
        "condition": {
          "id": 3,
          "name": "Very good condition"
        },
        "category": {
          "id": 599,
          "name": "Wallets"
        },
        "parent_category": {
          "id": 6,
          "name": "Accessories"
        },
        "colors": [
          {
            "id": 2,
            "name": "Beige"
          },
          {
            "id": 8,
            "name": "Brown"
          },
          {
            "id": 222,
            "name": "Camel"
          }
        ],
        "price": {
          "amount": 300,
          "currency": "GBP"
        },
        "images": [
          {
            "url": "https://images.vestiairecollective.com/produit/64237295-1_2.jpg",
            "resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/64237295-1_2.jpg"
          }
        ],
        "seller": {
          "id": 15360458,
          "first_name": "ellen",
          "is_official_store": false
        },
        "seller_country": "SE",
        "sold": false,
        "stock": false,
        "likes": 5,
        "listed_at": "2026-02-21T14:09:25Z",
        "editor_picks": {
          "vintage": false,
          "we_love": false,
          "hot": false,
          "deal_eligible": false,
          "exceptional_pieces": false
        },
        "universe_id": 1
      },
      {
        "id": 25796014,
        "name": "Sandals",
        "description": "Prada Collection\n\nBrand new in box\nRetails for $900\n\nBrand: Prada Milano\n\nModel/style number: 1X890L\n\nToe Shape: Open\n\nHeel Height: high\n\nUpper Material: Black Suede\n\nSole material: Leather\n\nInsole material: Leather\n\nUS Sizes: 8\nEuro Size: …",
        "url": "https://www.vestiairecollective.com/women-shoes/sandals/prada/black-suede-prada-sandals-25796014.shtml",
        "brand": {
          "id": 60,
          "name": "Prada"
        },
        "condition": {
          "id": 1,
          "name": "Never worn, with tag"
        },
        "category": {
          "id": 507,
          "name": "Sandals"
        },
        "parent_category": {
          "id": 3,
          "name": "Shoes"
        },
        "colors": [
          {
            "id": 14,
            "name": "Black"
          }
        ],
        "size": {
          "id": 35,
          "label": "38.5 EU"
        },
        "price": {
          "amount": 300,
          "currency": "GBP"
        },
        "images": [
          {
            "url": "https://images.vestiairecollective.com/produit/25796014-1_3.jpg",
            "resized_url": "https://images.vestiairecollective.com/images/resized/w=1024,q=75/produit/25796014-1_3.jpg"
          }
        ],
        "seller": {
          "id": 17436339,
          "first_name": "Michael",
          "badge": "Expert",
          "is_official_store": false
        },
        "seller_country": "US",
        "sold": false,
        "stock": false,
        "likes": 16,
        "listed_at": "2022-10-12T02:17:59Z",
        "editor_picks": {
          "vintage": false,
          "we_love": true,
          "hot": false,
          "deal_eligible": false,
          "exceptional_pieces": false
        },
        "universe_id": 1
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 48,
      "total_entries": 127,
      "total_pages": 3,
      "has_more": true,
      "reachable_window": 1008
    },
    "facets": {
      "fields": {
        "category": [
          {
            "id": "59",
            "name": "Handbags",
            "count": 13,
            "parent_id": 5
          },
          {
            "id": "510",
            "name": "Heels",
            "count": 10,
            "parent_id": 3
          },
          {
            "id": "21",
            "name": "Jackets",
            "count": 9,
            "parent_id": 2
          }
        ],
        "condition": [
          {
            "id": "1",
            "name": "Never worn, with tag",
            "count": 9
          },
          {
            "id": "2",
            "name": "Never worn",
            "count": 15
          },
          {
            "id": "3",
            "name": "Very good condition",
            "count": 81
          }
        ]
      },
      "price_range": {
        "min": 19,
        "max": 34636
      }
    },
    "country": "GB",
    "locale": "en"
  },
  "meta": {
    "endpoint_family": "search",
    "request_id": "req_306a1a7ba1494b71b6e4208a0a4d8386",
    "credits_charged": 1,
    "credits_remaining": 1912
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegernamestringdescriptionstringurlurlbrandobjectconditionobjectcategoryobjectparent_categoryobjectcolorsobject[]priceobjectimagesobject[]sellerobjectseller_countrystringsoldbooleanstockbooleanlikesintegerlisted_atstringeditor_picksobjectuniverse_idinteger
168777751SunglassesPrada spr 57n silver tortoise brown logo y2k sunglasses Perfect conditionhttps://www.vestiairecollective.com/men-accessories/sunglasses/prada/silver-metal-prada-sunglasses-68777751.shtml{2 fields}{2 fields}{2 fields}{2 fields}[1 item]{2 fields}[1 item]{4 fields}PLfalsefalse02026-07-07T13:18:02Z{5 fields}2
264237295Leather walletPrada wallet Cognac-colored saffiano, outer compartment with zipper, several compartments inside, one with zipper and removable card holder. Marked "PRADA MADE IN ITALY" approx. 19x3x9 cm Wear from use. Letters with minor wearhttps://www.vestiairecollective.com/women-accessories/wallet/prada/camel-leather-prada-wallet-64237295.shtml{2 fields}{2 fields}{2 fields}{2 fields}[3 items]{2 fields}[1 item]{3 fields}SEfalsefalse52026-02-21T14:09:25Z{5 fields}1
325796014SandalsPrada Collection Brand new in box Retails for $900 Brand: Prada Milano Model/style number: 1X890L Toe Shape: Open Heel Height: high Upper Material: Black Suede Sole material: Leather Insole material: Leather US Sizes: 8 Euro Size: …https://www.vestiairecollective.com/women-shoes/sandals/prada/black-suede-prada-sandals-25796014.shtml{2 fields}{2 fields}{2 fields}{2 fields}[1 item]{2 fields}[1 item]{4 fields}USfalsefalse162022-10-12T02:17:59Z{5 fields}1

Recorded from our API · 3 items shown · 19 datapoints per itemGET /v1/vestiaire/search?query=prada&price_max=300&sort=price-asc&country=GB

19 datapoints

Identity

  • idinteger
  • namestring
  • brandobject
  • categoryobject
  • parent_categoryobject
  • universe_idinteger

Contact

  • urlurl
  • sellerobject

Location

  • seller_countrystring

Reputation

  • imagesobject[]

Price

  • priceobject

Other

  • descriptionstring
  • conditionobject
  • colorsobject[]
  • soldboolean
  • stockboolean
  • likesinteger
  • listed_atstring
  • editor_picksobject

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/vestiaire/search?query=prada&price_max=300&sort=price-asc&country=GB" \
  -H "X-API-Key: $API_KEY"

Vestiaire Collective · 2 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/vestiaire/product
product+2 optional
1 credit
GET/v1/vestiaire/search
none+17 optional
1 credit

Overview

What you can get

The Vestiaire Collective API returns Vestiaire Collective resale data as JSON through 2 endpoints. Both take an optional country (GB, US, IT, FR, DE or ES) and locale (en, it, fr, de or es).

  • Search: search takes a query, with price_min, price_max, sold, sort (relevance, price-asc or price-desc), size_type (women or men), page and per_page. brand[], category[], size[], condition[], color[], material[] and seller_country[] are repeatable.
  • Products: product takes a product.

The recorded search for "prada" in GB with price_max=300 and sort=price-asc returns items, each with id, name, description, url, brand, condition, category, parent_category, colors, price, images, seller (with badge and is_official_store), seller_country, sold, likes and listed_at. It also returns pagination with total_entries (127 in that recording), total_pages and has_more, and facets with a price_range.

How a call works

Search a country: GET /v1/vestiaire/search?query=prada&price_max=300&sort=price-asc&country=GB with your key in the X-API-Key header. Each result carries an id, which product takes as product, as in GET /v1/vestiaire/product?product=66976019. Every successful call costs 1 credit; failed calls cost nothing.

MarketplacesJSONRESTMCP

More marketplaces APIs

About YouadidasAliExpressAllegroAmazonASOSBilliger.debol.comChrono24CostcoCraigslistDBA

Use cases

Track pre-owned prices for a luxury brand by condition

Use the Vestiaire Collective API to track pre-owned prices for a luxury brand by condition

See what items sold for with `sold`

Use the Vestiaire Collective API to see what items sold for with `sold`

Compare prices across GB, US, IT, FR, DE and ES

Use the Vestiaire Collective API to compare prices across GB, US, IT, FR, DE and ES

Narrow a search by seller country with `seller_country[]`

Use the Vestiaire Collective API to narrow a search by seller country with `seller_country[]`

FAQ

Questions

How much does the Vestiaire Collective API cost?

Each successful call costs one credit, and each search page is one call. New accounts get free credits to start, and credit packs bring the price down as you scale.

Can I search sold items?

Yes. Pass `sold` to `search`.

Do I need a Vestiaire Collective account?

No. You call this Vestiaire Collective API with your Perceptlayer key in the `X-API-Key` header, with no Vestiaire Collective login.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Should I build a Vestiaire Collective scraper instead?

You can, but a Vestiaire Collective scraper is code you maintain: page changes break it, requests get blocked, and Vestiaire Collective's terms govern how you collect data. The Vestiaire Collective API gives you 2 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Vestiaire Collective API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs