{ "data": { "id": "mBEPDeegiIM7YP28R", "actId": "MXkFfooETidynP1xR", "userId": "NL4ThgItAwaoBlffQ", "startedAt": "2026-10-25T09:47:39.765Z", "finishedAt": "2026-10-25T09:47:44.757Z", "status": "SUCCEEDED", "meta": { "origin": "CLI" }, "stats": { "durationMillis": 4846, "runTimeSecs": 4.846, "computeUnits": 0.005384444444444444, "imageSizeBytes": 357746688 }, "options": { "useCache": true, "betaPackages": false, "memoryMbytes": 4096, "diskMbytes": 8192 }, "createdByOrganizationMemberUserId": "zifX0mkAFMHe8CatY", "exitCode": 0, "inputSchema": "{\n \"title\": \"Vinted Scraper Input\",\n \"description\": \"Search Vinted second-hand fashion across 27 country domains, pull item details, seller closets, profiles, shop data, feedback, brands and categories.\",\n \"type\": \"object\",\n \"schemaVersion\": 1,\n \"properties\": {\n \"mode\": {\n \"title\": \"Scrape mode\",\n \"type\": \"string\",\n \"description\": \"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.\",\n \"editor\": \"select\",\n \"sectionCaption\": \"Mode & Market\",\n \"enum\": [\n \"search\",\n \"byUrl\",\n \"byUser\",\n \"byBrand\",\n \"byCatalog\",\n \"byBrandSearch\",\n \"byUserFeedbacks\"\n ],\n \"enumTitles\": [\n \"Search items (keyword + filters)\",\n \"By URL (item / member / brand / catalog / search)\",\n \"By user (profile + closet)\",\n \"By brand (items)\",\n \"By catalog (category items)\",\n \"Search brand registry\",\n \"By user feedbacks (seller reviews)\"\n ],\n \"default\": \"search\",\n \"prefill\": \"search\"\n },\n \"country\": {\n \"title\": \"Country / market\",\n \"type\": \"string\",\n \"description\": \"Vinted market to query. The market controls currency, language and local inventory.\",\n \"editor\": \"select\",\n \"sectionCaption\": \"Mode & Market\",\n \"enum\": [\n \"com\",\n \"co.uk\",\n \"fr\",\n \"de\",\n \"it\",\n \"es\",\n \"pl\",\n \"cz\",\n \"nl\",\n \"lt\",\n \"lu\",\n \"at\",\n \"be\",\n \"pt\",\n \"ro\",\n \"sk\",\n \"fi\",\n \"se\",\n \"gr\",\n \"dk\",\n \"ee\",\n \"hr\",\n \"hu\",\n \"ie\",\n \"lv\",\n \"si\",\n \"com.au\"\n ],\n \"enumTitles\": [\n \"United States (vinted.com, USD)\",\n \"United Kingdom (vinted.co.uk, GBP)\",\n \"France (vinted.fr, EUR)\",\n \"Germany (vinted.de, EUR)\",\n \"Italy (vinted.it, EUR)\",\n \"Spain (vinted.es, EUR)\",\n \"Poland (vinted.pl, PLN)\",\n \"Czechia (vinted.cz, CZK)\",\n \"Netherlands (vinted.nl, EUR)\",\n \"Lithuania (vinted.lt, EUR)\",\n \"Luxembourg (vinted.lu, EUR)\",\n \"Austria (vinted.at, EUR)\",\n \"Belgium (vinted.be, EUR)\",\n \"Portugal (vinted.pt, EUR)\",\n \"Romania (vinted.ro, RON)\",\n \"Slovakia (vinted.sk, EUR)\",\n \"Finland (vinted.fi, EUR)\",\n \"Sweden (vinted.se, SEK)\",\n \"Greece (vinted.gr, EUR)\",\n \"Denmark (vinted.dk, DKK)\",\n \"Estonia (vinted.ee, EUR)\",\n \"Croatia (vinted.hr, EUR)\",\n \"Hungary (vinted.hu, HUF)\",\n \"Ireland (vinted.ie, EUR)\",\n \"Latvia (vinted.lv, EUR)\",\n \"Slovenia (vinted.si, EUR)\",\n \"Australia (vinted.com.au, AUD)\"\n ],\n \"default\": \"com\",\n \"prefill\": \"com\"\n },\n \"searchText\": {\n \"title\": \"Search query (mode=search)\",\n \"type\": \"string\",\n \"description\": \"Free-text keyword. Leave empty with a brand/category filter to browse. A bare run defaults to adidas.\",\n \"editor\": \"textfield\",\n \"sectionCaption\": \"Search Inputs\",\n \"default\": \"\",\n \"prefill\": \"adidas\"\n },\n \"order\": {\n \"title\": \"Sort order (mode=search / byBrand / byCatalog)\",\n \"type\": \"string\",\n \"description\": \"Result ordering for item searches.\",\n \"editor\": \"select\",\n \"sectionCaption\": \"Search Inputs\",\n \"enum\": [\n \"relevance\",\n \"newest_first\",\n \"price_low_to_high\",\n \"price_high_to_low\"\n ],\n \"enumTitles\": [\n \"Relevance\",\n \"Newest first\",\n \"Price: low to high\",\n \"Price: high to low\"\n ],\n \"default\": \"relevance\",\n \"prefill\": \"relevance\"\n },\n \"urls\": {\n \"title\": \"Vinted URLs (mode=byUrl)\",\n \"type\": \"array\",\n \"description\": \"Item, member, brand, catalog or filtered search URLs. Mixed country domains are supported.\",\n \"editor\": \"stringList\",\n \"sectionCaption\": \"Per-Mode Targets\",\n \"default\": [],\n \"prefill\": []\n },\n \"userId\": {\n \"title\": \"User ID, username or URL (mode=byUser / byUserFeedbacks)\",\n \"type\": \"string\",\n \"description\": \"Numeric Vinted user ID, username, or member URL.\",\n \"editor\": \"textfield\",\n \"sectionCaption\": \"Per-Mode Targets\"\n },\n \"brandId\": {\n \"title\": \"Brand ID or URL (mode=byBrand)\",\n \"type\": \"string\",\n \"description\": \"Numeric brand ID or brand URL. Discover IDs with Search brand registry.\",\n \"editor\": \"textfield\",\n \"sectionCaption\": \"Per-Mode Targets\"\n },\n \"catalogId\": {\n \"title\": \"Catalog ID or URL (mode=byCatalog)\",\n \"type\": \"string\",\n \"description\": \"Numeric category ID or /catalog/-slug URL.\",\n \"editor\": \"textfield\",\n \"sectionCaption\": \"Per-Mode Targets\"\n },\n \"brandKeyword\": {\n \"title\": \"Brand keyword (mode=byBrandSearch)\",\n \"type\": \"string\",\n \"description\": \"Keyword to search the Vinted brand registry.\",\n \"editor\": \"textfield\",\n \"sectionCaption\": \"Per-Mode Targets\"\n },\n \"brandIds\": {\n \"title\": \"Brand IDs filter (mode=search)\",\n \"type\": \"array\",\n \"description\": \"Numeric brand IDs, e.g. [53] for Nike.\",\n \"editor\": \"stringList\",\n \"sectionCaption\": \"Search Filters\",\n \"default\": [],\n \"prefill\": []\n },\n \"catalogIds\": {\n \"title\": \"Catalog IDs filter (mode=search)\",\n \"type\": \"array\",\n \"description\": \"Numeric category IDs, e.g. [1904] for Women.\",\n \"editor\": \"stringList\",\n \"sectionCaption\": \"Search Filters\",\n \"default\": [],\n \"prefill\": []\n },\n \"sizeIds\": {\n \"title\": \"Size IDs filter (mode=search)\",\n \"type\": \"array\",\n \"description\": \"Numeric Vinted size IDs. Use the size facet shown on a Vinted search URL.\",\n \"editor\": \"stringList\",\n \"sectionCaption\": \"Search Filters\",\n \"default\": [],\n \"prefill\": []\n },\n \"color\": {\n \"title\": \"Color filter (mode=search)\",\n \"type\": \"string\",\n \"description\": \"Single colour filter. Choose any to leave it unfiltered.\",\n \"editor\": \"select\",\n \"sectionCaption\": \"Search Filters\",\n \"enum\": [\n \"any\",\n \"1\",\n \"3\",\n \"12\",\n \"20\",\n \"4\",\n \"21\",\n \"11\",\n \"22\",\n \"7\",\n \"23\",\n \"5\",\n \"24\",\n \"6\",\n \"25\",\n \"26\",\n \"9\",\n \"27\",\n \"17\",\n \"30\",\n \"10\",\n \"28\",\n \"16\",\n \"2\",\n \"29\",\n \"8\",\n \"13\",\n \"14\",\n \"15\",\n \"32\"\n ],\n \"enumTitles\": [\n \"Any color\",\n \"Black\",\n \"Gray\",\n \"White\",\n \"Cream\",\n \"Beige\",\n \"Apricot\",\n \"Orange\",\n \"Coral\",\n \"Red\",\n \"Burgundy\",\n \"Pink\",\n \"Rose\",\n \"Purple\",\n \"Lilac\",\n \"Light blue\",\n \"Blue\",\n \"Navy\",\n \"Turquoise\",\n \"Mint\",\n \"Green\",\n \"Dark green\",\n \"Khaki\",\n \"Brown\",\n \"Mustard\",\n \"Yellow\",\n \"Silver\",\n \"Gold\",\n \"Multi\",\n \"Clear\"\n ],\n \"default\": \"any\",\n \"prefill\": \"any\"\n },\n \"materialIds\": {\n \"title\": \"Material IDs filter (mode=search)\",\n \"type\": \"array\",\n \"description\": \"Numeric material IDs from Vinted's Material facet (e.g. 44 = Cotton).\",\n \"editor\": \"stringList\",\n \"sectionCaption\": \"Search Filters\",\n \"default\": [],\n \"prefill\": []\n },\n \"condition\": {\n \"title\": \"Condition filter (mode=search)\",\n \"type\": \"string\",\n \"description\": \"Vinted condition. Choose any to leave it unfiltered.\",\n \"editor\": \"select\",\n \"sectionCaption\": \"Search Filters\",\n \"enum\": [\n \"any\",\n \"new_with_tags\",\n \"new_without_tags\",\n \"very_good\",\n \"good\",\n \"satisfactory\"\n ],\n \"enumTitles\": [\n \"Any condition\",\n \"New with tags\",\n \"New without tags\",\n \"Very good\",\n \"Good\",\n \"Satisfactory\"\n ],\n \"default\": \"any\",\n \"prefill\": \"any\"\n },\n \"priceFrom\": {\n \"title\": \"Min price (mode=search)\",\n \"type\": \"integer\",\n \"description\": \"Minimum price in the market's local currency.\",\n \"editor\": \"number\",\n \"sectionCaption\": \"Search Filters\",\n \"minimum\": 0,\n \"maximum\": 1000000\n },\n \"priceTo\": {\n \"title\": \"Max price (mode=search)\",\n \"type\": \"integer\",\n \"description\": \"Maximum price in the market's local currency.\",\n \"editor\": \"number\",\n \"sectionCaption\": \"Search Filters\",\n \"minimum\": 0,\n \"maximum\": 1000000\n },\n \"deepSearch\": {\n \"title\": \"Deep search past 960 results\",\n \"type\": \"boolean\",\n \"description\": \"Vinted returns at most 960 results per query. Deep search splits the query into price bands so it can collect more (more requests, slower).\",\n \"editor\": \"checkbox\",\n \"sectionCaption\": \"Enrichment & Limits\",\n \"default\": false,\n \"prefill\": false\n },\n \"includeItemDetails\": {\n \"title\": \"Include item details\",\n \"type\": \"boolean\",\n \"description\": \"Open each item page for description, colour, material, category, condition ID, upload age, all photos and seller rating. One extra request per item.\",\n \"editor\": \"checkbox\",\n \"sectionCaption\": \"Enrichment & Limits\",\n \"default\": false,\n \"prefill\": false\n },\n \"includeSellerStats\": {\n \"title\": \"Include seller stats / shop\",\n \"type\": \"boolean\",\n \"description\": \"Add seller rating, feedback count, item/sold counts, followers and shop identity (one profile request per distinct seller).\",\n \"editor\": \"checkbox\",\n \"sectionCaption\": \"Enrichment & Limits\",\n \"default\": false,\n \"prefill\": false\n },\n \"minRating\": {\n \"title\": \"Minimum seller rating\",\n \"type\": \"number\",\n \"description\": \"Drop items whose seller rating is below this value (0–5). Items without a rating pass through. Automatically enables seller stats.\",\n \"editor\": \"number\",\n \"sectionCaption\": \"Enrichment & Limits\",\n \"minimum\": 0,\n \"maximum\": 5\n },\n \"containsKeyword\": {\n \"title\": \"Title or description contains keyword\",\n \"type\": \"string\",\n \"description\": \"Drop items whose title or description does not contain this keyword (case-insensitive). Without item details only the title is searched.\",\n \"editor\": \"textfield\",\n \"sectionCaption\": \"Enrichment & Limits\"\n },\n \"maxItems\": {\n \"title\": \"Max items\",\n \"type\": \"integer\",\n \"description\": \"Hard cap on emitted records. Values above 960 need deep search.\",\n \"editor\": \"number\",\n \"sectionCaption\": \"Enrichment & Limits\",\n \"minimum\": 1,\n \"maximum\": 5000,\n \"default\": 50,\n \"prefill\": 1\n },\n \"feedbackType\": {\n \"title\": \"Feedback type (mode=byUserFeedbacks)\",\n \"type\": \"string\",\n \"description\": \"All reviews, member-written reviews, or Vinted's automatic sale-completion entries.\",\n \"editor\": \"select\",\n \"sectionCaption\": \"Enrichment & Limits\",\n \"enum\": [\n \"all\",\n \"member\",\n \"automatic\"\n ],\n \"enumTitles\": [\n \"All feedback\",\n \"Member reviews\",\n \"Automatic system feedback\"\n ],\n \"default\": \"all\",\n \"prefill\": \"all\"\n }\n },\n \"required\": [\n \"mode\",\n \"country\"\n ]\n}", "readme": "# Vinted Secondhand Listings, Closets & Seller Feedback\n\nVinted is a large second-hand fashion marketplace spread across country storefronts. This actor turns its public listings, item pages, seller profiles, closets, feedback history, brands and categories into clean dataset rows across 27 markets. Search by keyword with Vinted's own filters, paste filtered URLs, open full item details, or vet a seller before buying. No account, cookies or proxy setup is needed.\n\n## What this actor does\n\n- **Seven modes:** `search`, `byUrl`, `byUser`, `byBrand`, `byCatalog`, `byBrandSearch`, `byUserFeedbacks`\n- **27 markets:** United States, United Kingdom, France, Germany, Italy, Spain, Poland, Czechia, Netherlands, Lithuania, Luxembourg, Austria, Belgium, Portugal, Romania, Slovakia, Finland, Sweden, Greece, Denmark, Estonia, Croatia, Hungary, Ireland, Latvia, Slovenia and Australia\n- **Search filters:** keyword, brand, category, size, colour, condition, material, price range and sort order, combinable in one search\n- **Deep search:** split a broad search into price bands to collect beyond Vinted's 960-result ceiling per query\n- **Optional item details:** description, colour, material, category path, condition ID, upload age, every photo and seller rating\n- **Optional seller stats:** rating, feedback counts, live and sold item counts, followers, business/shop identity\n- **Seller feedback:** full review history with rating, text, reviewer and optional owner reply\n- **Best-effort enrichment:** item details and seller stats are optional; under Vinted rate limits those fields can be omitted or delayed while the search rows still return\n- **Empty fields are omitted** — every value in a row is real; fields Vinted does not expose are absent, not filled with placeholders\n\n## Output per item\n\n- `itemId`, `title`, `description`\n- `brandTitle`, `brandId`, `brandUrl`\n- `sizeTitle`, `sizeId`, `sizeEquivalents`\n- `status` (condition as shown on the storefront), `condition` (English), `conditionId`, `statusId`\n- `color`, `colors`, `materials`, `otherAttributes`\n- `catalogId`, `categoryName`, `categoryPath`\n- `priceAmount`, `priceCurrency`, `totalPriceAmount`, `serviceFeeAmount`, `shippingAmount`, `freeShipping`\n- `favouriteCount`, `isPromoted`, `isReserved`, `isClosed`, `isHidden`, `isVisible`, `availability`\n- `uploadedAgo` — Vinted's relative posting age (e.g. \"2 hours ago\")\n- `itemUrl`, `canonicalUrl`, `imageUrl`, `photos[]`, `photoCount`\n- `sellerId`, `sellerLogin`, `sellerCountryCode`, `sellerProfileUrl`, `sellerAvatarUrl`\n- `sellerRating`, `sellerFeedbackCount`, `sellerFeedbackReputation`\n- `sellerPositiveFeedbackCount`, `sellerNeutralFeedbackCount`, `sellerNegativeFeedbackCount`\n- `sellerItemCount`, `sellerSoldItemCount`, `sellerBoughtItemCount`, `sellerFollowersCount`\n- `sellerIsBusiness`, `sellerIsOnline`, `sellerBadges`\n- `sellerShopName`, `sellerShopLegalName`, `sellerShopVatNumber`, `sellerShopCountry`, `sellerShop`\n- `sourceUrl` when an item came from a pasted URL\n- `recordType`, `scrapedAt`, `siteName`, `sourceCountry`, `sourceCountryCode`\n\nFields marked optional above appear only when the selected mode enriches the row or Vinted supplies them.\n\n## Output per seller profile\n\n- `userId`, `login`, `realName`, `about`, `city`, `countryCode`, `countryTitle`, `countryId`\n- `avatarUrl`, `avatarThumbnailUrl`, `profileUrl`\n- `rating` (0–5), `feedbackCount`, `feedbackReputation`, `feedbackRating`\n- `positiveFeedbackCount`, `negativeFeedbackCount`, `neutralFeedbackCount`\n- `itemCount`, `totalItemsCount`, `soldItemCount`, `boughtItemCount`\n- `followersCount`, `followingCount`\n- `isBusiness`, `isOnHoliday`, `isOnline`, `verifications`\n- `shop` — name, legal name/code, VAT number, registrar, country, address and verification state for business sellers\n- `lastLoggedOn`, `recordType`, `scrapedAt`, `siteName`, `sourceCountry`, `sourceCountryCode`\n\nOne profile row is written before that seller's closet items.\n\n## Output per feedback entry\n\n- `feedbackId`, `feedbackText`, `rating`, `createdAt`\n- `itemId`, `itemUrl`\n- `feedbackUserId`, `reviewerId`, `reviewerLogin`, `reviewerProfileUrl`\n- `isSystem`, `isAutomatic`, `feedbackType` (`member` or `automatic`)\n- `ownerComment`, `ownerLogin`\n- `recordType`, `scrapedAt`, `siteName`, `sourceCountry`, `sourceCountryCode`\n\n## Output per brand\n\n- `brandId`, `title`, `slug`\n- `favouriteCount`, `itemCount`, `currency`\n- `isVisibleInListings`, `requiresAuthenticityCheck`, `isLuxury`, `isHighValue`\n- `brandUrl`, `canonicalUrl`\n- `recordType`, `scrapedAt`, `siteName`, `sourceCountry`, `sourceCountryCode`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search`, `byUrl`, `byUser`, `byBrand`, `byCatalog`, `byBrandSearch` or `byUserFeedbacks` |\n| `country` | string | `com` | Market suffix, e.g. `com`, `co.uk`, `fr`, `de`, `pl` |\n| `searchText` | string | – | Keyword (mode=search) |\n| `order` | string | `relevance` | `relevance`, `newest_first`, `price_low_to_high`, `price_high_to_low` |\n| `urls` | array | – | Item, member, brand, catalog or filtered search URLs (mode=byUrl) |\n| `userId` | string | – | Numeric user ID, username or member URL (mode=byUser / byUserFeedbacks) |\n| `brandId` | string | – | Brand ID or brand URL (mode=byBrand) |\n| `catalogId` | string | – | Category ID or catalog URL (mode=byCatalog) |\n| `brandKeyword` | string | – | Brand registry keyword (mode=byBrandSearch) |\n| `brandIds` | array | – | Brand ID filters |\n| `catalogIds` | array | – | Category ID filters |\n| `sizeIds` | array | – | Size ID filters |\n| `color` | string | `any` | Vinted colour ID; the dropdown shows labels such as Black, Gray, White, Cream, Beige, Red, Blue, Green, Brown, Yellow, Silver, Gold and Multi |\n| `materialIds` | array | – | Material ID filters |\n| `condition` | string | `any` | `new_with_tags`, `new_without_tags`, `very_good`, `good`, `satisfactory` |\n| `priceFrom` / `priceTo` | integer | – | Price range in the market's local currency |\n| `deepSearch` | boolean | `false` | Split broad searches into price bands past 960 results; a saturated single-price band is treated as truncated |\n| `includeItemDetails` | boolean | `false` | Add description, attributes, all photos and seller rating from item pages |\n| `includeSellerStats` | boolean | `false` | Add seller rating, counts, followers and shop identity |\n| `minRating` | number | – | Drop items below this seller rating (0–5); items without a rating pass |\n| `containsKeyword` | string | – | Keep items whose title or description contains this text |\n| `maxItems` | integer | `50` | Hard cap (1–5000) |\n| `feedbackType` | string | `all` | `all`, `member` or `automatic` (mode=byUserFeedbacks) |\n\n### Example: search a brand with filters\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"fr\",\n \"searchText\": \"nike air max\",\n \"brandIds\": [\"53\"],\n \"sizeIds\": [\"207\"],\n \"condition\": \"very_good\",\n \"priceFrom\": 20,\n \"priceTo\": 80,\n \"maxItems\": 100\n}\n```\n\n### Example: item details and seller stats\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"de\",\n \"searchText\": \"carhartt jacket\",\n \"includeItemDetails\": true,\n \"includeSellerStats\": true,\n \"maxItems\": 25\n}\n```\n\n### Example: a seller's profile, closet and feedback\n\n```json\n{\n \"mode\": \"byUrl\",\n \"country\": \"co.uk\",\n \"urls\": [\n \"https://www.vinted.co.uk/member/123456789-seller-name\"\n ],\n \"maxItems\": 50\n}\n```\n\n```json\n{\n \"mode\": \"byUserFeedbacks\",\n \"country\": \"fr\",\n \"userId\": \"123456789\",\n \"feedbackType\": \"member\",\n \"maxItems\": 100\n}\n```\n\n### Example: deep search past 960 results\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"pl\",\n \"searchText\": \"nike\",\n \"deepSearch\": true,\n \"maxItems\": 3000\n}\n```\n\n## Use cases\n\n- **Resale sourcing** — scan a brand, size or category for underpriced listings before they sell\n- **Price monitoring** — track asking prices and buyer-protection totals across markets over time\n- **Seller vetting** — pull a seller's rating, sold count, feedback history, followers and shop identity\n- **Market research** — measure listing volume, condition mix and price bands for a brand or category\n- **Closet monitoring** — schedule a seller's closet to spot new stock as it appears\n- **Brand and category discovery** — resolve Vinted brand IDs and category paths for saved searches\n\n## FAQ\n\n**Do I need a Vinted account or cookies?**\nNo. Every mode reads publicly available Vinted pages and endpoints. No login, API key or cookie setup is required.\n\n**How many markets are supported?**\n27 live Vinted markets, each with its own currency and storefront language. Use the `country` dropdown; pasted URLs use their own domain.\n\n**How many results can I get?**\nVinted returns at most 960 results per query. Turn on `deepSearch` to split a broad query into price bands and collect beyond that ceiling. If a single price point still has more than 960 matches, that band cannot be fully enumerated and is treated as truncated, so deep coverage is broader than 960 but not exhaustive. Closets are capped by Vinted at 10,000 visible items per seller.\n\n**Why is the posting date relative instead of an exact timestamp?**\nVinted stopped exposing an exact listing creation time. The actor returns the relative `uploadedAgo` value the site shows and does not invent a date. View counts are no longer public either, so neither field is fabricated.\n\n**Why do some items lack a brand, material, colour, description or seller rating?**\nSellers can leave optional fields blank, and new sellers have no feedback yet. Item-page and seller-stat enrichment is best-effort: if Vinted rate-limits those routes, the row keeps its search fields and omits the enrichment fields instead of inventing values. Seller-stat enrichment stops after repeated API failures, so a rate-limited run can take several minutes and finish with fewer seller counts. Optional fields are omitted rather than filled with a placeholder.\n\n**Why is `status` in a local language while `condition` is in English?**\nVinted localizes condition names per market. `status` keeps the storefront wording, while `condition` and `conditionId` provide a stable cross-market equivalent. The ID is the reliable key for filtering.\n\n**Can I scrape sold listings or sold prices?**\nNo. Vinted removes sold listings from public search and exposes no complete sold feed. Seller `soldItemCount` and review rows with an item ID are useful sale signals, but they are not a sold-price history.\n\n**Do the same listings appear in several markets?**\nSome markets share one inventory pool and show the same item at converted prices. Match rows by `itemId`; a price difference between markets is often currency conversion, not a separate listing.\n\n**Do images open without authentication?**\nYes. Image URLs are public and load without cookies or a referrer.\n\n**Is this affiliated with Vinted?**\nNo. This is an independent third-party actor that reads publicly accessible marketplace data. It is not affiliated with or endorsed by Vinted.\n", "actorDefinition": { "actorSpecification": 1, "name": "vinted-secondhand-listings-closets-and-seller", "title": "Vinted Secondhand Listings, Closets & Seller Feedback", "description": "Search Vinted listings by keyword, brand, size, condition, colour, material and price across 27 markets. Pull item details, seller closets, profiles, shop data, feedback, brands and categories.", "version": "1.0", "buildTag": "latest", "dockerfile": "./Dockerfile", "readme": "# Vinted Secondhand Listings, Closets & Seller Feedback\n\nVinted is a large second-hand fashion marketplace spread across country storefronts. This actor turns its public listings, item pages, seller profiles, closets, feedback history, brands and categories into clean dataset rows across 27 markets. Search by keyword with Vinted's own filters, paste filtered URLs, open full item details, or vet a seller before buying. No account, cookies or proxy setup is needed.\n\n## What this actor does\n\n- **Seven modes:** `search`, `byUrl`, `byUser`, `byBrand`, `byCatalog`, `byBrandSearch`, `byUserFeedbacks`\n- **27 markets:** United States, United Kingdom, France, Germany, Italy, Spain, Poland, Czechia, Netherlands, Lithuania, Luxembourg, Austria, Belgium, Portugal, Romania, Slovakia, Finland, Sweden, Greece, Denmark, Estonia, Croatia, Hungary, Ireland, Latvia, Slovenia and Australia\n- **Search filters:** keyword, brand, category, size, colour, condition, material, price range and sort order, combinable in one search\n- **Deep search:** split a broad search into price bands to collect beyond Vinted's 960-result ceiling per query\n- **Optional item details:** description, colour, material, category path, condition ID, upload age, every photo and seller rating\n- **Optional seller stats:** rating, feedback counts, live and sold item counts, followers, business/shop identity\n- **Seller feedback:** full review history with rating, text, reviewer and optional owner reply\n- **Best-effort enrichment:** item details and seller stats are optional; under Vinted rate limits those fields can be omitted or delayed while the search rows still return\n- **Empty fields are omitted** — every value in a row is real; fields Vinted does not expose are absent, not filled with placeholders\n\n## Output per item\n\n- `itemId`, `title`, `description`\n- `brandTitle`, `brandId`, `brandUrl`\n- `sizeTitle`, `sizeId`, `sizeEquivalents`\n- `status` (condition as shown on the storefront), `condition` (English), `conditionId`, `statusId`\n- `color`, `colors`, `materials`, `otherAttributes`\n- `catalogId`, `categoryName`, `categoryPath`\n- `priceAmount`, `priceCurrency`, `totalPriceAmount`, `serviceFeeAmount`, `shippingAmount`, `freeShipping`\n- `favouriteCount`, `isPromoted`, `isReserved`, `isClosed`, `isHidden`, `isVisible`, `availability`\n- `uploadedAgo` — Vinted's relative posting age (e.g. \"2 hours ago\")\n- `itemUrl`, `canonicalUrl`, `imageUrl`, `photos[]`, `photoCount`\n- `sellerId`, `sellerLogin`, `sellerCountryCode`, `sellerProfileUrl`, `sellerAvatarUrl`\n- `sellerRating`, `sellerFeedbackCount`, `sellerFeedbackReputation`\n- `sellerPositiveFeedbackCount`, `sellerNeutralFeedbackCount`, `sellerNegativeFeedbackCount`\n- `sellerItemCount`, `sellerSoldItemCount`, `sellerBoughtItemCount`, `sellerFollowersCount`\n- `sellerIsBusiness`, `sellerIsOnline`, `sellerBadges`\n- `sellerShopName`, `sellerShopLegalName`, `sellerShopVatNumber`, `sellerShopCountry`, `sellerShop`\n- `sourceUrl` when an item came from a pasted URL\n- `recordType`, `scrapedAt`, `siteName`, `sourceCountry`, `sourceCountryCode`\n\nFields marked optional above appear only when the selected mode enriches the row or Vinted supplies them.\n\n## Output per seller profile\n\n- `userId`, `login`, `realName`, `about`, `city`, `countryCode`, `countryTitle`, `countryId`\n- `avatarUrl`, `avatarThumbnailUrl`, `profileUrl`\n- `rating` (0–5), `feedbackCount`, `feedbackReputation`, `feedbackRating`\n- `positiveFeedbackCount`, `negativeFeedbackCount`, `neutralFeedbackCount`\n- `itemCount`, `totalItemsCount`, `soldItemCount`, `boughtItemCount`\n- `followersCount`, `followingCount`\n- `isBusiness`, `isOnHoliday`, `isOnline`, `verifications`\n- `shop` — name, legal name/code, VAT number, registrar, country, address and verification state for business sellers\n- `lastLoggedOn`, `recordType`, `scrapedAt`, `siteName`, `sourceCountry`, `sourceCountryCode`\n\nOne profile row is written before that seller's closet items.\n\n## Output per feedback entry\n\n- `feedbackId`, `feedbackText`, `rating`, `createdAt`\n- `itemId`, `itemUrl`\n- `feedbackUserId`, `reviewerId`, `reviewerLogin`, `reviewerProfileUrl`\n- `isSystem`, `isAutomatic`, `feedbackType` (`member` or `automatic`)\n- `ownerComment`, `ownerLogin`\n- `recordType`, `scrapedAt`, `siteName`, `sourceCountry`, `sourceCountryCode`\n\n## Output per brand\n\n- `brandId`, `title`, `slug`\n- `favouriteCount`, `itemCount`, `currency`\n- `isVisibleInListings`, `requiresAuthenticityCheck`, `isLuxury`, `isHighValue`\n- `brandUrl`, `canonicalUrl`\n- `recordType`, `scrapedAt`, `siteName`, `sourceCountry`, `sourceCountryCode`\n\n## Input\n\n| Field | Type | Default | Description |\n|---|---|---|---|\n| `mode` | string | `search` | `search`, `byUrl`, `byUser`, `byBrand`, `byCatalog`, `byBrandSearch` or `byUserFeedbacks` |\n| `country` | string | `com` | Market suffix, e.g. `com`, `co.uk`, `fr`, `de`, `pl` |\n| `searchText` | string | – | Keyword (mode=search) |\n| `order` | string | `relevance` | `relevance`, `newest_first`, `price_low_to_high`, `price_high_to_low` |\n| `urls` | array | – | Item, member, brand, catalog or filtered search URLs (mode=byUrl) |\n| `userId` | string | – | Numeric user ID, username or member URL (mode=byUser / byUserFeedbacks) |\n| `brandId` | string | – | Brand ID or brand URL (mode=byBrand) |\n| `catalogId` | string | – | Category ID or catalog URL (mode=byCatalog) |\n| `brandKeyword` | string | – | Brand registry keyword (mode=byBrandSearch) |\n| `brandIds` | array | – | Brand ID filters |\n| `catalogIds` | array | – | Category ID filters |\n| `sizeIds` | array | – | Size ID filters |\n| `color` | string | `any` | Vinted colour ID; the dropdown shows labels such as Black, Gray, White, Cream, Beige, Red, Blue, Green, Brown, Yellow, Silver, Gold and Multi |\n| `materialIds` | array | – | Material ID filters |\n| `condition` | string | `any` | `new_with_tags`, `new_without_tags`, `very_good`, `good`, `satisfactory` |\n| `priceFrom` / `priceTo` | integer | – | Price range in the market's local currency |\n| `deepSearch` | boolean | `false` | Split broad searches into price bands past 960 results; a saturated single-price band is treated as truncated |\n| `includeItemDetails` | boolean | `false` | Add description, attributes, all photos and seller rating from item pages |\n| `includeSellerStats` | boolean | `false` | Add seller rating, counts, followers and shop identity |\n| `minRating` | number | – | Drop items below this seller rating (0–5); items without a rating pass |\n| `containsKeyword` | string | – | Keep items whose title or description contains this text |\n| `maxItems` | integer | `50` | Hard cap (1–5000) |\n| `feedbackType` | string | `all` | `all`, `member` or `automatic` (mode=byUserFeedbacks) |\n\n### Example: search a brand with filters\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"fr\",\n \"searchText\": \"nike air max\",\n \"brandIds\": [\"53\"],\n \"sizeIds\": [\"207\"],\n \"condition\": \"very_good\",\n \"priceFrom\": 20,\n \"priceTo\": 80,\n \"maxItems\": 100\n}\n```\n\n### Example: item details and seller stats\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"de\",\n \"searchText\": \"carhartt jacket\",\n \"includeItemDetails\": true,\n \"includeSellerStats\": true,\n \"maxItems\": 25\n}\n```\n\n### Example: a seller's profile, closet and feedback\n\n```json\n{\n \"mode\": \"byUrl\",\n \"country\": \"co.uk\",\n \"urls\": [\n \"https://www.vinted.co.uk/member/123456789-seller-name\"\n ],\n \"maxItems\": 50\n}\n```\n\n```json\n{\n \"mode\": \"byUserFeedbacks\",\n \"country\": \"fr\",\n \"userId\": \"123456789\",\n \"feedbackType\": \"member\",\n \"maxItems\": 100\n}\n```\n\n### Example: deep search past 960 results\n\n```json\n{\n \"mode\": \"search\",\n \"country\": \"pl\",\n \"searchText\": \"nike\",\n \"deepSearch\": true,\n \"maxItems\": 3000\n}\n```\n\n## Use cases\n\n- **Resale sourcing** — scan a brand, size or category for underpriced listings before they sell\n- **Price monitoring** — track asking prices and buyer-protection totals across markets over time\n- **Seller vetting** — pull a seller's rating, sold count, feedback history, followers and shop identity\n- **Market research** — measure listing volume, condition mix and price bands for a brand or category\n- **Closet monitoring** — schedule a seller's closet to spot new stock as it appears\n- **Brand and category discovery** — resolve Vinted brand IDs and category paths for saved searches\n\n## FAQ\n\n**Do I need a Vinted account or cookies?**\nNo. Every mode reads publicly available Vinted pages and endpoints. No login, API key or cookie setup is required.\n\n**How many markets are supported?**\n27 live Vinted markets, each with its own currency and storefront language. Use the `country` dropdown; pasted URLs use their own domain.\n\n**How many results can I get?**\nVinted returns at most 960 results per query. Turn on `deepSearch` to split a broad query into price bands and collect beyond that ceiling. If a single price point still has more than 960 matches, that band cannot be fully enumerated and is treated as truncated, so deep coverage is broader than 960 but not exhaustive. Closets are capped by Vinted at 10,000 visible items per seller.\n\n**Why is the posting date relative instead of an exact timestamp?**\nVinted stopped exposing an exact listing creation time. The actor returns the relative `uploadedAgo` value the site shows and does not invent a date. View counts are no longer public either, so neither field is fabricated.\n\n**Why do some items lack a brand, material, colour, description or seller rating?**\nSellers can leave optional fields blank, and new sellers have no feedback yet. Item-page and seller-stat enrichment is best-effort: if Vinted rate-limits those routes, the row keeps its search fields and omits the enrichment fields instead of inventing values. Seller-stat enrichment stops after repeated API failures, so a rate-limited run can take several minutes and finish with fewer seller counts. Optional fields are omitted rather than filled with a placeholder.\n\n**Why is `status` in a local language while `condition` is in English?**\nVinted localizes condition names per market. `status` keeps the storefront wording, while `condition` and `conditionId` provide a stable cross-market equivalent. The ID is the reliable key for filtering.\n\n**Can I scrape sold listings or sold prices?**\nNo. Vinted removes sold listings from public search and exposes no complete sold feed. Seller `soldItemCount` and review rows with an item ID are useful sale signals, but they are not a sold-price history.\n\n**Do the same listings appear in several markets?**\nSome markets share one inventory pool and show the same item at converted prices. Match rows by `itemId`; a price difference between markets is often currency conversion, not a separate listing.\n\n**Do images open without authentication?**\nYes. Image URLs are public and load without cookies or a referrer.\n\n**Is this affiliated with Vinted?**\nNo. This is an independent third-party actor that reads publicly accessible marketplace data. It is not affiliated with or endorsed by Vinted.\n", "input": { "title": "Vinted Scraper Input", "description": "Search Vinted second-hand fashion across 27 country domains, pull item details, seller closets, profiles, shop data, feedback, brands and categories.", "type": "object", "schemaVersion": 1, "properties": { "mode": { "title": "Scrape mode", "type": "string", "description": "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.", "editor": "select", "sectionCaption": "Mode & Market", "enum": [ "search", "byUrl", "byUser", "byBrand", "byCatalog", "byBrandSearch", "byUserFeedbacks" ], "enumTitles": [ "Search items (keyword + filters)", "By URL (item / member / brand / catalog / search)", "By user (profile + closet)", "By brand (items)", "By catalog (category items)", "Search brand registry", "By user feedbacks (seller reviews)" ], "default": "search", "prefill": "search" }, "country": { "title": "Country / market", "type": "string", "description": "Vinted market to query. The market controls currency, language and local inventory.", "editor": "select", "sectionCaption": "Mode & Market", "enum": [ "com", "co.uk", "fr", "de", "it", "es", "pl", "cz", "nl", "lt", "lu", "at", "be", "pt", "ro", "sk", "fi", "se", "gr", "dk", "ee", "hr", "hu", "ie", "lv", "si", "com.au" ], "enumTitles": [ "United States (vinted.com, USD)", "United Kingdom (vinted.co.uk, GBP)", "France (vinted.fr, EUR)", "Germany (vinted.de, EUR)", "Italy (vinted.it, EUR)", "Spain (vinted.es, EUR)", "Poland (vinted.pl, PLN)", "Czechia (vinted.cz, CZK)", "Netherlands (vinted.nl, EUR)", "Lithuania (vinted.lt, EUR)", "Luxembourg (vinted.lu, EUR)", "Austria (vinted.at, EUR)", "Belgium (vinted.be, EUR)", "Portugal (vinted.pt, EUR)", "Romania (vinted.ro, RON)", "Slovakia (vinted.sk, EUR)", "Finland (vinted.fi, EUR)", "Sweden (vinted.se, SEK)", "Greece (vinted.gr, EUR)", "Denmark (vinted.dk, DKK)", "Estonia (vinted.ee, EUR)", "Croatia (vinted.hr, EUR)", "Hungary (vinted.hu, HUF)", "Ireland (vinted.ie, EUR)", "Latvia (vinted.lv, EUR)", "Slovenia (vinted.si, EUR)", "Australia (vinted.com.au, AUD)" ], "default": "com", "prefill": "com" }, "searchText": { "title": "Search query (mode=search)", "type": "string", "description": "Free-text keyword. Leave empty with a brand/category filter to browse. A bare run defaults to adidas.", "editor": "textfield", "sectionCaption": "Search Inputs", "default": "", "prefill": "adidas" }, "order": { "title": "Sort order (mode=search / byBrand / byCatalog)", "type": "string", "description": "Result ordering for item searches.", "editor": "select", "sectionCaption": "Search Inputs", "enum": [ "relevance", "newest_first", "price_low_to_high", "price_high_to_low" ], "enumTitles": [ "Relevance", "Newest first", "Price: low to high", "Price: high to low" ], "default": "relevance", "prefill": "relevance" }, "urls": { "title": "Vinted URLs (mode=byUrl)", "type": "array", "description": "Item, member, brand, catalog or filtered search URLs. Mixed country domains are supported.", "editor": "stringList", "sectionCaption": "Per-Mode Targets", "default": [], "prefill": [] }, "userId": { "title": "User ID, username or URL (mode=byUser / byUserFeedbacks)", "type": "string", "description": "Numeric Vinted user ID, username, or member URL.", "editor": "textfield", "sectionCaption": "Per-Mode Targets" }, "brandId": { "title": "Brand ID or URL (mode=byBrand)", "type": "string", "description": "Numeric brand ID or brand URL. Discover IDs with Search brand registry.", "editor": "textfield", "sectionCaption": "Per-Mode Targets" }, "catalogId": { "title": "Catalog ID or URL (mode=byCatalog)", "type": "string", "description": "Numeric category ID or /catalog/-slug URL.", "editor": "textfield", "sectionCaption": "Per-Mode Targets" }, "brandKeyword": { "title": "Brand keyword (mode=byBrandSearch)", "type": "string", "description": "Keyword to search the Vinted brand registry.", "editor": "textfield", "sectionCaption": "Per-Mode Targets" }, "brandIds": { "title": "Brand IDs filter (mode=search)", "type": "array", "description": "Numeric brand IDs, e.g. [53] for Nike.", "editor": "stringList", "sectionCaption": "Search Filters", "default": [], "prefill": [] }, "catalogIds": { "title": "Catalog IDs filter (mode=search)", "type": "array", "description": "Numeric category IDs, e.g. [1904] for Women.", "editor": "stringList", "sectionCaption": "Search Filters", "default": [], "prefill": [] }, "sizeIds": { "title": "Size IDs filter (mode=search)", "type": "array", "description": "Numeric Vinted size IDs. Use the size facet shown on a Vinted search URL.", "editor": "stringList", "sectionCaption": "Search Filters", "default": [], "prefill": [] }, "color": { "title": "Color filter (mode=search)", "type": "string", "description": "Single colour filter. Choose any to leave it unfiltered.", "editor": "select", "sectionCaption": "Search Filters", "enum": [ "any", "1", "3", "12", "20", "4", "21", "11", "22", "7", "23", "5", "24", "6", "25", "26", "9", "27", "17", "30", "10", "28", "16", "2", "29", "8", "13", "14", "15", "32" ], "enumTitles": [ "Any color", "Black", "Gray", "White", "Cream", "Beige", "Apricot", "Orange", "Coral", "Red", "Burgundy", "Pink", "Rose", "Purple", "Lilac", "Light blue", "Blue", "Navy", "Turquoise", "Mint", "Green", "Dark green", "Khaki", "Brown", "Mustard", "Yellow", "Silver", "Gold", "Multi", "Clear" ], "default": "any", "prefill": "any" }, "materialIds": { "title": "Material IDs filter (mode=search)", "type": "array", "description": "Numeric material IDs from Vinted's Material facet (e.g. 44 = Cotton).", "editor": "stringList", "sectionCaption": "Search Filters", "default": [], "prefill": [] }, "condition": { "title": "Condition filter (mode=search)", "type": "string", "description": "Vinted condition. Choose any to leave it unfiltered.", "editor": "select", "sectionCaption": "Search Filters", "enum": [ "any", "new_with_tags", "new_without_tags", "very_good", "good", "satisfactory" ], "enumTitles": [ "Any condition", "New with tags", "New without tags", "Very good", "Good", "Satisfactory" ], "default": "any", "prefill": "any" }, "priceFrom": { "title": "Min price (mode=search)", "type": "integer", "description": "Minimum price in the market's local currency.", "editor": "number", "sectionCaption": "Search Filters", "minimum": 0, "maximum": 1000000 }, "priceTo": { "title": "Max price (mode=search)", "type": "integer", "description": "Maximum price in the market's local currency.", "editor": "number", "sectionCaption": "Search Filters", "minimum": 0, "maximum": 1000000 }, "deepSearch": { "title": "Deep search past 960 results", "type": "boolean", "description": "Vinted returns at most 960 results per query. Deep search splits the query into price bands so it can collect more (more requests, slower).", "editor": "checkbox", "sectionCaption": "Enrichment & Limits", "default": false, "prefill": false }, "includeItemDetails": { "title": "Include item details", "type": "boolean", "description": "Open each item page for description, colour, material, category, condition ID, upload age, all photos and seller rating. One extra request per item.", "editor": "checkbox", "sectionCaption": "Enrichment & Limits", "default": false, "prefill": false }, "includeSellerStats": { "title": "Include seller stats / shop", "type": "boolean", "description": "Add seller rating, feedback count, item/sold counts, followers and shop identity (one profile request per distinct seller).", "editor": "checkbox", "sectionCaption": "Enrichment & Limits", "default": false, "prefill": false }, "minRating": { "title": "Minimum seller rating", "type": "number", "description": "Drop items whose seller rating is below this value (0–5). Items without a rating pass through. Automatically enables seller stats.", "editor": "number", "sectionCaption": "Enrichment & Limits", "minimum": 0, "maximum": 5 }, "containsKeyword": { "title": "Title or description contains keyword", "type": "string", "description": "Drop items whose title or description does not contain this keyword (case-insensitive). Without item details only the title is searched.", "editor": "textfield", "sectionCaption": "Enrichment & Limits" }, "maxItems": { "title": "Max items", "type": "integer", "description": "Hard cap on emitted records. Values above 960 need deep search.", "editor": "number", "sectionCaption": "Enrichment & Limits", "minimum": 1, "maximum": 5000, "default": 50, "prefill": 1 }, "feedbackType": { "title": "Feedback type (mode=byUserFeedbacks)", "type": "string", "description": "All reviews, member-written reviews, or Vinted's automatic sale-completion entries.", "editor": "select", "sectionCaption": "Enrichment & Limits", "enum": [ "all", "member", "automatic" ], "enumTitles": [ "All feedback", "Member reviews", "Automatic system feedback" ], "default": "all", "prefill": "all" } }, "required": [ "mode", "country" ] }, "output": { "actorOutputSchemaVersion": 1, "title": "Vinted Multi-Market Listings, Closets & Seller Feedback Output", "description": "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.", "properties": { "items": { "type": "string", "title": "Vinted records", "description": "Dataset containing all scraped Vinted item, user, brand and feedback records.", "template": "{{links.apiDefaultDatasetUrl}}/items" } } }, "storages": { "dataset": { "actorSpecification": 1, "views": { "overview": { "title": "Vinted listings", "transformation": { "fields": [ "recordType", "title", "brandTitle", "condition", "priceAmount", "priceCurrency", "sellerLogin", "sellerRating", "sourceCountry", "itemUrl" ] }, "display": { "component": "table", "properties": {} } } } } }, "environmentVariables": {} }, "buildNumber": "1.0.2", "imageDigest": "fa795c98ec0c3c9b23e0c83676c5316ae757a70e3cd974189d9afef19a1aba9e", "actVersion": { "sourceType": "SOURCE_FILES", "buildTag": "latest", "versionNumber": "1.0" }, "usage": { "ACTOR_COMPUTE_UNITS": 0.005384444444444444 } } }