# Vestiaire Collective Scraper (`shahidirfan/vestiaire-collective-scraper`) Actor Scrape Vestiaire Collective luxury fashion data effortlessly. Extract product listings, prices, conditions & seller info for price monitoring, market research & business intelligence. Fast, reliable automation. - **URL**: https://apify.com/shahidirfan/vestiaire-collective-scraper.md - **Developed by:** [Shahid Irfan](https://apify.com/shahidirfan) (community) - **Categories:** Automation, E-commerce, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Vestiaire Collective Scraper Extract product listings from Vestiaire Collective with a simple keyword-based setup. Collect rich listing data including brand, pricing, likes, sizing, flattened colors, complete image URLs, seller metadata, and product links at scale. --- ### Features - **Simple input setup** - Run with either a listing URL or a keyword, plus result/page limits. - **Internal smart defaults** - Listing source, sort, locale, and core filters are configured internally. - **Pagination handling** - Continues collecting until `results_wanted` or `max_pages` is reached. - **Structured product output** - Returns normalized listing fields ready for analytics pipelines. - **Clean dataset records** - Omits empty values so output is compact and easier to process. --- ### Use Cases #### Resale Market Monitoring Track second-hand luxury product trends by brand, category, and demand signals. Build historical datasets to monitor shifts in pricing and stock availability. #### Competitive Intelligence Compare category depth and listing quality across different URL patterns. Identify where specific brands or segments are most active. #### Pricing Analysis Collect listing price snapshots and combine them with engagement signals such as likes. Use this data to estimate sell-through potential and market positioning. #### Inventory Sourcing Research Discover high-volume categories and product types suitable for sourcing decisions. Filter by tags, keyword, or curated listing URLs. --- ### Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | `url` | String | No | `https://www.vestiairecollective.com/search/?q=gucci` | Vestiaire search/category/brand/tag URL | | `keyword` | String | No | `gucci` | Keyword override for listing search | | `results_wanted` | Integer | No | `20` | Maximum number of products to return | | `max_pages` | Integer | No | `10` | Maximum pages to process per URL | | `proxyConfiguration` | Object | No | Apify Proxy | Proxy settings | When both are empty, the actor uses an internal default listing context. --- ### Output Data Each dataset item can contain the following fields: | Field | Type | Description | |-------|------|-------------| | `id` | Number | Listing identifier | | `name` | String | Listing title | | `description` | String | Listing description | | `brandId` | Number | Brand identifier | | `brandName` | String | Brand name | | `country` | String | Country context | | `link` | String | Product URL | | `likes` | Number | Number of likes | | `sold` | Boolean | Sold flag | | `stock` | Boolean | Stock value/status | | `universeId` | Number | Universe id | | `createdAt` | Number | Creation timestamp | | `colorNames` | Array | Flattened color names | | `primaryColor` | String | Primary color name | | `size` | String | Size label | | `pictureUrls` | Array | Listing image URLs | | `imageCount` | Number | Total number of unique image URLs | | `priceAmount` | Number | Numeric price amount | | `priceCurrency` | String | Currency code | | `priceFormatted` | String | Localized display price | | `sellerId` | Number | Seller identifier | | `sellerName` | String | Seller name | | `localEligible` | Boolean | Local shipping eligibility | | `directShippingEligible` | Boolean | Direct shipping eligibility | | `editorPicks` | Object | Editor selection flags | | `sourceUrl` | String | Input URL used for this record | | `searchKeyword` | String | Effective keyword applied | | `appliedSort` | String | Applied sort value | | `appliedCatalogPath` | String | Applied category path | | `appliedUniverseId` | String | Applied universe id | --- ### Usage Examples #### Basic Listing Extraction ```json { "url": "https://us.vestiairecollective.com/women-accessories/watches/#categoryParent=Accessories%236_category=6%20%3E%20Watches%2344_gender=Women%231", "results_wanted": 20 } ```` #### Keyword Search ```json { "keyword": "gucci", "results_wanted": 50, "max_pages": 10 } ``` *** ### Sample Output ```json { "id": "65518631", "name": "Leather handbag", "brandId": "37", "brandName": "Gucci", "country": "US", "link": "https://us.vestiairecollective.com/women-bags/handbags/gucci/", "likes": 18, "stock": "1", "universeId": "1", "createdAt": 1776303138, "colorNames": ["White", "Cream"], "primaryColor": "White", "pictureUrls": [ "https://images.vestiairecollective.com/produit/66074344-1.jpg", "https://images.vestiairecollective.com/produit/66074344-2.jpg" ], "imageCount": 2, "priceAmount": 749, "priceCurrency": "USD", "priceFormatted": "$749", "sellerId": 3201983, "sellerName": "fashioncloset", "directShippingEligible": true, "sourceUrl": "https://us.vestiairecollective.com/women/#gender=Women%231", "searchKeyword": "gucci", "appliedSort": "relevance", "appliedCatalogPath": "/women/", "appliedUniverseId": "1" } ``` *** ### Tips For Best Results #### Start With Small Runs - Use `results_wanted: 20` to validate your input setup. - Increase result limits only after verifying output quality. #### Prefer Stable Listing URLs - Use listing pages instead of individual product detail pages. - Keep category paths consistent for easier trend comparisons. #### Tune Filters Incrementally - Adjust `keyword` and run smaller batches first. - Compare output volume after each filter change. #### Use Proxy For Larger Runs - Residential proxy is recommended for production-scale runs. - Keep request volume aligned with your desired data freshness. *** ### Integrations - **Google Sheets** - Export product records for quick analysis. - **Airtable** - Build searchable luxury resale datasets. - **Make** - Trigger automated enrichment and notifications. - **Zapier** - Connect output to CRM, docs, or alerting tools. - **Webhooks** - Forward new data to your own services. #### Export Formats - **JSON** - Programmatic workflows and APIs. - **CSV** - Spreadsheet and BI analysis. - **Excel** - Business reporting. - **XML** - Legacy system integration. *** ### Frequently Asked Questions #### Does this actor support keyword search? Yes. Use the `keyword` input. #### Why are some fields missing in certain records? Some listings do not expose every optional field, and empty values are intentionally omitted from output. #### How can I limit run time? Use lower values for `results_wanted` and `max_pages`. #### Is proxy required? Proxy is optional for small runs, but recommended for production stability. *** ### Support For support requests and feature suggestions, open an issue through the Apify actor page. #### Resources - [Apify Documentation](https://docs.apify.com/) - [Apify API Reference](https://docs.apify.com/api/v2) - [Apify Scheduling](https://docs.apify.com/platform/schedules) *** ### Legal Notice This actor is designed for legitimate data collection use cases. You are responsible for complying with website terms, applicable laws, and responsible usage practices in your jurisdiction. # Actor input Schema ## `url` (type: `string`): Vestiaire Collective search, category, brand, or tag URL to scrape. ## `keyword` (type: `string`): Search keyword for products. ## `results_wanted` (type: `integer`): Maximum number of products to extract. ## `max_pages` (type: `integer`): Safety cap for paginated requests per source URL. ## `proxyConfiguration` (type: `object`): Use Apify residential proxy for reliable production runs. ## Actor input object example ```json { "url": "https://www.vestiairecollective.com/search/?q=gucci", "keyword": "gucci", "results_wanted": 20, "max_pages": 10, "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "url": "https://www.vestiairecollective.com/search/?q=gucci", "keyword": "gucci", "results_wanted": 20, "max_pages": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("shahidirfan/vestiaire-collective-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "url": "https://www.vestiairecollective.com/search/?q=gucci", "keyword": "gucci", "results_wanted": 20, "max_pages": 10, } # Run the Actor and wait for it to finish run = client.actor("shahidirfan/vestiaire-collective-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "url": "https://www.vestiairecollective.com/search/?q=gucci", "keyword": "gucci", "results_wanted": 20, "max_pages": 10 }' | apify call shahidirfan/vestiaire-collective-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=shahidirfan/vestiaire-collective-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Vestiaire Collective Scraper", "description": "Scrape Vestiaire Collective luxury fashion data effortlessly. Extract product listings, prices, conditions & seller info for price monitoring, market research & business intelligence. Fast, reliable automation.", "version": "0.0", "x-build-id": "olma2t1eed7PJyCkp" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/shahidirfan~vestiaire-collective-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-shahidirfan-vestiaire-collective-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/shahidirfan~vestiaire-collective-scraper/runs": { "post": { "operationId": "runs-sync-shahidirfan-vestiaire-collective-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/shahidirfan~vestiaire-collective-scraper/run-sync": { "post": { "operationId": "run-sync-shahidirfan-vestiaire-collective-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": { "url": { "title": "Source URL", "type": "string", "description": "Vestiaire Collective search, category, brand, or tag URL to scrape." }, "keyword": { "title": "Keyword", "type": "string", "description": "Search keyword for products." }, "results_wanted": { "title": "Maximum number of results", "minimum": 1, "type": "integer", "description": "Maximum number of products to extract.", "default": 20 }, "max_pages": { "title": "Maximum pages per URL", "minimum": 1, "type": "integer", "description": "Safety cap for paginated requests per source URL.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use Apify residential proxy for reliable production runs.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```