{ "openapi": "3.0.1", "info": { "title": "Vinted Search Scraper + New Listing Monitor", "description": "Search Vinted listings on any Vinted domain (UK, DE, FR, US…) with price filters and sorting — or run in monitor mode to get only listings posted since your last run. Perfect for deal alerts, resale arbitrage, and price research.", "version": "0.1", "x-build-id": "sk0YqqCyZk6SH3ENA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mojocakes~vinted-search-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mojocakes-vinted-search-monitor", "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/mojocakes~vinted-search-monitor/runs": { "post": { "operationId": "runs-sync-mojocakes-vinted-search-monitor", "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/mojocakes~vinted-search-monitor/run-sync": { "post": { "operationId": "run-sync-mojocakes-vinted-search-monitor", "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": [ "searchQueries" ], "properties": { "searchQueries": { "title": "Search queries", "type": "array", "description": "One or more search terms, exactly as you would type them into Vinted search (e.g. `north face puffer`, `levi 501 W32`).", "items": { "type": "string" } }, "domain": { "title": "Vinted domain", "enum": [ "www.vinted.co.uk", "www.vinted.com", "www.vinted.de", "www.vinted.fr", "www.vinted.it", "www.vinted.es", "www.vinted.nl", "www.vinted.pl", "www.vinted.be", "www.vinted.pt", "www.vinted.at", "www.vinted.lt", "www.vinted.cz", "www.vinted.sk", "www.vinted.se", "www.vinted.ro", "www.vinted.hu", "www.vinted.dk", "www.vinted.fi", "www.vinted.gr", "www.vinted.hr", "www.vinted.ie", "www.vinted.lu" ], "type": "string", "description": "Which Vinted site to search. Determines country, language and currency.", "default": "www.vinted.co.uk" }, "maxItemsPerQuery": { "title": "Max items per query", "minimum": 1, "type": "integer", "description": "Upper limit of listings to return per search query in this run.", "default": 96 }, "order": { "title": "Sort order", "enum": [ "newest_first", "relevance", "price_low_to_high", "price_high_to_low" ], "type": "string", "description": "How Vinted sorts the results. Monitor mode always uses `newest_first`.", "default": "newest_first" }, "priceFrom": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Only listings priced at or above this amount (in the domain's currency). Leave empty for no minimum." }, "priceTo": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Only listings priced at or below this amount (in the domain's currency). Leave empty for no maximum." }, "monitorMode": { "title": "Monitor mode (only new listings since last run)", "type": "boolean", "description": "When enabled, the actor remembers the newest listing it has seen per query (per Task) and outputs only listings posted after that. Schedule it every 10–60 minutes for deal alerts on saved searches. The first run sets the baseline.", "default": false }, "includeSellerInfo": { "title": "Include basic seller info", "type": "boolean", "description": "Include the seller's public login name and profile URL with each listing. Off by default.", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Proxy settings. Residential proxy is strongly recommended — Vinted blocks most datacenter IP ranges.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }