Get a Vinted item

Try in Playground

Read item photos, descriptions, category-specific attributes including book ISBN and language, seller badges, availability and separate item, buyer-protection and shipping prices.

GET/v1/vinted/itemx-api-key

Headers

Get your API key

x-api-keystringrequiredheader

Your ScrapeAtlas customer key. Create one on /account/ and set SCRAPEATLAS_API_KEY.

Query parameters

idstringquery

Numeric item id. Exactly one of id or url.

Example10030317012

urlstringquery

Public item URL https://www.vinted.<domain>/items/{id}-{slug}; the host selects the marketplace and a stale slug is fine.

min 1 chars · max 2048 chars

domainenumquery

Marketplace domain suffix the data was read from (com, fr, de, co.uk, …).

one of: com, at, be, com.au, cz, de, dk, ee, es, fi, fr, gr, hr, hu, ie, it, lt, lu, lv, nl, pl, pt, ro, se, si, sk, co.uk

Examplefr

Response fields

142

requestIdstring

Random operational correlation ID.

Upstream requests (the anonymous token HEAD counts as one), response bytes and elapsed milliseconds.

accounting.upstreamRequestsinteger

Always included.

≥ 0

accounting.responseBytesinteger

Always included.

≥ 0

accounting.durationMsnumber

Always included.

≥ 0

successboolean

True when usable public data was retrieved.

statusenum

success, partial, failed or challenged. Inspect coverage even for HTTP 200.

one of: success, partial

sourceUrlstring

Public www.vinted.<domain> URL the data belongs to.

absolute HTTPS URL

fetchedAtstring

UTC retrieval timestamp.

Complete means this bounded read had no known omissions; warnings name each omission.

coverage.sourceenum

Always public_page for this endpoint.

one of: public_api, public_page

coverage.completeboolean

False when any warning is present.

coverage.warningsstring[]

Machine-readable coverage information for this response.

domainenum

Marketplace domain suffix the data was read from (com, fr, de, co.uk, …).

one of: com, at, be, com.au, cz, de, dk, ee, es, fi, fr, gr, hr, hu, ie, it, lt, lu, lv, nl, pl, pt, ro, se, si, sk, co.uk

The listing.

item.idstring

Item id.

item.urlstring

Canonical item URL.

absolute HTTPS URL

item.titlestringnullable

Title.

item.descriptionstringnullable

Seller's description.

Asking price in major units with ISO currency.

item.price.amountnumbernullable

Always included.

item.price.currencystringnullable

Always included.

Item price plus buyer protection.

item.totalPrice.amountnumbernullable

Always included.

item.totalPrice.currencystringnullable

Always included.

Buyer-protection fee.

item.buyerProtectionFee.amountnumbernullable

Always included.

item.buyerProtectionFee.currencystringnullable

Always included.

Original asking prices and item-service price components.

Original asking amount in the selected marketplace currency.

item.pricing.originalAskingPrice.amountnumbernullable

Always included.

item.pricing.originalAskingPrice.currencystringnullable

Always included.

Original seller asking amount and currency.

item.pricing.sellerOriginalAskingPrice.amountnumbernullable

Always included.

item.pricing.sellerOriginalAskingPrice.currencystringnullable

Always included.

Buyer-protection price component.

Original amount and currency.

item.pricing.buyerProtection.originalPrice.amountnumbernullable

Always included.

item.pricing.buyerProtection.originalPrice.currencystringnullable

Always included.

Final quoted amount and currency.

item.pricing.buyerProtection.finalPrice.amountnumbernullable

Always included.

item.pricing.buyerProtection.finalPrice.currencystringnullable

Always included.

Discount amount and currency.

item.pricing.buyerProtection.discount.amountnumbernullable

Always included.

item.pricing.buyerProtection.discount.currencystringnullable

Always included.

item.pricing.buyerProtection.discountPercentagenumbernullable

Source discount percentage.

item.pricing.buyerProtection.maxDiscountPercentagenumbernullable

Maximum source discount percentage.

item.pricing.buyerProtection.isFreebooleannullable

Free-service flag.

item.pricing.buyerProtection.deliveryTypestringnullable

Source delivery type.

item.pricing.buyerProtection.hasMultipleOptionsbooleannullable

Multiple-shipping-options flag.

item.pricing.buyerProtection.discountStartAtstringnullable

Discount start time in UTC.

item.pricing.buyerProtection.discountEndAtstringnullable

Discount end time in UTC.

Source service-price reference amount over 30 days.

