Use Vinted Secondhand Listings, Closets & Seller Feedback with Python

Search Vinted secondhand fashion listings by keyword, brand, size, color, material and price across 19 storefronts, or pull a seller's closet, a brand's catalog, or a seller's feedback history.

1. Choose the data you need

Review the published README for supported collection modes, examples, and limits. The recipe below uses the current published input definition.

2. Prepare a source-based input

This JSON contains published prefills and required-field defaults. Review every value for your task before running it; it is not a promise of successful collection.

{
  "brandIds": [],
  "catalogIds": [],
  "color": "any",
  "condition": "any",
  "country": "com",
  "deepSearch": false,
  "feedbackType": "all",
  "includeItemDetails": false,
  "includeSellerStats": false,
  "materialIds": [],
  "maxItems": 1,
  "mode": "search",
  "order": "relevance",
  "searchText": "adidas",
  "sizeIds": [],
  "urls": []
}

Download input.example.json and save your reviewed copy as input.json.

Field	Type	Required	Description
`mode`	string	required	search: keyword/filters → items. byUrl: explicit Vinted item, member, brand, catalog or search URLs. byUser: profile + closet. byBrand / byCatalog: listings for a brand or category. byBrandSearch: brand registry. byUserFeedbacks: seller reviews.
`country`	string	required	Vinted market to query. The market controls currency, language and local inventory.
`searchText`	string	optional	Free-text keyword. Leave empty with a brand/category filter to browse. A bare run defaults to adidas.
`order`	string	optional	Result ordering for item searches.
`urls`	array	optional	Item, member, brand, catalog or filtered search URLs. Mixed country domains are supported.
`userId`	string	optional	Numeric Vinted user ID, username, or member URL.
`brandId`	string	optional	Numeric brand ID or brand URL. Discover IDs with Search brand registry.
`catalogId`	string	optional	Numeric category ID or /catalog/<id>-slug URL.
`brandKeyword`	string	optional	Keyword to search the Vinted brand registry.
`brandIds`	array	optional	Numeric brand IDs, e.g. [53] for Nike.
`catalogIds`	array	optional	Numeric category IDs, e.g. [1904] for Women.
`sizeIds`	array	optional	Numeric Vinted size IDs. Use the size facet shown on a Vinted search URL.
`color`	string	optional	Single colour filter. Choose any to leave it unfiltered.
`materialIds`	array	optional	Numeric material IDs from Vinted's Material facet (e.g. 44 = Cotton).
`condition`	string	optional	Vinted condition. Choose any to leave it unfiltered.
`priceFrom`	integer	optional	Minimum price in the market's local currency.
`priceTo`	integer	optional	Maximum price in the market's local currency.
`deepSearch`	boolean	optional	Vinted returns at most 960 results per query. Deep search splits the query into price bands so it can collect more (more requests, slower).
`includeItemDetails`	boolean	optional	Open each item page for description, colour, material, category, condition ID, upload age, all photos and seller rating. One extra request per item.
`includeSellerStats`	boolean	optional	Add seller rating, feedback count, item/sold counts, followers and shop identity (one profile request per distinct seller).
`minRating`	number	optional	Drop items whose seller rating is below this value (0–5). Items without a rating pass through. Automatically enables seller stats.
`containsKeyword`	string	optional	Drop items whose title or description does not contain this keyword (case-insensitive). Without item details only the title is searched.
`maxItems`	integer	optional	Hard cap on emitted records. Values above 960 need deep search.
`feedbackType`	string	optional	All reviews, member-written reviews, or Vinted's automatic sale-completion entries.

3. Start an Actor run

Set APIFY_TOKEN in your environment. Python 3.10 or newer is sufficient; this recipe uses no third-party packages.

Execution may incur charges. Review current pricing on Apify. The request asks for a 120-second timeout and a charge limit; these settings are subject to Apify’s pricing and do not guarantee an all-inclusive spending cap.

import json
import os
import urllib.request

# Save the schema-derived example as input.json; review and edit it first.
with open("input.json", encoding="utf-8") as stream:
    actor_input = json.load(stream)

token = os.environ["APIFY_TOKEN"]
request = urllib.request.Request(
    "https://api.apify.com/v2/acts/MXkFfooETidynP1xR/runs?timeout=120&maxTotalChargeUsd=0.50",
    data=json.dumps(actor_input).encode("utf-8"),
    headers={"Authorization": "Bearer " + token, "Content-Type": "application/json"},
    method="POST",
)
# This starts a potentially billable run. Do not automatically retry this POST.
with urllib.request.urlopen(request, timeout=40) as response:
    run = json.load(response)["data"]
print("Run ID:", run["id"])
print("Status:", run["status"])
# Inspect and download results in Apify Console once the run succeeds.

4. Inspect the actual results

Open the run in Apify Console and wait for a successful completion. Use the published output schema to locate results and the dataset schema to understand declared views. Missing or optional record fields must not be treated as guaranteed values.

One record per Vinted item, seller profile, brand or feedback entry across 27 markets, with prices, condition, images, seller rating, shop data and source URLs.

Questions before you run

Which inputs are required?

The published required fields are mode, country

What does this guide verify?

The fields, prefills, and schema links are rendered from the published build. This is a usage recipe, not a paid live extraction test. Source availability and collection results can vary.

What if the run request times out?

Check Apify Console before retrying. The first request may already have created a run. Do not automatically repeat a run-creation POST.

Open on Apify Full Actor reference

Generated from source build mBEPDeegiIM7YP28R and its README and schemas. Source changes regenerate this guide; no third-party editorial claims are inferred.