{ "openapi": "3.0.1", "info": { "title": "Vinted Scraper — US, UK & EU Listings, Prices, No Login", "description": "Scrape listings from 23 Vinted sites (US, UK, France and more) by search term, category or URL: title, price, buyer-protection fee and total, brand, size, condition, favourites, photos. Optional description, colours, material, upload time. Seller names and profiles never collected. No login.", "version": "0.1", "x-build-id": "Ft7KejcktekAT7nKu" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/yugenox~vinted-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-yugenox-vinted-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/yugenox~vinted-scraper/runs": { "post": { "operationId": "runs-sync-yugenox-vinted-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/yugenox~vinted-scraper/run-sync": { "post": { "operationId": "run-sync-yugenox-vinted-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "searchTerms": { "title": "🔍 Search terms", "type": "array", "description": "What to search for, as you would type it on Vinted, e.g. \"denim jacket\", \"levis 501\", \"barbour\". Each term is a separate search. Leave empty to browse a whole category.", "items": { "type": "string" } }, "country": { "title": "Vinted site", "enum": [ "us", "uk", "fr", "de", "it", "es", "nl", "be", "at", "lu", "ie", "pt", "pl", "cz", "sk", "lt", "hu", "ro", "se", "dk", "fi", "gr", "hr" ], "type": "string", "description": "Which Vinted country site to search. Prices come in that site's currency. Pasted URLs always use their own site.", "default": "us" }, "category": { "title": "Category", "type": "string", "description": "Optional: limit the search to one Vinted category, or browse it without search terms. Type its English name or path (\"Women > Jackets\", \"Men > Denim jackets\", \"Sneakers\"), its id (\"1079\") or paste a Vinted category URL. Category ids are the same on every Vinted site." }, "maxItems": { "title": "Max listings", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Maximum number of listings for the whole run, shared fairly between your searches. 0 = as many as possible. Vinted shows up to 960 listings per search; bigger searches are split into subcategories automatically.", "default": 100 }, "includeDetails": { "title": "Include item details", "type": "boolean", "description": "Also open each item page for the description, every photo, the category path, colours, material, upload time, availability and reserved status. One extra page per listing, charged as \"Listing details\".", "default": false }, "startUrls": { "title": "🔗 Vinted URLs", "type": "array", "description": "Optional: Vinted search, category or brand URLs (vinted.com/catalog?search_text=…, /catalog/1079-denim-jackets, /brand/…, with any filters you set on the site) or item URLs (vinted.co.uk/items/…). Any Vinted country site works. Seller profile pages are never scraped.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "condition": { "title": "Condition", "type": "array", "description": "Only items in these conditions. Leave empty for any.", "items": { "type": "string", "enum": [ "new-with-tags", "new-without-tags", "very-good", "good", "satisfactory" ], "enumTitles": [ "New with tags", "New without tags", "Very good", "Good", "Satisfactory" ] } }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest item price, in the site's currency (USD on vinted.com, GBP on vinted.co.uk, EUR on most EU sites)." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest item price, in the site's currency." }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "newest", "price-low", "price-high" ], "type": "string", "description": "Order of the results, as on Vinted. Newest first is the one to use for monitoring new listings.", "default": "relevance" }, "includePromoted": { "title": "Include promoted listings", "type": "boolean", "description": "Vinted mixes promoted (\"bumped\") listings into the results. Turn off to leave them out; they are not charged.", "default": true }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Apify Proxy (datacenter) is the default and comes with every Apify plan. If Vinted refuses datacenter IPs for a while, the run switches to residential proxies when your account has them (within the run's price).", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Item pages in parallel", "minimum": 1, "maximum": 4, "type": "integer", "description": "How many item pages to read at the same time with \"Include item details\" (1–4). Requests to Vinted are spaced to about one per second either way.", "default": 2 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }