{ "openapi": "3.0.1", "info": { "title": "Vinted Scraper - Listings, Prices, Brands & Sizes", "description": "Scrape Vinted listings by keyword or search URL across 11 marketplaces including the UK, France, Austria and the US. Get price, brand, size, condition, favourites and photos in each market's own currency. Track mode compares scheduled runs and flags new listings and price drops.", "version": "1.0", "x-build-id": "m61rtMxTlxSFPLO8z" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/webdatalabs~vinted-scraper-pro/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-webdatalabs-vinted-scraper-pro", "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/webdatalabs~vinted-scraper-pro/runs": { "post": { "operationId": "runs-sync-webdatalabs-vinted-scraper-pro", "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/webdatalabs~vinted-scraper-pro/run-sync": { "post": { "operationId": "run-sync-webdatalabs-vinted-scraper-pro", "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", "required": [ "query" ], "properties": { "query": { "title": "Search or paste Vinted URL", "type": "array", "description": "One or more of: a keyword (e.g. 'nike air max'), or a full Vinted search URL (filter on Vinted's site, then copy the URL — brand/size/price filters carry over, no IDs to look up). Add several to scrape them all.", "default": [], "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Which Vinted country marketplaces to search. A keyword is searched in every selected country (more countries = more results, and lets you compare prices across markets). Ignored for pasted URLs (the URL already points at a country).", "items": { "type": "string", "enum": [ "de", "fr", "nl", "it", "es", "co.uk", "pl", "be", "at", "pt", "cz", "sk", "hu", "ro", "lt", "lu", "com" ], "enumTitles": [ "Germany", "France", "Netherlands", "Italy", "Spain", "United Kingdom", "Poland", "Belgium", "Austria", "Portugal", "Czechia", "Slovakia", "Hungary", "Romania", "Lithuania", "Luxembourg", "USA / International" ] }, "default": [ "de" ] }, "mode": { "title": "Mode", "enum": [ "search", "track" ], "type": "string", "description": "Search = get current matching listings. Track changes = compare against the previous run of the same query and flag NEW listings and PRICE DROPS / RISES, with first-seen and last-seen dates. Track changes only makes sense on a schedule (e.g. daily); run it once to set a baseline, then let it run. Note: Vinted publishes no sold data, and its search is not deterministic, so listings that stop appearing are not reported as sold.", "default": "search" }, "maxItems": { "title": "Max listings per query", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum listings to return per query (per country). Start small (100) to keep test runs cheap; raise for production.", "default": 100 }, "priceFrom": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only listings at or above this price (local currency). Applies to keyword searches; ignored for pasted URLs." }, "priceTo": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only listings at or below this price (local currency). Applies to keyword searches." }, "condition": { "title": "Condition", "type": "array", "description": "Filter keyword searches by item condition. Leave empty for all conditions.", "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" ] }, "default": [] }, "sort": { "title": "Sort order", "enum": [ "relevance", "newest_first", "price_low_to_high", "price_high_to_low" ], "type": "string", "description": "Sort order for keyword searches.", "default": "relevance" }, "useApifyProxy": { "title": "Use Apify residential proxy", "type": "boolean", "description": "Required. Vinted blocks datacenter IPs immediately; this actor uses residential proxies to work reliably. Only disable for debugging.", "default": true } } }, "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 } } }, "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 } } } } } } } } } }