item.pricing.buyerProtection.lowestPrice30Days.amountnumbernullable

Always included.

item.pricing.buyerProtection.lowestPrice30Days.currencystringnullable

Always included.

Shipping price component.

Original amount and currency.

item.pricing.shipping.originalPrice.amountnumbernullable

Always included.

item.pricing.shipping.originalPrice.currencystringnullable

Always included.

Final quoted amount and currency.

item.pricing.shipping.finalPrice.amountnumbernullable

Always included.

item.pricing.shipping.finalPrice.currencystringnullable

Always included.

Discount amount and currency.

item.pricing.shipping.discount.amountnumbernullable

Always included.

item.pricing.shipping.discount.currencystringnullable

Always included.

item.pricing.shipping.discountPercentagenumbernullable

Source discount percentage.

item.pricing.shipping.maxDiscountPercentagenumbernullable

Maximum source discount percentage.

item.pricing.shipping.isFreebooleannullable

Free-service flag.

item.pricing.shipping.deliveryTypestringnullable

Source delivery type.

item.pricing.shipping.hasMultipleOptionsbooleannullable

Multiple-shipping-options flag.

item.pricing.shipping.discountStartAtstringnullable

Discount start time in UTC.

item.pricing.shipping.discountEndAtstringnullable

Discount end time in UTC.

Source service-price reference amount over 30 days.

item.pricing.shipping.lowestPrice30Days.amountnumbernullable

Always included.

item.pricing.shipping.lowestPrice30Days.currencystringnullable

Always included.

Cheapest shipping price with free, pickup-only and multiple-option flags, or null when the page has no shipping block.

Always included.

item.shipping.price.amountnumbernullable

Always included.

item.shipping.price.currencystringnullable

Always included.

item.shipping.isFreebooleannullable

Always included.

item.shipping.isPickupOnlybooleannullable

Always included.

item.shipping.hasMultipleOptionsbooleannullable

Always included.

item.availabilitystringnullable

schema.org availability from the page's structured data (InStock, …).

item.conditionstringnullable

schema.org item condition (NewCondition, UsedCondition, …).

Brand id, title and brand page URL.

item.brand.idstringnullable

Always included.

item.brand.titlestringnullable

Always included.

item.brand.urlstringnullable

Always included.

Size id and label.

item.size.idstringnullable

Always included.

item.size.titlestringnullable

Always included.

Condition id and label in the marketplace language.

item.status.idstringnullable

Always included.

item.status.titlestringnullable

Always included.

item.materialstringnullable

Material label.

item.colorstringnullable

Colour label(s).

item.uploadedTextstringnullable

Relative upload time as displayed (the page has no timestamp).

Category-specific item attributes in source order.

up to 40 items

item.attributes.codestring

Source attribute code.

item.attributes.titlestringnullable

Display label.

item.attributes.valuestringnullable

Display value.

item.attributes.idstringnullable

Source attribute ID.

item.attributes.urlstringnullable

Related Vinted URL.

item.isbnstringnullable

Book ISBN.

item.bookTitlestringnullable

Book title attribute.

item.languagestringnullable

Book language attribute.

item.categoryPathstringnullable

Category path text from the structured data.

item.catalogIdstringnullable

Leaf category id.

Category breadcrumb titles and URLs.

up to 20 items

item.breadcrumbs.titlestringnullable

Always included.

item.breadcrumbs.urlstringnullable

Always included.

Photos with thumbnails, up to 20.

up to 20 items

item.photos.idstringnullable

Always included.

item.photos.urlstringnullable

Always included.

item.photos.fullSizeUrlstringnullable

Always included.

item.photos.widthintegernullable

Always included.

item.photos.heightintegernullable

Always included.

item.photos.dominantColorstringnullable

Always included.

item.photos.isMainbooleannullable

Always included.

up to 20 items

item.photos.thumbnails.typestringnullable

Always included.

item.photos.thumbnails.urlstringnullable

Always included.

item.photos.thumbnails.widthintegernullable

Always included.

item.photos.thumbnails.heightintegernullable

Always included.

item.favouriteCountintegernullable

Favourites.

item.isReservedbooleannullable

Reserved for a buyer.

item.isHiddenbooleannullable

Hidden by the seller.

item.canBuybooleannullable

Whether a buyer could purchase now.

item.instantBuybooleannullable

Whether instant purchase is offered.

item.closetCountdownEndDatestringnullable

End of a closet countdown promotion, ISO 8601 UTC, or null.

