{ "openapi": "3.0.1", "info": { "title": "Vinted Scraper", "description": "Scrape Vinted listings from any country site by keyword, category, brand, size, condition, color and price, or from search, item and member links. Get prices with fees, photos, favourites, seller ratings and whole closets.", "version": "0.1", "x-build-id": "EUinwqCbfE0DN4yiS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automly~vinted-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automly-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/automly~vinted-scraper/runs": { "post": { "operationId": "runs-sync-automly-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/automly~vinted-scraper/run-sync": { "post": { "operationId": "run-sync-automly-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": { "search": { "title": "Search terms", "type": "array", "description": "What to search Vinted for, one search per line, e.g. nike air max, levis 501, zara dress. Each search uses the country and filters below. Leave empty to use only links, members or filters.", "items": { "type": "string" } }, "country": { "title": "Country", "enum": [ "fr", "de", "uk", "us", "it", "es", "pl", "nl", "be", "lt", "cz", "at", "lu", "pt", "se", "dk", "fi", "sk", "hu", "ro", "hr", "gr", "ie", "si", "ee", "lv" ], "type": "string", "description": "Which Vinted country site to search, e.g. fr for vinted.fr or uk for vinted.co.uk. Prices come in that site's currency (EUR, GBP, USD, PLN, CZK, SEK, DKK, HUF, RON). Pasted links keep their own country.", "default": "fr" }, "startUrls": { "title": "Vinted links", "type": "array", "description": "Paste Vinted links from any country site in any mix, e.g. a search or category page with the filters you set on the site (vinted.fr/catalog?search_text=nike&brand_ids[]=53), an item page (vinted.de/items/...) or a member's profile (vinted.co.uk/member/...) for their whole closet.", "items": { "type": "string" } }, "members": { "title": "Members (closets)", "type": "array", "description": "Vinted member profile links or member numbers whose closet (every item for sale) you want, e.g. https://www.vinted.fr/member/73050930-crosstraining or 73050930. Numbers use the country above.", "items": { "type": "string" } }, "maxItems": { "title": "Max items per search, link or member", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "How many items to save for each search, link or member, e.g. 100. Set 0 for every matching item.", "default": 100 }, "includeDetails": { "title": "Include full item details", "type": "boolean", "description": "Adds each item's description, every photo, color, category, shipping price, availability (sold or reserved) and the seller's rating, reviews, items for sale, followers and country. Slower and priced per detailed item; leave off for the listing fields only.", "default": false }, "sortBy": { "title": "Sort by", "enum": [ "relevance", "newest_first", "price_low_to_high", "price_high_to_low" ], "type": "string", "description": "Order in which items are collected, e.g. newest_first for the latest listings.", "default": "relevance" }, "categories": { "title": "Categories", "type": "array", "description": "Vinted category numbers or category links, e.g. 1904 (Women) or https://www.vinted.fr/catalog/525-leggings.", "items": { "type": "string" } }, "brands": { "title": "Brands", "type": "array", "description": "Brand names exactly as Vinted spells them, or brand numbers, e.g. Nike, Zara, Levi's or 53.", "items": { "type": "string" } }, "sizeIds": { "title": "Size numbers", "type": "array", "description": "Vinted size numbers, e.g. 207 (women's M). Copy them from a Vinted search link where you picked the size (size_ids[]=207).", "items": { "type": "string" } }, "conditions": { "title": "Condition", "type": "array", "description": "Only items in these conditions, e.g. new_with_tags and very_good.", "items": { "type": "string", "enum": [ "new_with_tags", "new_without_tags", "very_good", "good", "satisfactory", "not_fully_functional" ], "enumTitles": [ "New with tags", "New without tags", "Very good", "Good", "Satisfactory", "Not fully functional" ] } }, "colors": { "title": "Colors", "type": "array", "description": "Only items in these colors, e.g. black and white.", "items": { "type": "string", "enum": [ "black", "grey", "white", "cream", "beige", "apricot", "orange", "coral", "red", "burgundy", "pink", "rose", "purple", "lilac", "light_blue", "blue", "navy", "turquoise", "mint", "green", "dark_green", "khaki", "brown", "mustard", "yellow", "silver", "gold", "multicolour", "clear" ], "enumTitles": [ "Black", "Grey", "White", "Cream", "Beige", "Apricot", "Orange", "Coral", "Red", "Burgundy", "Pink", "Rose", "Purple", "Lilac", "Light blue", "Blue", "Navy", "Turquoise", "Mint", "Green", "Dark green", "Khaki", "Brown", "Mustard", "Yellow", "Silver", "Gold", "Multicolour", "Clear" ] } }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Lowest item price in the country's currency, e.g. 10." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Highest item price in the country's currency, e.g. 50." }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Leave the default. Change only if you know you need a specific proxy.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }