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 x-api-key<token>
Your API key. Include it in the x-api-key header for every request.
In: header
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):
nikeExample (catalog URL):
https://www.vinted.com/catalog?search_text=dresses%20for%20womanNotes:
- Keyword searches default to
vinted.frunless you setregion. - 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
relevanceprice_low_to_highprice_high_to_lowregion?string
Force the Vinted domain when query is a keyword only.
Examples:
frhttps://www.vinted.frhttps://www.vinted.deCuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/vinted/search?query=string"{ "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": "laceejayy", "photo": { "id": 321171847, "url": "https://images1.vinted.net/t/01_000e3_gsMsJcE1AKa2GfL23XAnjz5P/f800/1783634863.jpeg?s=5c18d0103555bbed3ddca66fe9e12ad631f2f4da", "width": 600, "height": 800 }, "business": false, "profile_url": "https://www.vinted.com/member/3167755373-laceejayy" }, "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": "gabriellamiah", "photo": { "id": 321347671, "url": "https://images1.vinted.net/t/05_00074_fgpRk7bEdNFrM2D5x158Vubm/f800/1783751489.jpeg?s=43ca2d96f54cc36d797dda7a281bdc7d8cd12734", "width": 600, "height": 800 }, "business": false, "profile_url": "https://www.vinted.com/member/3168044178-gabriellamiah" }, "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 }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}