Seller id, login, profile URL, business flag, feedback count and reputation, badges, avatar and the displayed last-seen text.

item.seller.idstringnullable

Always included.

item.seller.loginstringnullable

Always included.

item.seller.urlstringnullable

Always included.

item.seller.businessbooleannullable

Always included.

item.seller.feedbackCountintegernullable

Always included.

item.seller.feedbackReputationnumbernullable

Always included.

item.seller.badgesstring[]

Seller badge labels and codes.

up to 20 items

Always included.

item.seller.photo.idstringnullable

Always included.

item.seller.photo.urlstringnullable

Always included.

item.seller.lastSeenTextstringnullable

Always included.

HTTP 200 returns the success variant. Check status: partial means usable data with warnings, and failed or challenged requests carry a failure object described in Errors & responses.

Error codes

HTTP	failure.code	Meaning
400	`invalid_request`	Missing, duplicate, unsupported or invalid parameters, more than one selector, a domain that does not match the URL host, or a page beyond what the source accepts.
401	`unauthorized`	Missing or invalid service key.
404	`not_found`	Unknown item or member.
429	`upstream_rate_limited`	Vinted rate limited the request; no automatic retry.
502	`upstream_challenged`	DataDome/Cloudflare challenge, HTTP 401/403/503, or no anonymous token issued.
502	`unsupported_page` `unsafe_redirect` `response_too_large` `request_limit` `upstream_error`	Bounded retrieval failed, the page belongs to another item, or the response no longer matches the expected structure.
503	`busy`	All worker slots occupied.
504	`timeout`	Deadline exceeded.
200	`partial`	Coverage warnings such as pricing_missing, photos_missing or pagination_missing.

Code example

curl "https://api.scrapeatlas.com/v1/vinted/item?id=10030317012&domain=fr" \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  "https://api.scrapeatlas.com/v1/vinted/item?id=10030317012&domain=fr",
  {
    headers: {
      "x-api-key": "YOUR_API_KEY"
    }
  }
);

const data = await response.json();
console.log(data.status, data);

type Result = {
  status: "success" | "partial" | "failed" | "challenged";
  requestId: string;
  [field: string]: unknown;
};

const response = await fetch(
  "https://api.scrapeatlas.com/v1/vinted/item?id=10030317012&domain=fr",
  {
    headers: {
      "x-api-key": process.env.SCRAPEATLAS_API_KEY!
    }
  }
);

const data = (await response.json()) as Result;
if (data.status === "failed" || data.status === "challenged") {
  throw new Error(`Vinted request failed: ${data.requestId}`);
}
console.log(data);

import requests

response = requests.get(
    "https://api.scrapeatlas.com/v1/vinted/item",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={
        "id": "10030317012",
        "domain": "fr"
    },
    timeout=60,
)
data = response.json()
print(data["status"], data)

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://api.scrapeatlas.com/v1/vinted/item?id=10030317012&domain=fr", nil)
	req.Header.Set("x-api-key", "YOUR_API_KEY")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
	fmt.Println(data["status"], data)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        var client = HttpClient.newHttpClient();
        var request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.scrapeatlas.com/v1/vinted/item?id=10030317012&domain=fr"))
            .GET()
            .header("x-api-key", "YOUR_API_KEY")
            .build();
        var response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

Use your sa_live_… customer key at https://api.scrapeatlas.com.

Responses

Successful result. Synthetic example validated against the runtime contract.

