{ "openapi": "3.0.1", "info": { "title": "Vinted Seller Scraper — Wardrobe, Reviews & Reputation", "description": "Scrape Vinted seller profiles, public wardrobe listings, and buyer reviews by member URL or seller ID. Export reputation, sold counts, prices, brands, sizes, conditions, photos, and review text across 22 Vinted markets. JSON export for Python, Node.js, and MCP — no browser.", "version": "0.1", "x-build-id": "ZCgGJlt3V1wcM8FlW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~vinted-seller-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-vinted-seller-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/crawloop~vinted-seller-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-vinted-seller-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/crawloop~vinted-seller-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-vinted-seller-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": { "startUrls": { "title": "Seller / member URLs", "type": "array", "description": "Paste Vinted member profile URLs. The numeric ID in /member/12345-username is enough. Catalog and item URLs are ignored. Store / Console Try prefill uses a live public seller so the quality check succeeds.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "sellerIds": { "title": "Seller IDs", "type": "array", "description": "Numeric Vinted user IDs when you do not have a member URL. Resolved on the Domain selected below.", "items": { "type": "string" } }, "domain": { "title": "Default Vinted domain", "enum": [ "fr", "de", "at", "be", "nl", "es", "it", "pt", "pl", "cz", "sk", "hu", "ro", "lt", "lu", "se", "dk", "fi", "ie", "gr", "co.uk", "com" ], "type": "string", "description": "Market used for seller IDs (URLs keep their own domain). Residential proxy country follows this value when not set on the proxy.", "default": "fr" }, "includeProfile": { "title": "Include seller profile", "type": "boolean", "description": "Push one seller row per member: reputation, sold/bought counts, followers, business flag, city/country.", "default": true }, "includeListings": { "title": "Include wardrobe listings", "type": "boolean", "description": "Push public wardrobe items: title, price, brand, size, condition, photos, favourites.", "default": true }, "includeReviews": { "title": "Include buyer reviews", "type": "boolean", "description": "Push public feedback left on this seller (rating, text, reviewer username, related item id).", "default": true }, "maxItemsPerSeller": { "title": "Max listings per seller", "minimum": 0, "maximum": 2000, "type": "integer", "description": "Cap on wardrobe rows per seller. 0 skips listings even if Include wardrobe is on.", "default": 100 }, "maxReviewsPerSeller": { "title": "Max reviews per seller", "minimum": 0, "maximum": 500, "type": "integer", "description": "Cap on review rows per seller. 0 skips reviews even if Include buyer reviews is on.", "default": 50 }, "listingOrder": { "title": "Wardrobe sort", "enum": [ "newest_first", "relevance", "price_low_to_high", "price_high_to_low" ], "type": "string", "description": "Sort order for wardrobe listings.", "default": "newest_first" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Residential proxies are strongly recommended. Vinted DataDome typically blocks datacenter IPs after one or two requests.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "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 } } } } } } } } } }