logo
languageENdown
menu

Vinted Listing Details Scraper

Provide Vinted listing-page URLs and receive item, seller, price, condition, shipping, and image details.

Overview

Turn a set of Vinted listing pages into a structured view of the items they contain. Each returned row combines the listing title and price with condition, brand, size, material, color, shipping details, seller information, and up to three item photos.

This makes public marketplace listings easier to compare at scale. Instead of copying values from individual cards and item pages, analysts can work from one consistent table that keeps product attributes, seller signals, and visual references together.

Data notes

The data comes from publicly visible Vinted listings reached through the supplied listing-page URLs. Text values remain in the language and display format shown by the source marketplace. Price fields are returned as display text, so their currency symbols, decimal separators, and any buyer-protection wording should be retained when comparing records. “Listed time” is a relative label such as “Il y a 5 jours,” not a fixed timestamp. Optional attributes such as size, material, seller location, protected price, or additional photos can be empty when a listing does not display them. Private, removed, expired, or login-restricted content is not covered.

What results look like

Each record represents one Vinted item found through a supplied listing page:

Listing titleListed priceConditionBrandSeller nameSeller rating
Lunettes steampunk avec ailes | Vinted9,00€Très bon étatInconnumaddyneko5.0
Steampunk Sunglasses | Vinted9,18€Très bon étatSTEAMPUNKEndra Model5.0

Other available columns include “Color,” “Material,” “Shipping price,” “Seller review count,” “Buyer protection,” and three photo URLs.

Use cases

  • For price benchmarking, compare “Listed price,” “Condition,” and “Brand” to see how similar secondhand items are positioned.
  • For assortment research, group “Listing title,” “Color,” “Material,” and “Size” to understand which product attributes appear across a result set.
  • For seller screening, use “Seller name,” “Seller rating,” and “Seller review count” to identify established sellers and records that may need further review.
  • For visual catalog work, pair “Listing title” with “Primary photo URL,” “Second photo URL,” and “Third photo URL” to build a reference set for manual review or merchandising analysis.

Scope & Boundaries

Accepts 1 to 10,000 Vinted listing-page URLs per run and returns publicly visible listing details; fields absent from a source listing can be empty.

  • Good for
  • When you need structured item and seller details from one or more Vinted listing pages
  • When you need comparable price, condition, brand, shipping, and image data for marketplace research
  • Do not use for
  • When you only have product keywords and no Vinted listing-page URL
  • When you need private account data, transaction history, or information that is not visible on public listings

Failure Handling

Failure and retry behavior declared by the author. We recommend including it in your system prompt when integrating.

  1. 1If a run returns no records, verify that each URL still opens a public Vinted listing page and remove unavailable or malformed URLs before retrying
  2. 2Transient collection failures can be retried with the same URLs; repeated failures for a specific listing usually mean the page is unavailable or no longer public

Input

Parameters required to call this app, generated from the input.schema in manifest.json.

FieldBusiness nameTypeRequiredDefaultEnum / ConstraintsExampleDescription
listing_page_urlsVinted listing page URLsarray<string>Yesup to 10000 items["https://www.vinted.fr/catalog?search_text=steampunk%20lunettes%20de%20soleil&time=1754616374"]Full Vinted listing-page URLs to collect. Enter 1 to 10,000 URLs, one URL per item; each value can contain up to 1,000 characters.

Output

Field structure of a single record, generated from the output.schema in manifest.json.

FieldBusiness nameTypeExampleDescription
addressSeller locationstringSeller location text displayed with the listing when available.
listed_agoListed timestringIl y a 5 joursRelative time text showing when the item was added.
colorColorstringNoir, DoréColor or colors shown for the item.
shipping_costShipping pricestringà partir de 1,95€Shipping price text displayed on the listing, including its currency symbol when shown.
brandBrandstringInconnuBrand displayed for the item.
materialMaterialstringMaterial information displayed for the item.
photo_1Primary photo URLstringhttps://images1.vinted.net/t/06_00438_RrWe7MJZ9KuTorjXm9QNbu4U/f800/1788458283.webp?s=76f4541d5477c0c51a34972f769b5c6466a4adcfAddress of the first item photo; used as the record identifier because the source output has no listing ID or item URL field.
photo_2Second photo URLstringhttps://images1.vinted.net/t/02_00d6b_npYwSaLMeHHmgHABoBZdh6A5/f800/1788458283.webp?s=f7c8645a5a120bda002fd8641fc0e69207dc0980Address of the second item photo when available.
photo_3Third photo URLstringhttps://images1.vinted.net/t/06_01c27_hKGfAszecE1ZxrxCmbDgXSWE/f800/1788458283.webp?s=7e425ab8ae884c8add9c1fdc0979e3757eca6129Address of the third item photo when available.
listed_priceListed pricestring9,00€Item price text displayed on the listing, including its currency symbol.
buyer_protection_priceProtected pricestringPrice text that includes buyer-protection costs when the source displays it.
buyer_protectionBuyer protectionstringInclut la Protection acheteursBuyer-protection message displayed with the listing.
seller_ratingSeller ratingstring5.0Seller rating text displayed on the listing.
sizeSizestringItem size displayed on the listing when available.
titleListing titlestringLunettes steampunk avec ailes | VintedTitle displayed for the Vinted listing.
seller_nameSeller namestringmaddynekoSeller display name associated with the listing.
conditionConditionstringTrès bon étatItem condition text displayed on the listing.
seller_review_countSeller review countstring78Number of seller evaluations as displayed by Vinted.

Record Schema

Output is returned record by record. detail.output.idFieldHint

output.schema
{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "title": "Seller location",
      "description": "Seller location text displayed with the listing when available.",
      "prefill": ""
    },
    "listed_ago": {
      "type": "string",
      "title": "Listed time",
      "description": "Relative time text showing when the item was added.",
      "prefill": "Il y a 5 jours"
    },
    "color": {
      "type": "string",
      "title": "Color",
      "description": "Color or colors shown for the item.",
      "prefill": "Noir, Doré"
    },
    "shipping_cost": {
      "type": "string",
      "title": "Shipping price",
      "description": "Shipping price text displayed on the listing, including its currency symbol when shown.",
      "prefill": "à partir de 1,95€"
    },
    "brand": {
      "type": "string",
      "title": "Brand",
      "description": "Brand displayed for the item.",
      "prefill": "Inconnu"
    },
    "material": {
      "type": "string",
      "title": "Material",
      "description": "Material information displayed for the item.",
      "prefill": ""
    },
    "photo_1": {
      "type": "string",
      "title": "Primary photo URL",
      "description": "Address of the first item photo; used as the record identifier because the source output has no listing ID or item URL field.",
      "prefill": "https://images1.vinted.net/t/06_00438_RrWe7MJZ9KuTorjXm9QNbu4U/f800/1788458283.webp?s=76f4541d5477c0c51a34972f769b5c6466a4adcf"
    },
    "photo_2": {
      "type": "string",
      "title": "Second photo URL",
      "description": "Address of the second item photo when available.",
      "prefill": "https://images1.vinted.net/t/02_00d6b_npYwSaLMeHHmgHABoBZdh6A5/f800/1788458283.webp?s=f7c8645a5a120bda002fd8641fc0e69207dc0980"
    },
    "photo_3": {
      "type": "string",
      "title": "Third photo URL",
      "description": "Address of the third item photo when available.",
      "prefill": "https://images1.vinted.net/t/06_01c27_hKGfAszecE1ZxrxCmbDgXSWE/f800/1788458283.webp?s=7e425ab8ae884c8add9c1fdc0979e3757eca6129"
    },
    "listed_price": {
      "type": "string",
      "title": "Listed price",
      "description": "Item price text displayed on the listing, including its currency symbol.",
      "prefill": "9,00€"
    },
    "buyer_protection_price": {
      "type": "string",
      "title": "Protected price",
      "description": "Price text that includes buyer-protection costs when the source displays it.",
      "prefill": ""
    },
    "buyer_protection": {
      "type": "string",
      "title": "Buyer protection",
      "description": "Buyer-protection message displayed with the listing.",
      "prefill": "Inclut la Protection acheteurs"
    },
    "seller_rating": {
      "type": "string",
      "title": "Seller rating",
      "description": "Seller rating text displayed on the listing.",
      "prefill": "5.0"
    },
    "size": {
      "type": "string",
      "title": "Size",
      "description": "Item size displayed on the listing when available.",
      "prefill": ""
    },
    "title": {
      "type": "string",
      "title": "Listing title",
      "description": "Title displayed for the Vinted listing.",
      "prefill": "Lunettes steampunk avec ailes | Vinted"
    },
    "seller_name": {
      "type": "string",
      "title": "Seller name",
      "description": "Seller display name associated with the listing.",
      "prefill": "maddyneko"
    },
    "condition": {
      "type": "string",
      "title": "Condition",
      "description": "Item condition text displayed on the listing.",
      "prefill": "Très bon état"
    },
    "seller_review_count": {
      "type": "string",
      "title": "Seller review count",
      "description": "Number of seller evaluations as displayed by Vinted.",
      "prefill": "78"
    }
  },
  "required": [],
  "additionalProperties": false
}

Integration

This app can be integrated via MCP, API, SDK, or file export — all channels share the same capabilities and pricing. Every request authenticates with the Authorization: Bearer header using an API Key (long-lived, created in the Open Platform console); MCP clients can also sign in with OAuth, no key required. More options such as CLI and Skill are on the way.

With the MCP (Model Context Protocol), you can call this app directly from AI clients like Claude and Cursor. Pick your client and auth mode, then copy the config below.

Client config

Replace the value after Bearer with your long-lived API Key. Works in any client, CI, or headless environment.

mcpServers config
{
  "mcpServers": {
    "YiJacobJohnRaku__vinted-data-scraper-by-url": {
      "type": "http",
      "url": "https://mcp-v2.octoparse.com?pin=YiJacobJohnRaku/vinted-data-scraper-by-url",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

Let AI set it up for you

Don't want to edit configs by hand? Copy the install prompt and paste it into any AI client — it will complete the setup its own way. (The prompt asks the AI to request your API Key from you, so credentials never end up in chat history or shared configs.)

detail.access.mcp.composeHint

Pricing

Returned listing

Charged by the number of records successfully returned. Failed tasks are not charged.

$0.0008/ record

Multiple billing events accumulate independently — see each item for details. Failed tasks are not charged.

Try It Now

Fill in the parameters and run — results come from a real call.

Example
Parameters are validated against input.schema before submission
Please fill in the required parameters first
$0.0008 / record