Vinted Item
Fetch a Vinted listing by item URL or numeric ID. Parses the public item page (Next.js payload), returns a normalized snake_case object with photos, attributes, shipping, pricing, and optional seller profile.
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
Vinted item URL or numeric item ID.
Examples (URL: recommended):
https://www.vinted.com/items/9437210920-purple-prom-dressExample (ID only):
9437210920Notes:
- Domain is inferred from the URL (
vinted.fr,vinted.com, …). - With a bare numeric ID, Piloterr tries the main Vinted domains until the item is found.
- Use
regionto force a domain and skip the multi-domain lookup.
region?string
Force the Vinted domain when query is a bare item ID only.
Examples:
comhttps://www.vinted.comhttps://www.vinted.deNotes:
- Ignored when
queryis a full item URL. - Speeds up lookups when you already know the marketplace.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v2/vinted/item?query=string"{ "id": 9437210920, "url": "https://www.vinted.com/items/9437210920-purple-prom-dress", "user": { "id": 3163220665, "city": "CHAMBERSBURG, PA", "login": "gingertastic88", "photo": { "id": 317632205, "url": "https://images1.vinted.net/t/01_00734_TjeYgCPBFTM9wAukJhk91fHm/f800/1781705165.webp?s=996d52a34c31e60e6cad8c3ad1d0bd504928d6e8", "width": 96, "height": 96 }, "business": false, "item_count": 10, "profile_url": "https://www.vinted.com/member/3163220665-gingertastic88", "country_code": "US", "verification": { "email": { "valid": true, "available": true }, "google": { "valid": true, "available": true, "verified_at": "2026-06-17T08:06:05-06:00" } }, "country_title": "United States", "feedback_count": 1, "feedback_reputation": 1, "positive_feedback_count": 1 }, "color": "Purple", "price": { "amount": "9.0", "currency_code": "USD" }, "title": "Purple prom dress", "photos": [ { "id": 39947998424, "url": "https://images1.vinted.net/t/03_01b9c_waHhWwt2YUWWt6mHUEY8DPbs/f800/1784471551.webp?s=895a7ec5100a7bc29e98d171869c4c1ab510ac13", "width": 600, "height": 800, "is_main": true, "full_size_url": "https://images1.vinted.net/tc/03_01b9c_waHhWwt2YUWWt6mHUEY8DPbs/1784471551.webp?s=e1d11e587899e731615fee24ed0c6cd41d6ab0fe" } ], "status": "New without tags", "can_buy": true, "plugins": { "favourite": { "seller_id": 3163220665, "is_favourite": false, "favourite_count": 0 }, "breadcrumbs": { "brand_id": 1, "catalog_id": 1777, "breadcrumbs": [ { "url": "/catalog/1904-women", "title": "Women" }, { "url": "/catalog/4-clothing", "title": "Clothing" }, { "url": "/catalog/10-dresses", "title": "Dresses" }, { "url": "/catalog/1774-special-occasion-dresses", "title": "Special-occasion dresses" }, { "url": "/catalog/1777-prom-dresses", "title": "Prom dresses" } ] }, "description": { "description": "Long purple prom dress, one strap" }, "item_status": { "is_draft": false, "promoted": true, "is_closed": false, "is_hidden": false, "is_reserved": false, "transaction_permitted": true } }, "brand_id": 1, "category": "Women Prom dresses", "promoted": true, "seller_id": 3163220665, "attributes": { "size": { "id": 506, "value": "S / US 4-6" }, "color": "Purple", "status": { "id": 50, "value": "New without tags" }, "upload_date": "an hour ago" }, "catalog_id": 1777, "size_title": "S / US 4-6", "description": "Long purple prom dress, one strap", "instant_buy": true, "uploaded_at": "an hour ago", "is_favourite": false, "favourite_count": 0, "pricing_services": { "services": { "shipping": { "type": "shipping", "is_free": true, "final_price": { "amount": "0", "currency_code": "USD" }, "original_price": { "amount": "6.69", "currency_code": "USD" } }, "buyer_protection": { "type": "buyer_protection", "is_free": false, "final_price": { "amount": "1.15", "currency_code": "USD" }, "original_price": { "amount": "1.15", "currency_code": "USD" } } }, "total_amount": { "amount": "10.15", "currency_code": "USD" }, "original_asking_amount": { "amount": "9", "currency_code": "USD" } }, "shipping_details": { "price": { "amount": "0", "currency_code": "USD" }, "discount": null, "is_pickup_only": false, "is_free_shipping": true, "are_multiple_shipping_options_available": false }}{ "error": "Bad Request"}{ "error": "Invalid API Key"}{ "error": "Payment required"}{ "error": "Rate limit exceeded for the API key: quota monthly"}{ "error": "Internal Error"}