{ "openapi": "3.0.1", "info": { "title": "Vinted Demand & Sell-Through Scraper", "description": "Vinted demand intelligence: sell-through rate, realised sale prices, days-to-sell, and cross-market sourcing. No proxy, no PII.", "version": "0.0", "x-build-id": "glqhB6h8vxXGuOW2K" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~vinted-arbitrage-scanner/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-vinted-arbitrage-scanner", "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/unfenced-group~vinted-arbitrage-scanner/runs": { "post": { "operationId": "runs-sync-unfenced-group-vinted-arbitrage-scanner", "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/unfenced-group~vinted-arbitrage-scanner/run-sync": { "post": { "operationId": "run-sync-unfenced-group-vinted-arbitrage-scanner", "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": { "searchQuery": { "title": "🔍 Search query", "type": "string", "description": "Product, brand, or model to scan across markets (e.g. 'nike air force 1', 'ralph lauren jumper')." }, "countries": { "title": "🌍 Markets to compare", "type": "array", "description": "Vinted markets to scan. Pick 2-5 for a focused arbitrage scan. All listings are normalised to one currency for comparison.", "items": { "type": "string", "enum": [ "fr", "de", "uk", "it", "es", "nl", "pl", "pt", "be", "at", "lt", "cz", "sk", "hu", "ro", "hr", "fi", "dk", "se", "ee", "gr", "ie", "lu", "lv", "si", "us" ], "enumTitles": [ "France", "Germany", "United Kingdom", "Italy", "Spain", "Netherlands", "Poland", "Portugal", "Belgium", "Austria", "Lithuania", "Czech Republic", "Slovakia", "Hungary", "Romania", "Croatia", "Finland", "Denmark", "Sweden", "Estonia", "Greece", "Ireland", "Luxembourg", "Latvia", "Slovenia", "United States" ] }, "default": [ "fr", "de", "nl", "it", "es" ] }, "maxResults": { "title": "📊 Max results (total)", "minimum": 1, "type": "integer", "description": "Total listings to return across all markets (split evenly). Vinted caps each query at ~960 per market.", "default": 100 }, "baseCurrency": { "title": "💱 Comparison currency", "enum": [ "EUR", "GBP", "USD", "PLN", "CZK", "SEK", "DKK", "HUF", "RON" ], "type": "string", "description": "Currency all markets are converted to for price-gap comparison. Live ECB rates.", "default": "EUR" }, "sortBy": { "title": "📈 Sort by", "enum": [ "relevance", "price_low_to_high", "price_high_to_low", "newest_first" ], "type": "string", "description": "How listings are ordered within each market.", "default": "relevance" }, "priceMin": { "title": "💶 Min price (local currency)", "type": "integer", "description": "Minimum listing price in each market's local currency. Leave empty for no minimum." }, "priceMax": { "title": "💶 Max price (local currency)", "type": "integer", "description": "Maximum listing price in each market's local currency. Leave empty for no maximum." }, "condition": { "title": "✨ Condition filter", "type": "array", "description": "Filter by item condition. Leave empty to include all conditions.", "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" ] } }, "brandNames": { "title": "🏷️ Brand names", "type": "array", "description": "Filter by brand — just type the names (e.g. 'Nike', 'Stone Island'). The actor looks up each brand's ID automatically. Leave empty for all brands.", "items": { "type": "string" } }, "brandIds": { "title": "🏷️ Brand IDs (advanced)", "type": "array", "description": "Advanced: filter by raw Vinted brand ID if you already know it. Most users should use Brand names above instead.", "items": { "type": "string" } }, "sizeIds": { "title": "📏 Size IDs (advanced)", "type": "array", "description": "Advanced: filter by raw Vinted size ID for categories not covered by the dropdowns below. Find it in the URL after selecting a size filter. Leave empty for all sizes.", "items": { "type": "string" } }, "clothingSizes": { "title": "👕 Clothing size", "type": "array", "description": "Filter by clothing size (XS–XXXL). For shoes, use the shoe size filter below. Leave empty for all sizes.", "items": { "type": "string", "enum": [ "xs", "s", "m", "l", "xl", "xxl", "xxxl" ], "enumTitles": [ "XS", "S", "M", "L", "XL", "XXL", "XXXL" ] } }, "shoeSizes": { "title": "👟 Shoe size (EU)", "type": "array", "description": "Filter by EU shoe size (38–47.5). For clothing, use the clothing size filter above. Leave empty for all sizes.", "items": { "type": "string", "enum": [ "38", "38.5", "39", "39.5", "40", "40.5", "41", "41.5", "42", "42.5", "43", "43.5", "44", "44.5", "45", "45.5", "46", "46.5", "47", "47.5" ], "enumTitles": [ "38", "38.5", "39", "39.5", "40", "40.5", "41", "41.5", "42", "42.5", "43", "43.5", "44", "44.5", "45", "45.5", "46", "46.5", "47", "47.5" ] } }, "kidsSizes": { "title": "🧒 Kids size (age / cm)", "type": "array", "description": "Filter by kids clothing size (age / cm, e.g. '6 yr / 116 cm'). Covers newborn to 16 years. Leave empty for all sizes.", "items": { "type": "string", "enum": [ "newborn_50", "1_3m_56", "3_6m_62", "6_9m_68", "9_12m_74", "12_18m_80", "18_24m_86", "2_3y_92", "3y_98", "4y_104", "5y_110", "6y_116", "7y_122", "8y_128", "9y_134", "10y_140", "11y_146", "12y_152", "13y_158", "14y_164", "15y_170", "16y_176" ], "enumTitles": [ "Up to 1m / 50 cm", "1-3m / 56 cm", "3-6m / 62 cm", "6-9m / 68 cm", "9-12m / 74 cm", "12-18m / 80 cm", "18-24m / 86 cm", "2-3y / 92 cm", "3y / 98 cm", "4y / 104 cm", "5y / 110 cm", "6y / 116 cm", "7y / 122 cm", "8y / 128 cm", "9y / 134 cm", "10y / 140 cm", "11y / 146 cm", "12y / 152 cm", "13y / 158 cm", "14y / 164 cm", "15y / 170 cm", "16y / 176 cm" ] } }, "colors": { "title": "🎨 Colour filter", "type": "array", "description": "Filter listings by colour. Leave empty for all colours. Note: Vinted does not return a colour value per listing, so this narrows the scan but does not add a colour output field.", "items": { "type": "string", "enum": [ "black", "white", "grey", "beige", "brown", "red", "blue", "navy", "green", "yellow", "pink", "purple", "orange", "multi" ], "enumTitles": [ "Black", "White", "Grey", "Beige", "Brown", "Red", "Blue", "Navy", "Green", "Yellow", "Pink", "Purple", "Orange", "Multicolour" ] } }, "gender": { "title": "🚻 Department", "enum": [ "all", "women", "men", "kids", "home", "electronics", "video_games", "books", "beauty", "jewellery", "sports", "phone_accessories", "bags" ], "type": "string", "description": "Filter by department. Vinted sells far more than clothing — pick Home, Electronics, Video Games, Books & Media, Beauty, Jewellery, Sports, or Bags for non-fashion categories. Leave as 'All' to search everything. Note: if you pick a specific Category below, that takes precedence over this.", "default": "all" }, "category": { "title": "📂 Category", "enum": [ "all", "shoes", "coats_jackets", "dresses", "bags", "mens_jeans" ], "type": "string", "description": "Filter by product category. These are the verified cross-department categories. For any other category, use the advanced Category ID field below. If set, this overrides the Department filter.", "default": "all" }, "categoryId": { "title": "📁 Category ID (advanced)", "type": "integer", "description": "Advanced: filter by a specific Vinted catalog ID not covered by the Category dropdown. Find it in the catalog URL (catalog[]=NUMBER). Overrides Department and Category if set." }, "includeListings": { "title": "📦 Output individual listings", "type": "boolean", "description": "Output every matching listing row. Disable to get only the cross-country arbitrage summary (cheaper).", "default": true }, "dedupeAcrossMarkets": { "title": "🔁 Remove cross-market duplicates", "type": "boolean", "description": "Vinted shows the same listing in every market it ships to. With this on, each item appears once, with a 'markets' field listing every market it was found in. Turn off to get one row per market.", "default": true }, "fetchDetails": { "title": "🔬 Fetch full item details (premium)", "type": "boolean", "description": "Fetch each listing's page for the seller's description, declared colour, and full category path — data not in the fast search API. This makes runs slower and is billed at a higher per-result rate. Leave off for fast, cheap catalog data.", "default": false }, "sellThroughTracking": { "title": "📈 Sell-through tracking mode", "type": "boolean", "description": "Measure real demand. Run this on a schedule (e.g. daily): the actor snapshots live listings and flags items that disappear as 'likely sold', giving you a sell-through rate and median days-to-sell for your niche. Overrides the normal scan output.", "default": false }, "trackerName": { "title": "🏷️ Tracker name", "type": "string", "description": "A stable name for this sell-through tracker (e.g. 'nike-af1-kids'). Reuse the same name across scheduled runs so history accumulates. Leave empty to auto-generate from the search query." }, "missingRunsBeforeSold": { "title": "📉 Missing runs before 'likely sold'", "minimum": 1, "type": "integer", "description": "How many consecutive runs an item must be absent before it's marked likely sold. Use 2 to avoid false positives from search-ranking shuffle.", "default": 2 }, "emitActiveItems": { "title": "📤 Output still-active items too", "type": "boolean", "description": "In sell-through mode, also output items that are still listed (with days-listed and any price drop). Disable to output only newly-sold items and the summary (cheaper).", "default": true }, "minSellThroughAlertPct": { "title": "🔔 Minimum sell-through % to alert", "type": "integer", "description": "In sell-through mode, only send a webhook alert when the sell-through rate is at least this percentage. Leave empty to always alert. Pairs with the Telegram/Discord/Slack fields below." }, "includeArbitrageSummary": { "title": "📊 Output arbitrage summary", "type": "boolean", "description": "Add one summary row comparing median/min/max prices across markets and naming the buy-low / sell-high pair.", "default": true }, "telegramBotToken": { "title": "📨 Telegram bot token", "type": "string", "description": "Optional. Send each run's arbitrage alert to Telegram. Create a bot with @BotFather and paste its token here. Also fill in the chat ID below." }, "telegramChatId": { "title": "📨 Telegram chat ID", "type": "string", "description": "Optional. The chat or channel ID to send Telegram alerts to (e.g. your user ID, or -100... for a channel). Required if a bot token is set." }, "discordWebhookUrl": { "title": "📨 Discord webhook URL", "type": "string", "description": "Optional. Send each run's arbitrage alert to a Discord channel. Paste an Incoming Webhook URL (Server Settings → Integrations → Webhooks)." }, "slackWebhookUrl": { "title": "📨 Slack webhook URL", "type": "string", "description": "Optional. Send each run's arbitrage alert to a Slack channel. Paste an Incoming Webhook URL (api.slack.com/messaging/webhooks)." }, "minSpreadPctAlert": { "title": "🔔 Minimum spread % to alert", "type": "integer", "description": "Only send alerts when the cross-country median spread is at least this percentage. Leave empty to always alert. Useful for scheduled runs that should only ping you on real opportunities." }, "alertTopListings": { "title": "🔔 Listings per alert", "minimum": 1, "type": "integer", "description": "How many of the cheapest listings to include in each alert message.", "default": 5 } } }, "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 } } } } } } } } } }