{ "openapi": "3.0.1", "info": { "title": "Vinted Scraper & New Listing Monitor", "description": "Monitor multiple Vinted searches across countries and return only listings discovered since the previous successful run.", "version": "0.1", "x-build-id": "mShpUdL6CjEn8uAmR" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trovevault~vinted-scraper-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trovevault-vinted-scraper-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/trovevault~vinted-scraper-monitor/runs": { "post": { "operationId": "runs-sync-trovevault-vinted-scraper-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/trovevault~vinted-scraper-monitor/run-sync": { "post": { "operationId": "run-sync-trovevault-vinted-scraper-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", "properties": { "mode": { "title": "Run mode", "enum": [ "scrape_current", "monitor_new" ], "type": "string", "description": "Scrape current listings on every run, or keep a private baseline and return only newly discovered listings on later runs.", "default": "scrape_current" }, "searchTerms": { "title": "Search terms", "type": "array", "description": "Keywords to scrape or monitor, such as a brand, model, or product description. Every term is checked in every selected country.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Vinted markets in which every search term should run. Select several countries to search across markets.", "items": { "type": "string", "enum": [ "fr", "de", "pt", "es", "it", "nl", "uk", "us", "be", "lu", "at", "pl", "cz", "sk", "lt", "lv", "ee", "se", "dk", "fi", "hu", "ro", "hr", "gr", "ie", "si" ], "enumTitles": [ "France", "Germany", "Portugal", "Spain", "Italy", "Netherlands", "United Kingdom", "United States", "Belgium", "Luxembourg", "Austria", "Poland", "Czechia", "Slovakia", "Lithuania", "Latvia", "Estonia", "Sweden", "Denmark", "Finland", "Hungary", "Romania", "Croatia", "Greece", "Ireland", "Slovenia" ] }, "default": [ "fr" ] }, "searchUrls": { "title": "Filtered Vinted search URLs (optional)", "type": "array", "description": "Complete Vinted catalog URLs to scrape or monitor when you need filters such as brand, category, size, color, or condition. Create the search in Vinted, copy its URL, and paste it here.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "minPrice": { "title": "Minimum price (optional)", "minimum": 0, "type": "number", "description": "Exclude listings below this price for keyword-based searches. Currency follows the selected country." }, "maxPrice": { "title": "Maximum price (optional)", "minimum": 0, "type": "number", "description": "Exclude listings above this price for keyword-based searches. Currency follows the selected country." }, "maxResultsPerSearch": { "title": "Listings per search", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of the newest listings returned or checked for each term-country or pasted URL. Higher values increase coverage, requests, and cost.", "default": 96 }, "firstRunMode": { "title": "First run behavior", "enum": [ "return_current", "establish_baseline" ], "type": "string", "description": "Choose whether a search returns its current listings on the first run or stores them silently as the initial baseline. Later runs always return only newly discovered listings.", "default": "return_current" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional Apify Proxy settings. Start without a proxy; enable residential access if a selected Vinted market blocks cloud requests." }, "datasetId": { "title": "Dataset ID (optional)", "type": "string", "description": "Append output rows to an existing Apify dataset in addition to the default run dataset." }, "runId": { "title": "Run ID (optional)", "type": "string", "description": "Workflow, campaign, or external job identifier copied into every output row." } } }, "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 } } } } } } } } } }