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

Autorización

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

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

Cuerpo de la respuesta

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": 9417084957,      "url": "https://www.vinted.com/items/9417084957-tempted-black-draped-cowl-neck-short-sleeve-mini-dress",      "path": "/items/9417084957-tempted-black-draped-cowl-neck-short-sleeve-mini-dress",      "user": {        "id": 3167755373,        "login": "example-user",        "photo": {          "id": 321171847,          "url": "https://images1.vinted.net/placeholder/example-user.jpg",          "width": 600,          "height": 800        },        "business": false,        "profile_url": "https://www.vinted.com/member/example-user"      },      "photo": {        "id": 39862469776,        "url": "https://images1.vinted.net/t/02_023f8_BqApqrfHRr4eYif4gfmsy9a7/f800/1784247894.jpeg?s=2f0f0b44d41db05b396ceae775aef3c37f8116be",        "width": 600,        "height": 800,        "is_main": true      },      "price": {        "amount": "25.0",        "currency_code": "USD"      },      "title": "Tempted Black Draped Cowl-Neck Short Sleeve Mini dress",      "photos": [        {          "id": 39862469776,          "url": "https://images1.vinted.net/t/02_023f8_BqApqrfHRr4eYif4gfmsy9a7/f800/1784247894.jpeg?s=2f0f0b44d41db05b396ceae775aef3c37f8116be",          "width": 600,          "height": 800,          "is_main": true,          "image_no": 1        }      ],      "status": "Very good",      "item_box": {        "item_id": 9417084957,        "first_line": "tempted",        "second_line": "S / US 4-6 · Very good"      },      "promoted": true,      "is_visible": true,      "size_title": "S / US 4-6",      "brand_title": "tempted",      "service_fee": {        "amount": "1.95",        "currency_code": "USD"      },      "is_favourite": false,      "content_source": "search_promoted_items",      "favourite_count": 55,      "total_item_price": {        "amount": "26.95",        "currency_code": "USD"      }    },    {      "id": 9422855356,      "url": "https://www.vinted.com/items/9422855356-wild-fable-coral-pink-maxi-dress-with-floral-cups-and-open-back",      "path": "/items/9422855356-wild-fable-coral-pink-maxi-dress-with-floral-cups-and-open-back",      "user": {        "id": 3168044178,        "login": "example-user-2",        "photo": {          "id": 321347671,          "url": "https://images1.vinted.net/placeholder/example-user-2.jpg",          "width": 600,          "height": 800        },        "business": false,        "profile_url": "https://www.vinted.com/member/example-user-2"      },      "photo": {        "id": 39887137204,        "url": "https://images1.vinted.net/t/06_00485_DbqyZigqBuvGGQTL4icBDLi5/f800/1784313642.jpeg?s=cf2c907b215da3820cb5abe89e418d934131512c",        "width": 600,        "height": 800,        "is_main": true      },      "price": {        "amount": "12.0",        "currency_code": "USD"      },      "title": "Wild Fable coral pink maxi dress with floral cups and open back",      "photos": [        {          "id": 39887137204,          "url": "https://images1.vinted.net/t/06_00485_DbqyZigqBuvGGQTL4icBDLi5/f800/1784313642.jpeg?s=cf2c907b215da3820cb5abe89e418d934131512c",          "width": 600,          "height": 800,          "is_main": true,          "image_no": 1        },        {          "id": 39887137208,          "url": "https://images1.vinted.net/t/03_01bd1_h7xRSJBdzL1FQLZ1vmC3Q7XZ/f800/1784313642.jpeg?s=fc2b14c3a747ec275d0c8f9e0ddef236be217ca3",          "width": 600,          "height": 800,          "is_main": false,          "image_no": 2        }      ],      "status": "Very good",      "item_box": {        "item_id": 9422855356,        "first_line": "Wild Fable",        "second_line": "S / US 4-6 · Very good"      },      "promoted": false,      "is_visible": true,      "size_title": "S / US 4-6",      "brand_title": "Wild Fable",      "service_fee": {        "amount": "1.3",        "currency_code": "USD"      },      "is_favourite": false,      "content_source": "search",      "favourite_count": 52,      "total_item_price": {        "amount": "13.3",        "currency_code": "USD"      }    }  ],  "pagination": {    "next": 2,    "page": 1,    "per_page": 24,    "total_pages": 40,    "total_results": 960  }}

Vinted Item GET

Anterior

Vinted User Info GET

Siguiente