{
  "success": true,
  "status": "success",
  "requestId": "00000000-0000-4000-8000-000000000001",
  "domain": "fr",
  "item": {
    "id": "9964011846",
    "url": "https://www.vinted.fr/items/9964011846-nike-zoom-vomero",
    "title": "Nike Zoom Vomero",
    "description": "New, never worn.",
    "price": {
      "amount": 100,
      "currency": "EUR"
    },
    "totalPrice": {
      "amount": 105.7,
      "currency": "EUR"
    },
    "buyerProtectionFee": {
      "amount": 5.7,
      "currency": "EUR"
    },
    "shipping": {
      "price": {
        "amount": 2.88,
        "currency": "EUR"
      },
      "isFree": false,
      "isPickupOnly": false,
      "hasMultipleOptions": true
    },
    "availability": "InStock",
    "condition": "NewCondition",
    "brand": {
      "id": "53",
      "title": "Nike",
      "url": "https://www.vinted.fr/brand/53-nike"
    },
    "size": {
      "id": "510",
      "title": "39"
    },
    "status": {
      "id": "50",
      "title": "New with tags"
    },
    "material": "Foam",
    "color": "Black, Silver",
    "uploadedText": "1 minute ago",
    "categoryPath": "Women Trainers",
    "catalogId": "2632",
    "breadcrumbs": [
      {
        "title": "Women",
        "url": "https://www.vinted.fr/catalog/1904-women"
      },
      {
        "title": "Trainers",
        "url": "https://www.vinted.fr/catalog/2632-trainers"
      }
    ],
    "photos": [
      {
        "id": "02_example",
        "url": "https://images1.vinted.net/t/02_example/f800/1789135019.jpeg?s=e22813139f",
        "fullSizeUrl": null,
        "width": 1200,
        "height": 1600,
        "dominantColor": "#444141",
        "isMain": true,
        "thumbnails": [
          {
            "type": "thumb150x210",
            "url": "https://images1.vinted.net/t/02_example/150x210/1789135019.jpeg?s=a26d73f0",
            "width": 150,
            "height": 210
          }
        ]
      }
    ],
    "favouriteCount": 0,
    "isReserved": false,
    "isHidden": false,
    "canBuy": true,
    "instantBuy": true,
    "closetCountdownEndDate": null,
    "seller": {
      "id": "316651900",
      "login": "example_member",
      "url": "https://www.vinted.fr/member/316651900",
      "business": false,
      "feedbackCount": 26,
      "feedbackReputation": 0.76,
      "badges": [],
      "photo": {
        "id": "01_example",
        "url": "https://images1.vinted.net/t/01_example/f800/57257f63.webp?s=618d2610"
      },
      "lastSeenText": "Last seen: 1 hour ago"
    },
    "isbn": null,
    "bookTitle": null,
    "language": null,
    "attributes": [
      {
        "code": "brand",
        "title": "Brand",
        "value": "Nike",
        "id": "53",
        "url": "https://www.vinted.fr/brand/53-nike"
      },
      {
        "code": "size",
        "title": "Size",
        "value": "39",
        "id": "510",
        "url": null
      },
      {
        "code": "status",
        "title": "Condition",
        "value": "New with tags",
        "id": "50",
        "url": null
      },
      {
        "code": "color",
        "title": "Colour",
        "value": "Black, Silver",
        "id": null,
        "url": null
      }
    ],
    "pricing": {
      "originalAskingPrice": {
        "amount": 100,
        "currency": "EUR"
      },
      "sellerOriginalAskingPrice": {
        "amount": 100,
        "currency": "EUR"
      },
      "buyerProtection": {
        "originalPrice": {
          "amount": 5.7,
          "currency": "EUR"
        },
        "finalPrice": {
          "amount": 5.7,
          "currency": "EUR"
        },
        "discount": null,
        "discountPercentage": null,
        "maxDiscountPercentage": null,
        "isFree": false,
        "deliveryType": null,
        "hasMultipleOptions": null,
        "discountStartAt": null,
        "discountEndAt": null,
        "lowestPrice30Days": null
      },
      "shipping": {
        "originalPrice": {
          "amount": 2.88,
          "currency": "EUR"
        },
        "finalPrice": {
          "amount": 2.88,
          "currency": "EUR"
        },
        "discount": null,
        "discountPercentage": null,
        "maxDiscountPercentage": null,
        "isFree": false,
        "deliveryType": null,
        "hasMultipleOptions": null,
        "discountStartAt": null,
        "discountEndAt": null,
        "lowestPrice30Days": null
      }
    }
  },
  "sourceUrl": "https://www.vinted.fr/items/9964011846-nike-zoom-vomero",
  "fetchedAt": "2026-09-11T00:00:00.000Z",
  "coverage": {
    "source": "public_page",
    "complete": true,
    "warnings": []
  },
  "accounting": {
    "upstreamRequests": 2,
    "responseBytes": 2126581,
    "durationMs": 900
  }
}

Missing, duplicate, unsupported or invalid parameters, more than one selector, a domain that does not match the URL host, or a page beyond what the source accepts.

{
  "requestId": "9d2f1c0a-6b1e-4c7d-9a8e-2f3b4c5d6e7f",
  "accounting": {
    "upstreamRequests": 0,
    "responseBytes": 0,
    "durationMs": 0
  },
  "success": false,
  "status": "failed",
  "failure": {
    "code": "invalid_request",
    "message": "Invalid request: missing, duplicate, unsupported or malformed parameters."
  }
}