{
"openapi": "3.0.1",
"info": {
"title": "Vinted Scraper",
"description": "Vinted is Europe's largest fashion resale marketplace, and pricing on it means seeing the whole shelf: every live listing for a brand and size across all 23 national sites. Rows give brand, size, condition, asking price and the buyer-protection total a buyer pays. No seller usernames collected.",
"version": "0.1",
"x-build-id": "iNJi6OtkufVPIZ4xO"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/lowlanddata~vinted-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-lowlanddata-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/lowlanddata~vinted-scraper/runs": {
"post": {
"operationId": "runs-sync-lowlanddata-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/lowlanddata~vinted-scraper/run-sync": {
"post": {
"operationId": "run-sync-lowlanddata-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": {
"searchQuery": {
"title": "Search query",
"type": "string",
"description": "What to search for on Vinted, exactly as you would type it in the site's search box, e.g. \"nike air max\" or \"zara dress\". Leave it out when you only re-check items through listingIds."
},
"listingIds": {
"title": "Specific item IDs",
"type": "array",
"description": "Re-check items you already know instead of searching: one item ID per line (the number after /items/ in every Vinted address, and the itemId of every dataset item), or the item's full address. Each one is read from its own page on the national site chosen in Domain - title, brand, size, condition, colour, price, every photo, the full description, the favourite count and the site's own status (active, reserved, hidden). An item that is gone from the site (sold, deleted) is skipped, named in the log and not billed. When given, the search fields of this form are ignored and the run status says which. Up to 50.",
"items": {
"type": "string"
}
},
"domain": {
"title": "Vinted country site",
"enum": [
"fr",
"be",
"de",
"nl",
"es",
"it",
"co.uk",
"pl",
"at",
"pt",
"cz",
"sk",
"lt",
"se",
"dk",
"fi",
"ie",
"lu",
"hu",
"ro",
"gr",
"hr",
"com"
],
"type": "string",
"description": "Which national Vinted site to search. Prices come in that site's currency.",
"default": "fr"
},
"priceMin": {
"title": "Minimum price",
"minimum": 0,
"type": "integer",
"description": "Only include items costing at least this much, in the selected site's currency."
},
"priceMax": {
"title": "Maximum price",
"minimum": 0,
"type": "integer",
"description": "Only include items costing at most this much, in the selected site's currency."
},
"sortBy": {
"title": "Sort by",
"enum": [
"newest",
"price_asc",
"price_desc",
"relevance"
],
"type": "string",
"description": "Order of results: newest (best for monitoring), price_asc, price_desc, or relevance.",
"default": "newest"
},
"aiAnalysis": {
"title": "AI analysis",
"type": "boolean",
"description": "Add AI-computed fields to every item: normalizedBrand, normalizedCategory, conditionScore (1-5) and listingQuality - directly comparable across sellers' free-form listings. Billed $0.50 per 1,000 analyzed items on top of the result price. Paid Apify plans only.",
"default": false
},
"scrapeDetails": {
"title": "Fetch descriptions",
"type": "boolean",
"description": "Read each item's own page for the seller's full description and the item colour, neither of which the search results carry. This makes one extra request per item, so a run is slower and costs one more page fetch each. Seller identity is never read - only the description text and colour reach the output. Leave off for a fast search-only sweep.",
"default": false
},
"maxItems": {
"title": "Max items",
"minimum": 1,
"type": "integer",
"description": "Stop after this many items. Free-plan runs are capped at 5 items. The form starts at 25 for a cheap first run - that is the form's prefill, not a cap on your plan; clear it to use the default of 500.",
"default": 500
},
"proxyConfiguration": {
"title": "Proxy",
"type": "object",
"description": "Proxy settings. Keep Apify proxy enabled.",
"default": {
"useApifyProxy": true
}
},
"reportFailures": {
"title": "Report failures to the developer",
"type": "boolean",
"description": "When a run fails, send the developer the actor name and build, an error category, the error message (truncated) and a one-way hash of your input - so a bug can be fixed without anyone asking you to reproduce it. Your input itself, your results and your identity are never sent, and successful runs send nothing at all. Switch this off and the actor behaves exactly the same.",
"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
},
"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
}
}
}
}
}
}
}
}
}
}