Vinted API Item Details
Vinted listing data API
Fetch complete Vinted item details as structured JSON
This page is for developers searching for a Vinted item details API, Vinted product details endpoint, or official Vinted API documentation alternative. Use it to enrich listing IDs with price, photos, seller ratings, condition, brand, size, shipping cost, and marketplace metadata without maintaining a browser scraper.
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.
Implementation playbook
What teams build with this endpoint
Listing enrichment
Turn Vinted item IDs from search results into complete JSON records with title, description, photos, price, brand, size, condition, category, availability, source URL, favorites, and views.
Resale price monitoring
Store item detail snapshots for selected brands, sizes, categories, and countries so pricing tools can compare total item price, shipping, service fees, condition, and seller context over time.
Seller-aware product records
Combine item details with seller reputation data before routing listings into catalog enrichment, fraud review, inventory alerts, marketplace research, or duplicate listing checks.
Run this endpoint
Endpoint
https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1
https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1
x-api-key
item_id
= 1234567890
{
"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,
...
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
2 optional filters available.
string
Required
The Vinted item ID
1234567890
string
Optional
Country code for Vinted domain. Defaults to FR.
DE
boolean
Optional
Set to 1 to make a second upstream request and return member_items. This opt-in request costs two API requests instead of one.
1
Request Examples
<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: YOUR_API_KEY_HERE"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
<?php
use Illuminate\Support\Facades\Http;
$response = Http::timeout(30)
->withHeaders(['x-api-key' => 'YOUR_API_KEY_HERE'])
->get('https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1');
if ($response->successful()) {
echo $response->body();
} else {
echo "Error: " . $response->status();
}
const options = {
method: 'GET',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE'
}
};
fetch('https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1', options)
.then(response => {
if (!response.ok) {
throw new Error(`HTTP error! status: ${response.status}`);
}
return response.text();
})
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
const axios = require('axios');
const options = {
method: 'GET',
url: 'https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1',
headers: {
x-api-key: 'YOUR_API_KEY_HERE',
}
};
try {
const response = await axios(options);
console.log(response.data);
} catch (error) {
console.error('Error:', error.message);
}
require 'net/http'
require 'uri'
uri = URI.parse("https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'
request = Net::HTTP::Get.new(uri.request_uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'
begin
response = http.request(request)
puts response.body
rescue => e
puts "Error: #{e.message}"
end
import http.client
import json
conn = http.client.HTTPSConnection("scrappa.co")
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
conn.request("GET", "/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1", headers=headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))
except Exception as e:
print(f"Error: {e}")
finally:
conn.close()
import requests
headers = {
'x-api-key': 'YOUR_API_KEY_HERE',
}
try:
response = requests.get('https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1', headers=headers)
response.raise_for_status()
print(response.text)
except requests.exceptions.RequestException as e:
print(f"Error: {e}")
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;
public class ApiExample {
public static void main(String[] args) {
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1")
.addHeader("x-api-key", "YOUR_API_KEY_HERE")
.build();
try (Response response = client.newCall(request).execute()) {
if (response.isSuccessful()) {
System.out.println(response.body().string());
} else {
System.out.println("Error: " + response.code());
}
} catch (IOException e) {
System.out.println("Error: " + e.getMessage());
}
}
}
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
client := &http.Client{}
req, err := http.NewRequest("GET", "https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1", nil)
if err != nil {
fmt.Println("Error creating request:", err)
return
}
req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error making request:", err)
return
}
defer resp.Body.Close()
body, err := ioutil.ReadAll(resp.Body)
if err != nil {
fmt.Println("Error reading response:", err)
return
}
fmt.Println(string(body))
}
#!/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"
using System;
using System.Net.Http;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
using var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY_HERE");
try
{
var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, "https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1"));
var content = await response.Content.ReadAsStringAsync();
Console.WriteLine(content);
}
catch (Exception ex)
{
Console.WriteLine($"Error: {ex.Message}");
}
}
}
import axios from 'axios';
async function run(): Promise<void> {
try {
const response = await axios({
method: 'GET',
url: 'https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1',
headers: {
'x-api-key': 'YOUR_API_KEY_HERE',
},
});
console.log(response.data);
} catch (error) {
console.error('Error:', error);
}
}
void run();
use reqwest::Client;
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
let client = Client::new();
let response = client
.get("https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1")
.header("x-api-key", "YOUR_API_KEY_HERE")
.send()
.await?;
println!("{}", response.text().await?);
Ok(())
}
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
success
data
message
meta
{
"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
}
}
Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Related Endpoints
Find Vinted item IDs by keyword, category, brand, size, country, or price range before enriching listings
Add shipping options and delivery costs to a Vinted item detail record
Compare an item against nearby listings for pricing, recommendation, and resale analytics workflows
Enrich item data with seller ratings, profile context, and marketplace activity signals
Vinted API FAQ
Answers for developers comparing official Vinted API documentation, listing enrichment workflows, and item details access.
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.