{ "openapi": "3.0.1", "info": { "title": "Vinted Scraper - Listings, Prices & Brands in 25 Countries", "description": "Scrape Vinted listings by search text, category, brand, condition and price: price, brand, size, condition, favourites, photos and seller login. 25 country sites. Only-new mode for schedules. No login.", "version": "0.1", "x-build-id": "fEylf46JYdIOJt8ha" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/cliqtomedia~vinted-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-cliqtomedia-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/cliqtomedia~vinted-scraper/runs": { "post": { "operationId": "runs-sync-cliqtomedia-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/cliqtomedia~vinted-scraper/run-sync": { "post": { "operationId": "run-sync-cliqtomedia-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": { "country": { "title": "Country site", "enum": [ "fr", "de", "uk", "it", "es", "nl", "be", "at", "pl", "pt", "lu", "ie", "lt", "cz", "sk", "se", "fi", "dk", "ro", "hu", "hr", "gr", "ee", "lv", "si" ], "type": "string", "description": "Vinted site to search. Prices come in its currency, and size and condition in its language.", "default": "fr" }, "searchText": { "title": "Search text", "type": "string", "description": "Words as you would type them in the Vinted search box. Can be empty when you set a catalog or brand id." }, "maxItems": { "title": "Max listings", "minimum": 1, "maximum": 960, "type": "integer", "description": "Stop after this many saved listings. Each saved listing is one paid result. Vinted shows at most 960 listings for one search.", "default": 100 }, "order": { "title": "Sort", "enum": [ "newest", "relevance", "priceLowToHigh", "priceHighToLow" ], "type": "string", "description": "Order of results, as on the Vinted website.", "default": "newest" }, "onlyNew": { "title": "Only listings not seen in earlier runs", "type": "boolean", "description": "On = return only listings posted after the newest listing that earlier runs with the same country, search text and filters returned. The first run returns the latest listings and remembers them. Good for a schedule: you pay only for new listings.", "default": false }, "catalogIds": { "title": "Catalog (category) ids", "type": "array", "description": "Vinted category ids, as in catalog[]=1242 in a Vinted search link, up to 20. Empty = all categories.", "items": { "type": "string" } }, "brandIds": { "title": "Brand ids", "type": "array", "description": "Vinted brand ids, as in brand_ids[]=53 in a Vinted search link, up to 20. Empty = all brands.", "items": { "type": "string" } }, "conditions": { "title": "Condition", "type": "array", "description": "Keep only these conditions. Empty = any condition.", "items": { "type": "string", "enum": [ "new_with_tags", "new_without_tags", "very_good", "good", "satisfactory" ], "enumTitles": [ "New with tags", "New without tags", "Very good", "Good", "Satisfactory" ] } }, "priceFrom": { "title": "Min price", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Lowest item price in the site currency." }, "priceTo": { "title": "Max price", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Highest item price in the site currency." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave it off: the Actor connects directly and, if Vinted starts blocking, switches to a residential proxy on its own (included in the price). Data-center proxies are mostly blocked by Vinted.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } }