{ "openapi": "3.0.1", "info": { "title": "Vinted Scraper: New Listings, Prices & Deal Alerts", "description": "Get Vinted listings for searches such as Nike trainers or vintage denim, with price, size, condition, seller ratings and photos. Track new listings and price drops across countries with sampled deal scores. $0.0015 per listing; 100 cost $0.15. Details optional. No login.", "version": "1.0", "x-build-id": "UCfmJuiS3PVyVH5xf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/moggedhq~vinted-scraper-alerts/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-moggedhq-vinted-scraper-alerts", "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/moggedhq~vinted-scraper-alerts/runs": { "post": { "operationId": "runs-sync-moggedhq-vinted-scraper-alerts", "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/moggedhq~vinted-scraper-alerts/run-sync": { "post": { "operationId": "run-sync-moggedhq-vinted-scraper-alerts", "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 terms", "type": "array", "description": "Searches such as nike trainers or vintage denim. Each term is searched in each country.", "items": { "type": "string" } }, "countries": { "title": "Countries", "type": "array", "description": "Site country codes: fr, de, gb, it, es, nl, be or pl. The site country is separate from the seller country.", "default": [ "fr" ], "items": { "type": "string" } }, "startUrls": { "title": "Catalog or item URLs", "type": "array", "description": "Optional HTTPS catalog, category or item links from a supported Vinted site. Existing numeric filters are preserved.", "items": { "type": "string" } }, "brands": { "title": "Brands", "type": "array", "description": "Exact public brand labels, such as Nike, or numeric Vinted brand IDs.", "items": { "type": "string" } }, "sizes": { "title": "Sizes", "type": "array", "description": "Exact displayed size labels, such as M, or numeric Vinted size IDs.", "items": { "type": "string" } }, "conditions": { "title": "Conditions", "type": "array", "description": "Exact displayed condition labels in the source language, or native numeric Vinted status IDs.", "items": { "type": "string" } }, "priceMin": { "title": "Minimum price", "minimum": 0, "type": "number", "description": "Asking price filter in the original site currency, before fees and shipping." }, "priceMax": { "title": "Maximum price", "minimum": 0, "type": "number", "description": "Asking price filter in the original site currency, before fees and shipping." }, "currency": { "title": "Comparison currency", "type": "string", "description": "Optional uppercase currency code such as EUR, GBP or USD. Original prices remain unchanged; converted values use daily ECB reference rates." }, "sort": { "title": "Sort order", "enum": [ "newest_first", "price_low_to_high", "price_high_to_low", "relevance" ], "type": "string", "description": "Newest first is the default. Promoted listings may be placed ahead of ordinary listings by the site.", "default": "newest_first" }, "maxItems": { "title": "Maximum listings", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum unique delivered listing rows across all searches and countries. Free summaries and notes do not count.", "default": 20 }, "includeDetails": { "title": "Full details and seller statistics", "type": "boolean", "description": "Slower. Add full description, colour, category, photos and public seller username, rating, review count and inventory when shown. Successful enrichment adds $0.0075 per listing; unavailable enrichment has no detail charge.", "default": false }, "onlyNewSinceLastRun": { "title": "Only new listings and price drops", "type": "boolean", "description": "Remember delivered IDs and prices in a named watch store. The first run delivers a baseline. Later runs deliver newly observed listings and lower prices. Run the same watch sequentially.", "default": false }, "watchId": { "title": "Watch ID", "type": "string", "description": "Stable name for an independent history, such as denim-fr. Changing it creates a new baseline. A lock prevents overlapping runs for one watch.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional custom Apify proxy configuration. By default try datacenter, direct cloud HTTP, then residential in the source country." } } }, "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 } } } } } } } } } }