Vinted mobile data

The Vinted API now uses mobile JSON requests for search, item details, seller profiles, wardrobes, brands, colors and conditions. You do not need a Vinted account. The existing endpoints keep their response envelopes and pricing. For the wider data set, use 76 public read operations. These include sold comparables, suggested prices, reviews, followers, related listings, category trees, homepage feeds, ISBN metadata, package sizes, and help articles.

Discover operations

curl 'https://scrapebadger.com/v1/vinted/mobile/operations' \
  -H 'X-API-Key: YOUR_API_KEY'

Discovery is free. Each entry includes its name, parameter types, required fields, example request parameters and expected response keys. The first data field is the primary result; additional configuration fields can vary by region. The playground loads this same catalog and provides a form for each operation.

Read data

All operation calls use POST /v1/vinted/mobile/{operation} with a JSON body:

{
  "market": "fr",
  "parameters": {
    "catalog_id": "1242",
    "brand_id": "53",
    "status_id": "2"
  }
}

For example, retrieve comparable sold listings:

curl 'https://scrapebadger.com/v1/vinted/mobile/sold-comparables' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"market":"fr","parameters":{"catalog_id":"1242","brand_id":"53","status_id":"2"}}'

The response contains operation, market, and the upstream JSON in data. Each successful read costs 1 credit. Failed requests are free. An empty collection can be a valid result; the operation description identifies inputs that returned empty or limited data during validation.

Sold comparables are a sample of similar sold listings, not an exhaustive sales history. Their prices are not guaranteed final negotiated settlement prices. The price-suggestions operation returns Vinted’s suggested price and range.

CLI and MCP

CLI version 0.14.0 or later:

scrapebadger vinted mobile-operations
scrapebadger vinted mobile sold-comparables --market fr \
  --params '{"catalog_id":"1242","brand_id":"53","status_id":"2"}'
scrapebadger vinted mobile user-feedback --market pl \
  --params '{"user_id":94118559,"per_page":3}'

MCP clients use vinted_mobile_operations to discover inputs, then vinted_mobile_read with operation, market, and parameters. Existing Vinted MCP tools remain available.

Search and field changes

/v1/vinted/search also accepts size_ids, material_ids, time, and search_session_id. Reuse the returned pagination time and your search session across pages. Live results can overlap; deduplicate by item ID.
market selects the locale and catalog region. It does not limit listings to sellers physically located in that country. Use the existing seller_country filter on /search when you need that restriction. Core reads use the requested country so prices and region-specific wardrobes match that market.
Search URLs are absolute. display_title and display_subtitle retain Vinted’s presentation labels. brand_title is null when the response does not provide a reliable brand field; a display label can include a model name.
Item details return descriptions, brand/category/condition IDs and photos. Unavailable fields remain null. A size-guide or condition FAQ link ID is not an item attribute ID.
These operations read public data. They do not perform purchases, payments, messages, account changes or listing publication.

Operation catalog

The tables below list every operation. Use discovery for full parameter types, optional fields and runnable examples. Parameters belong inside parameters, including identifiers used to select an item, seller or category.

Discovery

Operation	Required parameters	Result
`catalog-search`	None	`items` (plus estimated listing times), `pagination`, `search_tracking_params`, `uploaded_at_reference`
`filters`	None	`filters`, `selected_filters`
`filter-facets`	`filter_code`	`filter_code`, `options`, `total_count`, `total_count_max`
`filter-search`	`filter_search_code`, `filter_search_text`	`is_selection_highlighted`, `options`, `selected_filters`
`categories`	None	`catalogs`
`suggestions`	`search_text`	`results`
`homepage-configuration`	None	`homepage_session_id`, `staggered_homepage_enabled`, `verticals`
`homepage`	`vertical`, `column_count`, `version`	`blocks`, `load_more_button`, `pagination`
`promoted-closets`	None	`page_info`, `promoted_closets`

Listing age on catalog search

Vinted sends no upload time on search results. catalog-search adds an estimate to every item, at the same 1 credit:

Field	Meaning
`estimated_uploaded_at`	ISO 8601 UTC time the listing went live, or `null` when it cannot be estimated.
`estimated_uploaded_at_source`	`photo_stamp`: the item’s own measured photo stamp, the same value `item-details` returns as `uploaded_at`. `item_id`: an estimate from the item ID.
`estimated_uploaded_at_bracket_seconds`	For `item_id` estimates: the time between the nearest listings with a known time on either side of this ID. This is what predicts the error. `null` for `photo_stamp`.

Vinted’s item IDs are one global sequence across markets, so an ID can be placed between listings whose times we know. Those reference times come from the photo stamps of item-details responses, including a listing we read every few minutes to keep the most recent IDs covered. The error depends on how close those references are:

`bracket_seconds`	Error against the photo stamp, 90% of listings
under 1,800 (30 min)	within 5 minutes
1,800 to 10,800	within about 3 hours
over 10,800	hours to days, so do not rely on it for fine-grained age

About 1% of listings are off by more than a day even with close references. These are drafts published later or relisted items, whose ID is older than the moment they went live. An item older than every reference comes back null. An item newer than every reference is placed between the newest reference and the time of the response. Each response also carries uploaded_at_reference, which tells you how far back the estimates reach:

"uploaded_at_reference": {
  "anchors": 98412,
  "oldest_anchor_at": "2026-09-27T08:14:02Z",
  "newest_anchor_at": "2026-10-07T13:28:28Z"
}

It is null if the reference table is briefly unavailable, in which case every estimate is null too and the search itself still succeeds.

Items

Operation	Required parameters	Result
`item-services`	`item_id`	`original_asking_amount`, `seller_original_asking_amount`, `services`, `total_amount`
`item-details`	`item_id`	`item` (plus `item.uploaded_at`), `plugins`
`item-photos`	`item_id`	`photos`
`public-photos`	`item_ids[]`, `photo_size`	`photos`
`item-translatable`	`item_id`	`plugins`
`related-items`	`item_id`, `content_source`	`items`, `title`, `next_page_token`
`item-shipping`	`item_id`	`shipping_details`
`item-share`	`item_id`	`share_url`

item-details returns Vinted’s payload unchanged except for one field we add: item.uploaded_at, an ISO 8601 UTC timestamp taken from the earliest photo upload. It is approximate in both directions. A seller who replaces a photo after listing moves it later, and a photo uploaded before the listing is published can predate it by about 30 minutes. Related items carry no upload time. related-items takes content_source similar_items or other_user_items. To get the next page, send the previous response’s next_page_token. When it is null there are no more pages.

Sellers

Operation	Required parameters	Result
`user-profile`	`id`	`user`
`user-search`	None	`users`, `pagination`
`user-items`	`user_id`	`items`, `pagination`
`user-followers`	`user_id`	`users`, `pagination`
`user-following`	`user_id`	`users`, `pagination`
`user-categories`	`user_id`	`catalogs`
`user-feedback`	`user_id`	`user_feedbacks`, `pagination`
`user-feedback-summary`	`user_id`	`user_feedback_summary`
`seller-badges`	`sellerID`, `timeZone`	`badges`

Reference

Operation	Required parameters	Result
`brands`	`keyword`	`brands`, `pagination`
`brand-suggestions`	None	`brands`, `pagination`
`size-groups`	`catalog_ids[]`	`size_groups`
`catalog-filters`	None	`filters`, `selected_filters`
`catalog-filter-facets`	`filter_code`	`filter_code`, `total_count`, `total_count_max`
`catalog-filter-search`	`filter_search_code`, `filter_search_text`	`options`, `is_selection_highlighted`, `selected_filters`
`wardrobe-categories`	None	`catalogs`
`seller-filters`	None	`filters`
`upload-categories`	None	`catalogs`
`upload-category-search`	`keyword`	`catalog_ids`
`upload-brands`	`keyword`	`brands`, `disable_custom_brands`
`colors`	None	`colors`
`book-isbn`	`isbn`	`isbn_records`, `attributes`
`book-isbn-validate`	`isbn`	Success acknowledgement
`upload-configuration`	None	`catalog_group_fields`, `max_custom_shipping_price`, `ab_tests`, `upload_session_id`, `currency`, `photo_tip`, `price_range`, `is_first_time_lister`, `category_suggestions_photo_count`, `attribute_suggestions_photo_count`, `suggestions_configuration`, `number_of_images_per_item`, `image_resizing`, `professional_seller_key`, `measurements`, `package_size_defining_item_attribute_codes_abTest`
`upload-models`	`catalog_id`, `brand_id`	`sorting_type`, `models`, `pagination`, `disable_unknown_models`
`upload-model-search`	`catalog_id`, `brand_id`, `search_text`	`models`, `disable_unknown_models`
`authenticity-info`	`catalog_id`	`authenticity_modal`
`photo-tips`	None	`photo_tips`
`upload-banners`	`category_id`	`extra_section_banners`
`countries`	None	`countries`
`country-languages`	`country_id`	`languages`, `primary_language`, `country`
`country-cities`	`country_id`	`cities`
`nationalities`	None	`countries`, `suggested_countries`
`languages`	None	`languages`, `country`
`recommended-locale`	None	`recommended_locale`, `recommended_iso_locale`
`upload-attributes`	`attributes`	`attributes`
`upload-attribute-search`	`code`, `value`	`options`

Shipping

Operation	Required parameters	Result
`category-package-sizes`	`catalog_id`	`package_sizes`, `parcel_measurements`, `xs_package_size_experiment_eligible`, `heavy_small_package_size_experiment_eligible`
`bundle-package-sizes`	`item_ids[]`	`package_sizes`, `parcel_measurements`
`largest-shipping-rates`	None	`shipping_rates`

Help

Operation	Required parameters	Result
`help-tree`	`country`, `language`	`faq_entries`, `faq_entries_parent_code`, `faq_entries_parent_id`, `faq_entries_parent_title`
`help-entry`	`faq_entry_id`, `country`, `language`	`faq_entry`
`help-entry-core`	`faq_entry_id`	`faq_entry`
`help-feedback-options`	`faq_entry_id`	`feedback_uuid`, `feedback_ratings`
`terms`	None	`terms_and_conditions`

Configuration

Operation	Required parameters	Result
`custom-shipment-configuration`	None	`custom_shipment_configuration`
`session-defaults`	None	`session_defaults_configuration`
`system-configuration`	None	`system_configuration`
`features`	None	`features`
`app-version`	None	`app_version`
`ad-configuration`	None	`ads`, `partner_ids`, `reduce_ad_frequency`
`consent-configuration`	None	`language_iso`, `cookie_consent_version`
`ad-configuration-core`	None	`ads`, `reduce_ad_frequency`
`consent-configuration-core`	None	`language_iso`, `cookie_consent_version`
`banners`	None	`banners`
`info-banners`	None	`info_banners`
`catalog-banners`	None	Success acknowledgement

Pricing

Operation	Required parameters	Result
`price-suggestions`	`catalog_id`, `brand_id`, `status_id`	`price_suggestion`, `similar_sold_items_present`
`sold-comparables`	`catalog_id`, `brand_id`, `status_id`	`items`

Python and Node SDKs

Use SDK version 0.46.0 or newer. Python takes a payload keyword; Node takes the JSON body as its second argument.

import asyncio
from scrapebadger import ScrapeBadger

async def main():
    async with ScrapeBadger(api_key="YOUR_API_KEY") as client:
        operations = await client.vinted.list_public_vinted_mobile_operations()
        result = await client.vinted.read_vinted_mobile_data(
            "sold-comparables",
            payload={"market": "fr", "parameters": {"catalog_id": "1242", "brand_id": "53", "status_id": "2"}},
        )
        print(result)

asyncio.run(main())

import { ScrapeBadger } from "scrapebadger";

const client = new ScrapeBadger({ apiKey: "YOUR_API_KEY" });
const operations = await client.vinted.listPublicVintedMobileOperations();
const result = await client.vinted.readVintedMobileData("sold-comparables", {
  market: "fr",
  parameters: { catalog_id: "1242", brand_id: "53", status_id: "2" },
});
console.log(result);

Overview

Mobile data

Search

Items

Sellers

Reference

Discover operations

Read data

CLI and MCP

Search and field changes

Operation catalog

Discovery

Listing age on catalog search

Items

Sellers

Reference

Shipping

Help

Configuration

Pricing

Python and Node SDKs

​Discover operations

​Read data

​CLI and MCP

​Search and field changes

​Operation catalog

​Discovery

​Listing age on catalog search

​Items

​Sellers

​Reference

​Shipping

​Help

​Configuration

​Pricing

​Python and Node SDKs

Discover operations

Read data

CLI and MCP

Search and field changes

Operation catalog

Discovery

Listing age on catalog search

Items

Sellers

Reference

Shipping

Help

Configuration

Pricing

Python and Node SDKs