# Vinted API Item Details Looking for official Vinted API documentation or a public API for item details? Vinted does not provide a generally available public API for developers. Scrappa provides a documented Vinted item details API endpoint that returns listing title, description, photos, pricing, shipping costs, seller profile, item condition, brand, size, category, favorites, and view counts as structured JSON across 19 countries. Use this endpoint when a Vinted search result needs to become a complete product record for resale analytics, price monitoring, catalog enrichment, fraud review, or seller-quality scoring. A typical workflow is to find item IDs with the Vinted Search Items endpoint, enrich each listing with Item Details, compare alternatives with Similar Items, and check delivery context with Item Shipping. Item Details is the enrichment step in a Vinted data workflow. Search results are useful for discovery, but the item details response is where applications can inspect the listing description, gallery, seller reputation, favorites, views, availability, category, localized condition, brand, size, relative upload age, starting shipping price, business status, source URL, and image fields before storing or scoring a product record. Set include_member_items=1 to make an additional upstream request for the seller’s other listing cards. A normal request costs one API request; enabling member items costs two API requests. Successful item responses use listing_status active, sold, hidden, or unavailable. Sold listings return HTTP 200 with availability set to https://schema.org/OutOfStock. A Vinted 404 returns listing_status=not_found because a public request cannot reliably distinguish deletion from a seller-hidden listing. An explicit no-index country shell returns unavailable_in_country. Proxy, blocking, and unparseable upstream pages return listing_status=temporarily_unavailable. Page-derived fields are nullable when Vinted omits them. shipping.from is the displayed starting price, not a guaranteed final delivery cost. upload_date remains Vinted’s localized relative text rather than an inferred timestamp. Always pass the listing country: Vinted may return a reduced page or 404 for an item that is visible in its home market. - **Documentation:** [https://scrappa.co/docs/vinted-api/vinted_item_details](https://scrappa.co/docs/vinted-api/vinted_item_details) - **API group:** Vinted API - **Endpoint:** `GET https://scrappa.co/api/vinted/item-details` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `item_id` | string | Yes | The Vinted item ID | | `country` | string | No | Country code for Vinted domain. Defaults to FR. | | `include_member_items` | boolean | No | Set to 1 to make a second upstream request and return member_items. This opt-in request costs two API requests instead of one. | ## Example request ```bash #!/bin/bash curl -X GET \ -H "x-api-key: YOUR_API_KEY_HERE" \ "https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1" ``` ## Example response ```json { "success": true, "data": { "item": { "id": "1234567890", "title": "Nike Air Max 90", "description": "Great condition Nike Air Max 90 sneakers. Barely worn and shipped in the original box.", "price": { "amount": 45, "currency": "EUR" }, "total_item_price": 50.49, "shipping_price": 3.49, "service_fee": 2, "brand": "Nike", "category": "Shoes", "size": "EU 42", "color": "Black", "condition": "Very good", "condition_title": "Very good", "condition_details": "Sehr gut", "upload_date": "vor 17 Stunden", "shipping": { "from": { "amount": 3.49, "currency": "EUR" } }, "business": false, "url": "https://www.vinted.de/items/1234567890-nike-air-max-90", "availability": "InStock", "listing_status": "active", "image_url": "https://images1.vinted.net/t/01_01234_example/image.jpg", "photos": [ { "url": "https://images1.vinted.net/t/01_01234_example/image.jpg" }, { "url": "https://images1.vinted.net/t/02_01234_example/image.jpg" }, { "url": "https://images1.vinted.net/t/03_01234_example/image.jpg" } ], "seller": { "id": 98765432, "login": "seller123", "feedback_count": 50, "feedback_reputation": 4.8 }, "favourite_count": 15, "view_count": 234, "member_items": [ { "id": "1234567891", "title": "Nike Sportswear Hoodie", "url": "https://www.vinted.de/items/1234567891-nike-sportswear-hoodie", "photo_url": "https://images1.vinted.net/t/01_01235_example/image.jpg", "price": { "amount": 22, "currency": "EUR" }, "favourite_count": 28 } ] } }, "message": "Item details retrieved successfully", "meta": { "duration_ms": 123.45, "scraped_at": "2026-02-01T00:00:00.000Z", "cached": false } } ``` ## Frequently asked questions ### Is there official Vinted API documentation for item details? Vinted does not publish official public API documentation for a generally available item details endpoint. Scrappa documents a Vinted API alternative that returns item details as structured JSON with API key authentication. ### Does Vinted have a public API for developers? Vinted does not offer a public API that developers can sign up for and query directly. Use this Scrappa endpoint when you need programmatic access to Vinted listing data without maintaining your own scraper. ### What data does the Vinted API item details endpoint return? The endpoint returns item-level fields such as title, description, photos, price, brand, size, localized condition, relative upload age, starting shipping price, seller business status, other listings from the member, category, favorites, views, availability, and listing URL where available. Page-derived fields are null when Vinted omits them. ### How are sold, deleted, hidden, and unavailable Vinted listings represented? Sold pages return HTTP 200 with listing_status sold and Schema.org OutOfStock availability. A page that explicitly exposes Vinted’s hidden flag returns listing_status hidden. A public Vinted 404 returns listing_status not_found because deleted and seller-hidden pages are indistinguishable to logged-out requests. Country-restricted shells return unavailable_in_country, while transient upstream or proxy failures return temporarily_unavailable. Favorite and view counts are null when Vinted omits them. ### What can I build with Vinted item details data? Teams use item details data for resale price monitoring, catalog enrichment, secondhand fashion analytics, seller-quality scoring, duplicate listing review, inventory alerts, and marketplace research workflows. ### How do I get the item_id for this endpoint? Use the Vinted Search Items endpoint to find listings by query, brand, category, price, or other filters. Each search result includes the item ID you can pass to this item details endpoint. ## Related endpoints - [Search Items](https://scrappa.co/docs/vinted-api/vinted_search) - [Item Shipping](https://scrappa.co/docs/vinted-api/vinted_item_shipping) - [Similar Items](https://scrappa.co/docs/vinted-api/vinted_similar_items) - [User Profile](https://scrappa.co/docs/vinted-api/vinted_user_profile) ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)