# Vinted Search ## Overview | Property | Value | |----------|-------| | **Status** | active | | **Method** | `GET` | | **Endpoint** | `/v2/vinted/search` | | **Base URL** | `https://api.piloterr.com` | | **Credit Cost** | 1 credit per call | | **Documentation** | https://www.piloterr.com/library/vinted-search | ## Description Search Vinted second-hand listings by keyword or catalog URL across vinted.fr, vinted.com and other domains. Returns results and pagination. ## Authentication - **Key Name:** `x-api-key` - **Location:** HTTP Header - **Get an API key:** https://app.piloterr.com/register ## Example Request ```bash curl --location --request GET 'https://api.piloterr.com/v2/vinted/search' \ --header 'Content-Type: application/json' \ --header 'x-api-key: YOUR_API_KEY' ``` ## Example Response ### Catalog search on vinted.com (dresses) ```json { "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 } } ``` ## Documentation ## Overview Search Vinted second-hand listings through Piloterr. Pass a keyword or a full catalog URL; Piloterr calls the internal Vinted API (`/api/v2/catalog/items`) with an auto-managed session cookie. Works across Vinted domains: `vinted.fr`, `vinted.com`, `vinted.de`, `vinted.co.uk`, and more. Costs **1 credit** per call. ## Workflow Typical flow on Piloterr: 1. **Search** (this endpoint) to list matching items 2. **[Vinted Item](/v2/vinted/item)** for full listing details 3. **[Vinted User Info](/v2/vinted/user/info)** for seller profile data ## Quickstart ``` GET https://api.piloterr.com/v2/vinted/search?query=nike®ion=https://www.vinted.fr&page=1&per_page=24 GET https://api.piloterr.com/v2/vinted/search?query=https://www.vinted.com/catalog?search_text=dresses%20for%20woman&per_page=24 ``` ## Parameters | Parameter | Type | Required | Default | Description | |---|---|---|---|---| | `query` | string | yes | - | Keyword or Vinted catalog URL | | `page` | integer | no | `1` | Page number | | `per_page` | integer | no | `24` | Results per page | | `order` | string | no | - | Sort: `newest_first`, `relevance`, `price_low_to_high`, `price_high_to_low` | | `region` | string | no | `vinted.fr` | Force domain when `query` is a keyword | ## Response ```json { "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 \u00b7 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 \u00b7 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 } } ``` | Field | Description | |---|---| | `results[]` | Listing cards from the Vinted catalog search | | `results[].id` | Item ID: pass to **[Vinted Item](/v2/vinted/item)** | | `results[].url` | Canonical item URL on the Vinted domain | | `results[].path` | Item path slug | | `results[].title` | Listing title | | `results[].status` | Condition label (`New without tags`, `Very good`, …) | | `results[].size_title` | Size label | | `results[].brand_title` | Brand name when available | | `results[].price.amount` | Listing price (string) | | `results[].price.currency_code` | Currency code (`EUR`, `USD`, …) | | `results[].service_fee` | Buyer protection fee | | `results[].total_item_price` | Price including buyer protection | | `results[].photo` | Main listing image (card thumbnail) | | `results[].photos` | All listing images (may include multiple entries) | | `results[].user` | Seller snapshot (`id`, `login`, `profile_url`, optional `photo`) | | `results[].item_box` | Card display metadata (`first_line`, `second_line`, …) | | `results[].promoted` | Whether the listing is boosted | | `results[].is_visible` | Whether the listing is visible in search | | `results[].is_favourite` | Favourite flag for the current session | | `results[].favourite_count` | Number of favourites | | `results[].content_source` | Result source (`search`, `search_promoted_items`, …) | | `pagination.page` | Current page | | `pagination.per_page` | Page size | | `pagination.total_results` | Total matches | | `pagination.total_pages` | Total pages | | `pagination.next` | Next page number, or omitted on the last page | ## Error codes | Code | Meaning | |---|---| | `400` | Empty or invalid `query` | | `403` | Access blocked (anti-bot, session rejected) | | `404` | Search unavailable or invalid session | ## Good to know - Vinted requires a session cookie; Piloterr fetches and refreshes it automatically. - Search returns the raw Vinted catalog card schema (camelCase keys as returned by Vinted). Use **[Vinted Item](/v2/vinted/item)** for the normalized `snake_case` detail view. - Some domains (especially `.fr`) may be harder to reach because of Cloudflare. - Public data only, no user login. ## Main use cases - Monitor new listings for a brand or keyword across European Vinted markets - Build resale price intelligence pipelines with pagination - Feed item IDs into the Vinted Item endpoint for enrichment