{ "openapi": "3.0.1", "info": { "title": "Vinted Scraper | From $0.75/1k 💙", "description": "Monitor and extract product listings, prices, photos & seller data from Vinted search results and catalogs. Fast, reliable API for market research, price monitoring & inventory tracking. AI agent friendly.", "version": "2.0", "x-build-id": "Bt42meKkyIfhQXxjy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/epicscrapers~vinted-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-epicscrapers-vinted-search-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/epicscrapers~vinted-search-scraper/runs": { "post": { "operationId": "runs-sync-epicscrapers-vinted-search-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/epicscrapers~vinted-search-scraper/run-sync": { "post": { "operationId": "run-sync-epicscrapers-vinted-search-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": { "startUrls": { "title": "Vinted URLs", "type": "array", "description": "Add Vinted search or catalog URLs, with any Vinted filters, or seller profile URLs (/member/...) to get all of a seller's active listings. Single item URLs (/items/...) are not supported and are skipped. Country and price options from the keyword section do not apply to these URLs.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "keywords": { "title": "Keywords", "minItems": 1, "uniqueItems": true, "type": "array", "description": "Enter one or more keywords. Each keyword runs as a separate Vinted search.", "items": { "type": "string", "minLength": 1 } }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Enter the lowest listing price in the main country's currency. Other countries use the converted amount. Leave empty for no minimum." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Enter the highest listing price in the main country's currency. Other countries use the converted amount. Leave empty for no maximum." }, "country": { "title": "Main country", "enum": [ "at", "be", "hr", "cz", "dk", "ee", "fi", "fr", "de", "gr", "hu", "ie", "it", "lv", "lt", "lu", "nl", "pl", "pt", "ro", "sk", "si", "es", "se", "gb", "us" ], "type": "string", "description": "Select the main Vinted country site used for keyword searches. Price filters use this country's currency.", "default": "it" }, "compareCountries": { "title": "Also search in", "uniqueItems": true, "type": "array", "description": "Select more Vinted countries to run every keyword search in. The run saves a price summary that compares median prices across countries, converted to EUR.", "items": { "type": "string", "enum": [ "at", "be", "hr", "cz", "dk", "ee", "fi", "fr", "de", "gr", "hu", "ie", "it", "lv", "lt", "lu", "nl", "pl", "pt", "ro", "sk", "si", "es", "se", "gb", "us" ], "enumTitles": [ "🇦🇹 Austria", "🇧🇪 Belgium", "🇭🇷 Croatia", "🇨🇿 Czechia", "🇩🇰 Denmark", "🇪🇪 Estonia", "🇫🇮 Finland", "🇫🇷 France", "🇩🇪 Germany", "🇬🇷 Greece", "🇭🇺 Hungary", "🇮🇪 Ireland", "🇮🇹 Italy", "🇱🇻 Latvia", "🇱🇹 Lithuania", "🇱🇺 Luxembourg", "🇳🇱 Netherlands", "🇵🇱 Poland", "🇵🇹 Portugal", "🇷🇴 Romania", "🇸🇰 Slovakia", "🇸🇮 Slovenia", "🇪🇸 Spain", "🇸🇪 Sweden", "🇬🇧 United Kingdom", "🇺🇸 United States" ] } }, "maxProducts": { "title": "Products per search", "minimum": 0, "type": "integer", "description": "Set the maximum products evaluated for each URL or keyword. Enter 0 for no limit. Vinted returns at most 960 results per search, so for larger limits the Actor splits the search into price ranges (and conditions) and collects them one by one. Every listing is charged, so set a maximum cost per run for large searches.", "default": 20 }, "trackPriceChanges": { "title": "Track new listings and price drops", "type": "boolean", "description": "Compare every listing with earlier runs of the same search. Saved listings include the previous price, the price change, and whether the listing is new.", "default": false }, "saveOnly": { "title": "Save only", "enum": [ "all", "new", "priceDrops", "newOrPriceDrops" ], "type": "string", "description": "Choose which listings to save. Any option other than all listings turns on price tracking. The first run for a search saves all listings as a baseline. Later runs save only listings that are new or cheaper since the previous run.", "default": "all" } } }, "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 } } } } } } } } } }