Piloterr

Vinted Search

GET
/v2/vinted/search

Search Vinted second-hand listings by keyword or catalog URL across vinted.fr, vinted.com and other domains. Returns results and pagination.

Credit cost: 1 credit per call

Authorization

ApiKeyAuth
headerx-api-key<token>

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

Query Parameters

query*string

Search keyword or full Vinted catalog URL. Filters from the URL query string are forwarded to the internal Vinted API.

Examples (keyword):

nike

Example (catalog URL):

https://www.vinted.com/catalog?search_text=dresses%20for%20woman

Notes:

  • Keyword searches default to vinted.fr unless you set region.
  • Catalog URLs keep their domain (vinted.com, vinted.de, etc.).
page?number

Page number. Default 1.

per_page?number

Results per page. Default 24.

order?string

Optional sort order.

  • newest_first
relevance
price_low_to_high
price_high_to_low
region?string

Force the Vinted domain when query is a keyword only.

Examples:

fr
https://www.vinted.fr
https://www.vinted.de
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/vinted/search?query=string'
Example Response
{  "results": [    {      "id": 10671681930,      "url": "https://www.vinted.com/items/10671681930-boutique-clothes",      "path": "/items/10671681930-boutique-clothes",      "photo": {        "url": "https://images1.vinted.net/t/06_017cb_ii7N7PvDJ8YN3Q5QLceLKpxf/310x430/260556ef.webp?s=2201d1dccba5648071e278363d6469c2b7d8e499"      },      "price": {        "amount": "$4.00",        "currency_code": "USD"      },      "title": "boutique clothes",      "status": "New without tags",      "size_title": "S / US 4-6"    }  ],  "pagination": {    "next": 2,    "page": 1,    "per_page": 24,    "total_pages": 21,    "total_results": 500  }}