{ "openapi": "3.0.1", "info": { "title": "Vinted Underpriced Deals — Cheap and Wanted, in One Call", "description": "Which Vinted listings are cheap right now? Builds the asking-price distribution for your search on one country's site, scores every listing against it, and returns those below your percentile, ranked by favourite count. Promoted listings are kept out of the basis. A mixed search is refused.", "version": "0.1", "x-build-id": "kIbAPSoVt9It4a5so" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/jpmarketdata~vinted-underpriced-deals/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-jpmarketdata-vinted-underpriced-deals", "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/jpmarketdata~vinted-underpriced-deals/runs": { "post": { "operationId": "runs-sync-jpmarketdata-vinted-underpriced-deals", "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/jpmarketdata~vinted-underpriced-deals/run-sync": { "post": { "operationId": "run-sync-jpmarketdata-vinted-underpriced-deals", "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", "required": [ "keywords" ], "properties": { "keywords": { "title": "Search terms", "type": "array", "description": "What to search for, e.g. \"nike air max\". Each term gets its own price basis.", "items": { "type": "string" } }, "domain": { "title": "Country site", "enum": [ "com", "fr", "de", "co.uk", "es", "it", "nl", "pl" ], "type": "string", "description": "Which Vinted site to search. The domain decides both the market and the currency, so a basis is only ever built within one country.", "default": "fr" }, "dealPercentile": { "title": "Deal percentile", "minimum": 1, "maximum": 50, "type": "integer", "description": "A listing counts as a deal when its price sits at or below this percentile of the sampled asking prices. 20 means \"in the cheapest fifth of what is on offer\".", "default": 20 }, "maxListings": { "title": "Max listings to sample", "minimum": 50, "maximum": 960, "type": "integer", "description": "How many listings to sample for the basis and for scoring. Vinted stops counting and paging at 960 hits, so this cannot exceed that ceiling.", "default": 300 }, "minComps": { "title": "Min listings required", "minimum": 10, "maximum": 500, "type": "integer", "description": "Refuse to score a search with fewer sampled listings than this. A percentile built on a dozen prices is noise.", "default": 30 }, "maxCompSpread": { "title": "Max basis spread (p90 / p10)", "type": "string", "description": "Coherence ceiling for the basis, as the p90/p10 ratio. Measured on vinted.fr 2026-08-10: a bounded single-product search runs 2.3-3.3x, while \"chanel\" (keychain and handbag in one median) runs 7.4-15x and \"leica m6\" 204x. A search above the ceiling is mixing product tiers and is refused rather than scored - bound it with priceMin / priceMax.", "default": "4.0" }, "priceMin": { "title": "Min price", "minimum": 0, "type": "integer", "description": "Pushed to Vinted, so the basis and the candidates cover the same tier. In the country site's own currency." }, "priceMax": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Pushed to Vinted, like the minimum." }, "includeIndividualDeals": { "title": "Include individual deals", "type": "boolean", "description": "Also return each listing under the cutoff (charged per deal).", "default": true }, "convertToUsd": { "title": "Convert to USD", "type": "boolean", "description": "Add USD figures alongside the native currency.", "default": 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 } } }, "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 } } } } } } } } } }