{ "openapi": "3.0.1", "info": { "title": "Vestiaire Collective Scraper: Sold Items & Seller Intelligence", "description": "Scrape public Vestiaire Collective live and sold listings across 70 markets. Extract prices, seller countries, conditions, product details, price history, and duplicate/suspicious seller signals.", "version": "0.1", "x-build-id": "qWPrIJ4axxWVV5etw" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kazkn~vestiaire-collective-smart-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kazkn-vestiaire-collective-smart-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/kazkn~vestiaire-collective-smart-scraper/runs": { "post": { "operationId": "runs-sync-kazkn-vestiaire-collective-smart-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/kazkn~vestiaire-collective-smart-scraper/run-sync": { "post": { "operationId": "run-sync-kazkn-vestiaire-collective-smart-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": { "searchTerms": { "title": "๐Ÿ”Ž Search terms", "type": "array", "description": "Keywords or product names to search, for example `chanel classic flap`, `dior saddle`, or `hermes kelly 28`.", "items": { "type": "string", "minLength": 1 } }, "startUrls": { "title": "๐Ÿ”— Direct Vestiaire URLs", "type": "array", "description": "Optional public Vestiaire Collective URLs, including category, search, product, or sold-items pages.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "includeSoldItems": { "title": "โœ… Include sold items", "type": "boolean", "description": "Adds sold_item records from Vestiaire's public sold search filter. Useful for demand validation, market reports, and sold-price tracking.", "default": false }, "countries": { "title": "๐ŸŒ Country selection", "type": "array", "description": "Choose Vestiaire country codes. Keep only `ALL` to search all 70 supported countries; do not combine `ALL` with specific countries.", "items": { "type": "string", "enum": [ "ALL", "AD", "AU", "AT", "BH", "BE", "BR", "BG", "CA", "IC", "CN", "HR", "CY", "CZ", "DK", "EE", "FI", "FR", "GF", "PF", "DE", "GI", "GR", "GP", "GG", "HK", "HU", "ID", "IE", "IM", "IL", "IT", "JP", "JE", "KW", "LV", "LB", "LI", "LT", "LU", "MY", "MT", "MQ", "YT", "MC", "NL", "NC", "NZ", "NO", "PH", "PL", "PT", "QA", "RE", "RO", "SA", "SG", "SK", "SI", "ZA", "KR", "ES", "BL", "MF", "SE", "CH", "TW", "TH", "AE", "GB", "US" ], "enumTitles": [ "๐ŸŒ ALL - All 70 supported Vestiaire countries", "๐Ÿ‡ฆ๐Ÿ‡ฉ AD - Andorra", "๐Ÿ‡ฆ๐Ÿ‡บ AU - Australia", "๐Ÿ‡ฆ๐Ÿ‡น AT - Austria", "๐Ÿ‡ง๐Ÿ‡ญ BH - Bahrain", "๐Ÿ‡ง๐Ÿ‡ช BE - Belgium", "๐Ÿ‡ง๐Ÿ‡ท BR - Brazil", "๐Ÿ‡ง๐Ÿ‡ฌ BG - Bulgaria", "๐Ÿ‡จ๐Ÿ‡ฆ CA - Canada", "๐Ÿ๏ธ IC - Canary Islands", "๐Ÿ‡จ๐Ÿ‡ณ CN - China", "๐Ÿ‡ญ๐Ÿ‡ท HR - Croatia", "๐Ÿ‡จ๐Ÿ‡พ CY - Cyprus", "๐Ÿ‡จ๐Ÿ‡ฟ CZ - Czech Republic", "๐Ÿ‡ฉ๐Ÿ‡ฐ DK - Denmark", "๐Ÿ‡ช๐Ÿ‡ช EE - Estonia", "๐Ÿ‡ซ๐Ÿ‡ฎ FI - Finland", "๐Ÿ‡ซ๐Ÿ‡ท FR - France", "๐Ÿ‡ฌ๐Ÿ‡ซ GF - French Guiana", "๐Ÿ‡ต๐Ÿ‡ซ PF - French Polynesia", "๐Ÿ‡ฉ๐Ÿ‡ช DE - Germany", "๐Ÿ‡ฌ๐Ÿ‡ฎ GI - Gibraltar", "๐Ÿ‡ฌ๐Ÿ‡ท GR - Greece", "๐Ÿ‡ฌ๐Ÿ‡ต GP - Guadeloupe", "๐Ÿ‡ฌ๐Ÿ‡ฌ GG - Guernsey", "๐Ÿ‡ญ๐Ÿ‡ฐ HK - Hong Kong", "๐Ÿ‡ญ๐Ÿ‡บ HU - Hungary", "๐Ÿ‡ฎ๐Ÿ‡ฉ ID - Indonesia", "๐Ÿ‡ฎ๐Ÿ‡ช IE - Ireland", "๐Ÿ‡ฎ๐Ÿ‡ฒ IM - Isle of Man", "๐Ÿ‡ฎ๐Ÿ‡ฑ IL - Israel", "๐Ÿ‡ฎ๐Ÿ‡น IT - Italy", "๐Ÿ‡ฏ๐Ÿ‡ต JP - Japan", "๐Ÿ‡ฏ๐Ÿ‡ช JE - Jersey", "๐Ÿ‡ฐ๐Ÿ‡ผ KW - Kuwait", "๐Ÿ‡ฑ๐Ÿ‡ป LV - Latvia", "๐Ÿ‡ฑ๐Ÿ‡ง LB - Lebanon", "๐Ÿ‡ฑ๐Ÿ‡ฎ LI - Liechtenstein", "๐Ÿ‡ฑ๐Ÿ‡น LT - Lithuania", "๐Ÿ‡ฑ๐Ÿ‡บ LU - Luxembourg", "๐Ÿ‡ฒ๐Ÿ‡พ MY - Malaysia", "๐Ÿ‡ฒ๐Ÿ‡น MT - Malta", "๐Ÿ‡ฒ๐Ÿ‡ถ MQ - Martinique", "๐Ÿ‡พ๐Ÿ‡น YT - Mayotte", "๐Ÿ‡ฒ๐Ÿ‡จ MC - Monaco", "๐Ÿ‡ณ๐Ÿ‡ฑ NL - Netherlands", "๐Ÿ‡ณ๐Ÿ‡จ NC - New Caledonia", "๐Ÿ‡ณ๐Ÿ‡ฟ NZ - New Zealand", "๐Ÿ‡ณ๐Ÿ‡ด NO - Norway", "๐Ÿ‡ต๐Ÿ‡ญ PH - Philippines", "๐Ÿ‡ต๐Ÿ‡ฑ PL - Poland", "๐Ÿ‡ต๐Ÿ‡น PT - Portugal", "๐Ÿ‡ถ๐Ÿ‡ฆ QA - Qatar", "๐Ÿ‡ท๐Ÿ‡ช RE - Rรฉunion", "๐Ÿ‡ท๐Ÿ‡ด RO - Romania", "๐Ÿ‡ธ๐Ÿ‡ฆ SA - Saudi Arabia", "๐Ÿ‡ธ๐Ÿ‡ฌ SG - Singapore", "๐Ÿ‡ธ๐Ÿ‡ฐ SK - Slovakia", "๐Ÿ‡ธ๐Ÿ‡ฎ SI - Slovenia", "๐Ÿ‡ฟ๐Ÿ‡ฆ ZA - South Africa", "๐Ÿ‡ฐ๐Ÿ‡ท KR - South Korea", "๐Ÿ‡ช๐Ÿ‡ธ ES - Spain", "๐Ÿ‡ง๐Ÿ‡ฑ BL - St Barthรฉlemy", "๐Ÿ‡ฒ๐Ÿ‡ซ MF - St Martin", "๐Ÿ‡ธ๐Ÿ‡ช SE - Sweden", "๐Ÿ‡จ๐Ÿ‡ญ CH - Switzerland", "๐Ÿ‡น๐Ÿ‡ผ TW - Taiwan", "๐Ÿ‡น๐Ÿ‡ญ TH - Thailand", "๐Ÿ‡ฆ๐Ÿ‡ช AE - United Arab Emirates", "๐Ÿ‡ฌ๐Ÿ‡ง GB - United Kingdom", "๐Ÿ‡บ๐Ÿ‡ธ US - United States" ] }, "default": [ "ALL" ] }, "sellerCountries": { "title": "๐Ÿ‘ค Seller countries", "type": "array", "description": "Optional seller country filter. This is different from Country selection: countries controls the Vestiaire market searched, sellerCountries controls where the seller/item is located.", "items": { "type": "string", "enum": [ "ALL", "AD", "AU", "AT", "BH", "BE", "BR", "BG", "CA", "IC", "CN", "HR", "CY", "CZ", "DK", "EE", "FI", "FR", "GF", "PF", "DE", "GI", "GR", "GP", "GG", "HK", "HU", "ID", "IE", "IM", "IL", "IT", "JP", "JE", "KW", "LV", "LB", "LI", "LT", "LU", "MY", "MT", "MQ", "YT", "MC", "NL", "NC", "NZ", "NO", "PH", "PL", "PT", "QA", "RE", "RO", "SA", "SG", "SK", "SI", "ZA", "KR", "ES", "BL", "MF", "SE", "CH", "TW", "TH", "AE", "GB", "US" ], "enumTitles": [ "๐ŸŒ ALL - All 70 supported Vestiaire countries", "๐Ÿ‡ฆ๐Ÿ‡ฉ AD - Andorra", "๐Ÿ‡ฆ๐Ÿ‡บ AU - Australia", "๐Ÿ‡ฆ๐Ÿ‡น AT - Austria", "๐Ÿ‡ง๐Ÿ‡ญ BH - Bahrain", "๐Ÿ‡ง๐Ÿ‡ช BE - Belgium", "๐Ÿ‡ง๐Ÿ‡ท BR - Brazil", "๐Ÿ‡ง๐Ÿ‡ฌ BG - Bulgaria", "๐Ÿ‡จ๐Ÿ‡ฆ CA - Canada", "๐Ÿ๏ธ IC - Canary Islands", "๐Ÿ‡จ๐Ÿ‡ณ CN - China", "๐Ÿ‡ญ๐Ÿ‡ท HR - Croatia", "๐Ÿ‡จ๐Ÿ‡พ CY - Cyprus", "๐Ÿ‡จ๐Ÿ‡ฟ CZ - Czech Republic", "๐Ÿ‡ฉ๐Ÿ‡ฐ DK - Denmark", "๐Ÿ‡ช๐Ÿ‡ช EE - Estonia", "๐Ÿ‡ซ๐Ÿ‡ฎ FI - Finland", "๐Ÿ‡ซ๐Ÿ‡ท FR - France", "๐Ÿ‡ฌ๐Ÿ‡ซ GF - French Guiana", "๐Ÿ‡ต๐Ÿ‡ซ PF - French Polynesia", "๐Ÿ‡ฉ๐Ÿ‡ช DE - Germany", "๐Ÿ‡ฌ๐Ÿ‡ฎ GI - Gibraltar", "๐Ÿ‡ฌ๐Ÿ‡ท GR - Greece", "๐Ÿ‡ฌ๐Ÿ‡ต GP - Guadeloupe", "๐Ÿ‡ฌ๐Ÿ‡ฌ GG - Guernsey", "๐Ÿ‡ญ๐Ÿ‡ฐ HK - Hong Kong", "๐Ÿ‡ญ๐Ÿ‡บ HU - Hungary", "๐Ÿ‡ฎ๐Ÿ‡ฉ ID - Indonesia", "๐Ÿ‡ฎ๐Ÿ‡ช IE - Ireland", "๐Ÿ‡ฎ๐Ÿ‡ฒ IM - Isle of Man", "๐Ÿ‡ฎ๐Ÿ‡ฑ IL - Israel", "๐Ÿ‡ฎ๐Ÿ‡น IT - Italy", "๐Ÿ‡ฏ๐Ÿ‡ต JP - Japan", "๐Ÿ‡ฏ๐Ÿ‡ช JE - Jersey", "๐Ÿ‡ฐ๐Ÿ‡ผ KW - Kuwait", "๐Ÿ‡ฑ๐Ÿ‡ป LV - Latvia", "๐Ÿ‡ฑ๐Ÿ‡ง LB - Lebanon", "๐Ÿ‡ฑ๐Ÿ‡ฎ LI - Liechtenstein", "๐Ÿ‡ฑ๐Ÿ‡น LT - Lithuania", "๐Ÿ‡ฑ๐Ÿ‡บ LU - Luxembourg", "๐Ÿ‡ฒ๐Ÿ‡พ MY - Malaysia", "๐Ÿ‡ฒ๐Ÿ‡น MT - Malta", "๐Ÿ‡ฒ๐Ÿ‡ถ MQ - Martinique", "๐Ÿ‡พ๐Ÿ‡น YT - Mayotte", "๐Ÿ‡ฒ๐Ÿ‡จ MC - Monaco", "๐Ÿ‡ณ๐Ÿ‡ฑ NL - Netherlands", "๐Ÿ‡ณ๐Ÿ‡จ NC - New Caledonia", "๐Ÿ‡ณ๐Ÿ‡ฟ NZ - New Zealand", "๐Ÿ‡ณ๐Ÿ‡ด NO - Norway", "๐Ÿ‡ต๐Ÿ‡ญ PH - Philippines", "๐Ÿ‡ต๐Ÿ‡ฑ PL - Poland", "๐Ÿ‡ต๐Ÿ‡น PT - Portugal", "๐Ÿ‡ถ๐Ÿ‡ฆ QA - Qatar", "๐Ÿ‡ท๐Ÿ‡ช RE - Rรฉunion", "๐Ÿ‡ท๐Ÿ‡ด RO - Romania", "๐Ÿ‡ธ๐Ÿ‡ฆ SA - Saudi Arabia", "๐Ÿ‡ธ๐Ÿ‡ฌ SG - Singapore", "๐Ÿ‡ธ๐Ÿ‡ฐ SK - Slovakia", "๐Ÿ‡ธ๐Ÿ‡ฎ SI - Slovenia", "๐Ÿ‡ฟ๐Ÿ‡ฆ ZA - South Africa", "๐Ÿ‡ฐ๐Ÿ‡ท KR - South Korea", "๐Ÿ‡ช๐Ÿ‡ธ ES - Spain", "๐Ÿ‡ง๐Ÿ‡ฑ BL - St Barthรฉlemy", "๐Ÿ‡ฒ๐Ÿ‡ซ MF - St Martin", "๐Ÿ‡ธ๐Ÿ‡ช SE - Sweden", "๐Ÿ‡จ๐Ÿ‡ญ CH - Switzerland", "๐Ÿ‡น๐Ÿ‡ผ TW - Taiwan", "๐Ÿ‡น๐Ÿ‡ญ TH - Thailand", "๐Ÿ‡ฆ๐Ÿ‡ช AE - United Arab Emirates", "๐Ÿ‡ฌ๐Ÿ‡ง GB - United Kingdom", "๐Ÿ‡บ๐Ÿ‡ธ US - United States" ] }, "default": [ "ALL" ] }, "itemConditions": { "title": "๐Ÿงฅ Item condition", "type": "array", "description": "Choose one or more Vestiaire item conditions. Leave empty to include every condition.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5" ], "enumTitles": [ "๐Ÿท๏ธ Jamais portรฉ avec รฉtiquette", "โœจ Jamais portรฉ", "โœ… Trรจs bon รฉtat", "๐Ÿ‘ Bon รฉtat", "๐Ÿ› ๏ธ Correct" ] }, "default": [] }, "requiredKeywords": { "title": "๐ŸŽฏ Required title/model keywords", "type": "array", "description": "Optional precision filter. Every word or phrase entered here must appear in the item title or model, for example `classic flap` to avoid Trendy CC Flap results.", "items": { "type": "string", "minLength": 1 }, "default": [] }, "maxListings": { "title": "๐Ÿ‘œ Max Listings", "minimum": 1, "type": "integer", "description": "Maximum active, sold, or tracking listing records to collect before stopping search. Filters and deduplication can make the final result smaller.", "default": 100 }, "maxDatasetRecords": { "title": "๐Ÿ“Š Max Dataset records", "minimum": 1, "type": "integer", "description": "Maximum rows to push to the dataset, including listings, product details, sold items, seller summaries, risk signals, tracking rows, and diagnostics.", "default": 100 }, "maxItems": { "title": "๐Ÿ” Legacy max records alias", "minimum": 1, "type": "integer", "description": "Backwards-compatible alias for Max Dataset records. If both fields are set, maxDatasetRecords wins.", "default": 100 }, "maxPagesPerCountry": { "title": "๐Ÿ“„ Max pages per country", "minimum": 1, "type": "integer", "description": "Maximum search pages to fetch per selected country and search term.", "default": 10 }, "maxRuntimeMinutes": { "title": "โฑ๏ธ Max runtime", "minimum": 1, "type": "integer", "description": "Stops starting new public requests after this many minutes. Already collected records can still be written to the dataset.", "default": 20 }, "includeDetails": { "title": "๐Ÿงพ Product details", "type": "boolean", "description": "Fetch product pages and emit detail records with richer descriptions and product metadata.", "default": false }, "includeSellerInfo": { "title": "๐Ÿ‘ค Seller intelligence", "type": "boolean", "description": "Emit seller_summary records from observed listings and sold items.", "default": false }, "includeDuplicateSignals": { "title": "๐Ÿšฉ Duplicate / suspicious signals", "type": "boolean", "description": "Emit conservative risk_signal records for duplicate-looking listings and repeated seller patterns.", "default": false }, "trackingStoreName": { "title": "๐Ÿ—„๏ธ Tracking storage name", "type": "string", "description": "Named key-value store used for durable price history and active-to-likely-sold tracking state.", "default": "vestiaire-smart-tracker" }, "missingRunsThreshold": { "title": "๐Ÿ“‰ Missing runs before likely sold", "minimum": 1, "type": "integer", "description": "Number of consecutive missing runs before an active listing is emitted as likely_sold.", "default": 2 }, "proxyConfiguration": { "title": "๐Ÿ›ก๏ธ Proxy configuration", "type": "object", "description": "Optional Apify Proxy configuration. Keep the default unless you need a specific proxy setup.", "default": { "useApifyProxy": 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 } } } } } } } } } }