{
"openapi": "3.0.1",
"info": {
"title": "Vinted Scraper: Search, Items, Prices & Profiles",
"description": "Scrape Vinted listings, item details, user profiles, and catalog data across 26 European markets. Filter by brand, price, color, condition. Structured JSON with prices, photos, seller info. For market research, price monitoring, e-commerce.",
"version": "1.0",
"x-build-id": "m9IBamgfOmo95VWJT"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/scrape.badger~vinted-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-scrape.badger-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/scrape.badger~vinted-scraper/runs": {
"post": {
"operationId": "runs-sync-scrape.badger-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/scrape.badger~vinted-scraper/run-sync": {
"post": {
"operationId": "run-sync-scrape.badger-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",
"required": [
"mode"
],
"properties": {
"mode": {
"title": "Mode",
"enum": [
"Search Items",
"Get Item Details",
"Get User Profile",
"Get User Items",
"Search Brands",
"List Colors",
"List Conditions",
"List Markets"
],
"type": "string",
"description": "Select the type of Vinted data to scrape. Each mode requires different input parameters.",
"default": "Search Items"
},
"query": {
"title": "Search Query",
"type": "string",
"description": "Keywords to search for items or brands. Required for Search Items and Search Brands modes. Example: nike air force 1"
},
"item_id": {
"title": "Item ID",
"type": "integer",
"description": "Numeric Vinted item ID. Required for Get Item Details mode. You can find item IDs from search results or the item URL. Example: 4856231890"
},
"user_id": {
"title": "User ID",
"type": "integer",
"description": "Numeric Vinted user ID. Required for Get User Profile and Get User Items modes. You can find user IDs from search results or the user profile URL. Example: 12345678"
},
"market": {
"title": "Market",
"enum": [
"fr",
"de",
"uk",
"it",
"es",
"pl",
"nl",
"be",
"cz",
"lt",
"pt",
"at",
"lu",
"sk",
"dk",
"fi",
"se",
"ro",
"hu",
"hr",
"gr",
"us",
"ca",
"au",
"lv",
"ee"
],
"type": "string",
"description": "Vinted market (country) to target. Each market has its own catalog, currency, and language. Use List Markets mode to see all options.",
"default": "fr"
},
"price_from": {
"title": "Min Price",
"type": "string",
"description": "Minimum price filter in the market's local currency. Only used in Search Items mode. Example: 10"
},
"price_to": {
"title": "Max Price",
"type": "string",
"description": "Maximum price filter in the market's local currency. Only used in Search Items mode. Example: 100"
},
"brand_ids": {
"title": "Brand IDs",
"type": "string",
"description": "Comma-separated brand IDs to filter by. Use Search Brands mode to look up IDs. Example: 53 (Nike) or 14,53,221"
},
"color_ids": {
"title": "Color IDs",
"type": "string",
"description": "Comma-separated color IDs to filter by. Use List Colors mode to look up IDs. Example: 1,4,12"
},
"status_ids": {
"title": "Condition IDs",
"type": "string",
"description": "Comma-separated condition status IDs. Use List Conditions mode to look up IDs. Example: 6 (New with tags) or 1,2"
},
"order": {
"title": "Sort Order",
"enum": [
"relevance",
"price_low_to_high",
"price_high_to_low",
"newest_first"
],
"type": "string",
"description": "Sort order for search results. Only used in Search Items mode.",
"default": "relevance"
},
"max_results": {
"title": "Max Results",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Maximum number of items to return for paginated modes (Search Items, Get User Items, Search Brands). Higher values increase run time and cost. Default: 100.",
"default": 100
}
}
},
"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
}
}
}
}
}
}
}
}
}
}