{
"openapi": "3.0.1",
"info": {
"title": "Vinted Search Scraper",
"description": "Search and extract product listings from Vinted's internal catalog API — title, price, size, brand, condition, seller and photos — with adaptive sharding to go beyond the 960-item-per-query cap.",
"version": "0.1",
"x-build-id": "c0UVhQnTVMBcEzLIX"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/datacach~vinted-search-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-datacach-vinted-search-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/datacach~vinted-search-scraper/runs": {
"post": {
"operationId": "runs-sync-datacach-vinted-search-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/datacach~vinted-search-scraper/run-sync": {
"post": {
"operationId": "run-sync-datacach-vinted-search-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": {
"searchText": {
"title": "Search text",
"type": "string",
"description": "The keyword to search for on Vinted, exactly as you would type it into the site's search bar (for example nike air max or vintage denim jacket). Required unless you provide one or more Catalog IDs instead. If you set both, results are collected for the search term filtered by those categories."
},
"domain": {
"title": "Vinted marketplace",
"enum": [
"www.vinted.com",
"www.vinted.es",
"www.vinted.fr",
"www.vinted.de",
"www.vinted.it",
"www.vinted.nl",
"www.vinted.co.uk",
"www.vinted.pl",
"www.vinted.cz",
"www.vinted.lt"
],
"type": "string",
"description": "Which Vinted country site to scrape. This determines the listing inventory, the language, and the currency prices are reported in (for example .com is US dollars, .fr and .es are euros, .co.uk is British pounds).",
"default": "www.vinted.com"
},
"catalogIds": {
"title": "Catalog IDs",
"type": "array",
"description": "Optional Vinted category IDs to scrape, used instead of or together with a search term. Each ID is the number in a Vinted category URL — for example the 2050 in vinted.com/catalog/2050-shoes. Add one ID per line (for example 2050). Leave empty to search by keyword only.",
"items": {
"type": "string"
}
},
"maxItems": {
"title": "Max items",
"minimum": 0,
"type": "integer",
"description": "Maximum number of unique items to collect before the run stops. Set to 0 for no limit, which collects up to the ceiling of 50,000 items per run. Higher values increase run time and compute usage. A single query is capped at 960 items by Vinted's API, so the Actor automatically shards by price window to gather more when a higher limit is set. Note: free-plan accounts are capped at 100 items per run regardless of this value (including 0); upgrade to a paid plan to remove this limit.",
"default": 100
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Proxy used for all requests. A residential proxy is strongly recommended — Vinted returns HTTP 403 to datacenter IPs. One IP is pinned for the whole run so the session stays valid.",
"default": {
"useApifyProxy": true,
"apifyProxyGroups": [
"RESIDENTIAL"
]
}
},
"requestDelay": {
"title": "Request delay",
"minimum": 0,
"type": "number",
"description": "Politeness delay between consecutive API requests, in seconds. Lower values make the run faster but increase the risk of hitting Vinted's rate limits; higher values are safer but slower. The default of 0.4 seconds is a balanced starting point. Note: free-plan accounts always use a minimum delay of 0.4 seconds; upgrade to a paid plan to go faster.",
"default": 0.4
}
}
},
"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
}
}
}
}
}
}
}
}
}
}