{ "openapi": "3.0.1", "info": { "title": "Vinted Scraper API – Cheapest Cross-Country Listings & Sellers", "description": "Scrape Vinted listings, prices, sellers and photos across 20+ countries. Search by keyword or paste a Vinted URL, filter by brand, size, condition and price, and get clean exportable data.", "version": "1.0", "x-build-id": "c5Axb4NHEgX2xgzxK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/lofomachines~vinted-scraper-api/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-lofomachines-vinted-scraper-api", "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/lofomachines~vinted-scraper-api/runs": { "post": { "operationId": "runs-sync-lofomachines-vinted-scraper-api", "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/lofomachines~vinted-scraper-api/run-sync": { "post": { "operationId": "run-sync-lofomachines-vinted-scraper-api", "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 keywords", "type": "array", "description": "What do you want to find on Vinted? Add one or more keywords, e.g. \"nike air max\", \"ralph lauren shirt\", \"prada bag\". Leave empty if you are pasting Vinted URLs below instead.", "items": { "type": "string" } }, "searchUrls": { "title": "Vinted search URLs (optional)", "type": "array", "description": "Already built a filtered search on Vinted? Just copy the address bar URL and paste it here. The scraper keeps all of your filters. You can mix and match URLs from different countries.", "items": { "type": "string" } }, "countries": { "title": "Marketplaces (countries)", "type": "array", "description": "Which Vinted country markets should be searched? Pick one or several. Only applies to keyword searches – pasted URLs always use their own country.", "items": { "type": "string", "enum": [ "fr", "de", "it", "es", "uk", "us", "nl", "be", "at", "lu", "pl", "cz", "sk", "lt", "pt", "se", "ro", "hu", "hr", "gr", "dk", "fi", "ie" ], "enumTitles": [ "France (vinted.fr)", "Germany (vinted.de)", "Italy (vinted.it)", "Spain (vinted.es)", "United Kingdom (vinted.co.uk)", "United States (vinted.com)", "Netherlands (vinted.nl)", "Belgium (vinted.be)", "Austria (vinted.at)", "Luxembourg (vinted.lu)", "Poland (vinted.pl)", "Czechia (vinted.cz)", "Slovakia (vinted.sk)", "Lithuania (vinted.lt)", "Portugal (vinted.pt)", "Sweden (vinted.se)", "Romania (vinted.ro)", "Hungary (vinted.hu)", "Croatia (vinted.hr)", "Greece (vinted.gr)", "Denmark (vinted.dk)", "Finland (vinted.fi)", "Ireland (vinted.ie)" ] }, "default": [ "fr" ] }, "maxItems": { "title": "Maximum items (per keyword & per country)", "minimum": 100, "maximum": 100000, "type": "integer", "description": "How many listings to collect for EACH keyword in EACH selected country. Example: 100 with 2 keywords and 2 countries can return up to 100 × 2 × 2 = 400 listings. Each pasted URL also returns up to this many. Keep it lower for quick tests.", "default": 10 }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "newest", "price_low_to_high", "price_high_to_low" ], "type": "string", "description": "How Vinted should order the listings before they are collected.", "default": "relevance" }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Only keep listings priced at or above this amount (in the marketplace currency). Leave empty for no minimum." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Only keep listings priced at or below this amount (in the marketplace currency). Leave empty for no maximum." }, "condition": { "title": "Item condition", "type": "array", "description": "Filter by the condition sellers selected. Leave empty to include every condition.", "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" ] } }, "includeSellerDetails": { "title": "Include seller details", "type": "boolean", "description": "Add each seller's full profile (username, ratings, reviews count, reputation, location, follower count and more) to every listing. Recommended for sourcing and lead generation.", "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 } } } } } } } } } }