Piloterr

Vestiaire Collective Search

GET
/v2/vestiairecollective/search

Search Vestiaire Collective by keyword or catalog URL. Each card has brand, name, price, size, and a product link.

Credit cost: 2 credits per call

Autorização

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Parâmetros de consulta

query*string

A keyword or a vestiairecollective.com search or category URL. Empty, another host, or a product URL returns 400. A keyword searches www.vestiairecollective.com. A full URL keeps its host. Each card has price as a number and price_display as the label on the card.

Keyword

chanel

Category URL

https://fr.vestiairecollective.com/sacs-femme/
page?number

Page number starting at 1. Omit it for page 1, which has no /p-N/ segment. Page 2 requests /p-2/ and sets pagination.page to 2. pagination.next is the next catalog URL, or null on the last page. A value below 1 returns 400.

return_page_source?boolean

Default false. true replaces results and pagination with result, the rendered HTML.

Corpo da resposta

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/vestiairecollective/search?query=string'
Example Response
{  "results": [    {      "id": "73024488",      "url": "https://www.vestiairecollective.com/vetements-femme/vestes/chanel/vesteblouson-chanel-la-petite-veste-noire-en-tweed-rose-73024488.shtml",      "name": "Blouson en tweed La Petite Veste Noire",      "size": "34 FR",      "brand": "CHANEL",      "image": "https://images.vestiairecollective.com/images/resized/w=768,q=75,f=auto,/produit/vesteblouson-chanel-la-petite-veste-noire-en-tweed-rose-73024488-1_2.jpg",      "price": 1315,      "currency": "EUR",      "ships_from": "France",      "price_display": "1315 €"    }  ],  "pagination": {    "next": "https://www.vestiairecollective.com/search/p-2/?q=chanel",    "page": 1,    "per_page": 15,    "total_pages": null,    "total_results": 999  }}