Skip to content
Scrappa Get API key

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

Vinted API Item Details 1 credit/request

Endpoint

GET https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1
Request preview GET
https://scrappa.co/api/vinted/item-details?item_id=1234567890&country=DE&include_member_items=1
Auth header x-api-key
Cost 1 credit/request
item_id = 1234567890
Response preview 200 OK
{
    "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.

item_id string Required

The Vinted item ID

Example value 1234567890
country string Optional

Country code for Vinted domain. Defaults to FR.

Example value DE
include_member_items 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.

Example value 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
JSON Response
200 OK
{
    "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

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.

Try It Live

Test this endpoint in our interactive playground with real data.