{ "openapi": "3.0.1", "info": { "title": "Vinted Scraper – Second-Hand Fashion Listings", "description": "$1.5/1K 🔥 #1 Vinted scraper! Second-hand fashion — title, price, brand, size, condition, seller & photos. No proxy needed. JSON, CSV, Excel or API in seconds. Paste a search URL & pull thousands of listings for resale & pricing ⚡", "version": "1.0", "x-build-id": "XiM18a7zlLc87UO1g" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ninhothedev~vinted-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ninhothedev-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/ninhothedev~vinted-scraper/runs": { "post": { "operationId": "runs-sync-ninhothedev-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/ninhothedev~vinted-scraper/run-sync": { "post": { "operationId": "run-sync-ninhothedev-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": { "searchUrls": { "title": "Vinted catalog URLs", "type": "array", "description": "One or more Vinted catalog URLs (any country), e.g. https://www.vinted.de/catalog?search_text=nike. Open vinted.de (or .fr/.com/.co.uk/...), set your filters, and copy the URL. If empty, the filters below are used.", "default": [], "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "de", "fr", "com", "gb", "it", "es", "nl", "be", "pl", "at", "lt", "cz", "sk", "pt", "se" ], "type": "string", "description": "Vinted country site to search (used only when no Search URLs are given).", "default": "de" }, "searchText": { "title": "Search text", "type": "string", "description": "Keywords, e.g. 'nike air max' or 'levi 501'." }, "priceFrom": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Minimum price in the site currency." }, "priceTo": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Maximum price in the site currency." }, "currency": { "title": "Currency", "enum": [ "EUR", "GBP", "PLN", "CZK", "SEK" ], "type": "string", "description": "Currency for the price filter and output.", "default": "EUR" }, "order": { "title": "Sort order", "enum": [ "newest", "relevance", "price_low_to_high", "price_high_to_low" ], "type": "string", "description": "How to sort the catalog.", "default": "newest" }, "catalogIds": { "title": "Category IDs", "type": "array", "description": "Vinted category (catalog) IDs to restrict to. Find them in a catalog URL (catalog[]=...). Advanced.", "default": [], "items": { "type": "string" } }, "brandIds": { "title": "Brand IDs", "type": "array", "description": "Vinted brand IDs (from a catalog URL, brand_ids[]=...). Advanced.", "default": [], "items": { "type": "string" } }, "sizeIds": { "title": "Size IDs", "type": "array", "description": "Vinted size IDs (from a catalog URL, size_ids[]=...). Advanced.", "default": [], "items": { "type": "string" } }, "maxItemsPerSearch": { "title": "Max results per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap the items scraped per search (controls cost & runtime).", "default": 200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy settings, applied to BOTH HTTP transports (curl_cffi and the plain urllib fallback). Vinted answers HTTP 403 to most Apify datacenter IPs, so enabling Apify Proxy (RESIDENTIAL group recommended) is strongly advised. Left OFF by default so the actor never fails just because a scoped run token cannot fetch the proxy password." } } }, "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 } } } } } } } } } }