Vinted Seller Products Actor A powerful Apify actor for scraping detailed product information from Vinted seller profiles across multiple countries and languages. ## Overview The Vinted Seller Products Actor allows you to extract comprehensive product data from any Vinted seller's profile page. It supports all major Vinted domains and provides detailed information about each product including pricing, images, condition, availability status, and engagement metrics. ## Features - Multi-country Support: Works with all 22 Vinted country domains - Pagination Control: Scrape specific pages or ranges of products - Detailed Product Data: Extract comprehensive information for each item - Error Handling: Robust error handling with detailed logging - Data Validation: Input validation for all parameters - Summary Statistics: Automatic calculation of seller metrics ## Input Configuration ### Required Fields #### Seller URL - Type: String - Description: The full URL of the Vinted seller profile - Format: https://www.vinted.[country]/member/[seller_id] - Example: https://www.vinted.pt/member/74292334 - Validation: Must match the pattern for valid Vinted seller URLs ### Optional Fields #### Country Domain - Type: String (Dropdown) - Description: The country domain for Vinted - Default: com (International) - Supported Countries: - com - International - fr - France - de - Germany - es - Spain - it - Italy - be - Belgium - nl - Netherlands - at - Austria - ch - Switzerland - cz - Czech Republic - dk - Denmark - fi - Finland - hu - Hungary - lt - Lithuania - lv - Latvia - lu - Luxembourg - pl - Poland - pt - Portugal - ro - Romania - se - Sweden - sk - Slovakia - si - Slovenia #### Page Number - Type: Integer - Description: The page number to scrape (starting from 1) - Default: 1 - Range: Must be a positive integer - Use Case: Navigate through multiple pages of products #### Items Per Page - Type: Integer - Description: Number of items to retrieve per page - Default: 20 - Range: 1-100 - Use Case: Control the amount of data retrieved per request ### Example Input json { "sellerUrl": "https://www.vinted.pt/member/74292334", "country": "pt", "page": 1, "perPage": 20 } ## Output Data Structure The actor returns an array of product objects, each containing detailed information about a single item from the seller's catalog. ### Product Object Fields | Field | Type | Description | |-------|------|-------------| | sellerUrl | String | Original seller profile URL | | country | String | Country domain used | | page | Integer | Page number scraped | | perPage | Integer | Items per page setting | | productId | Integer | Unique Vinted product ID | | title | String | Product title/name | | price | Object | Price information with amount and currency | | currency | String | Currency code (e.g., "EUR", "USD") | | brand | String/null | Brand name if available | | size | String/null | Size information if available | | condition | String | Item condition (e.g., "New without tags") | | description | String | Product description | | photos | Array | Array of image URLs | | url | String | Direct link to the product page | | isVisible | Boolean | Whether the item is currently visible | | isSold | Boolean | Whether the item has been sold | | isReserved | Boolean | Whether the item is reserved | | createdAt | String | Creation timestamp | | updatedAt | String | Last update timestamp | | viewCount | Integer | Number of views | | favouriteCount | Integer | Number of favorites | | category | String/null | Product category if available | | timestamp | String | Scraping timestamp (ISO format) | ### Example Output json [ { "sellerUrl": "https://www.vinted.pt/member/74292334", "country": "pt", "page": 1, "perPage": 20, "productId": 6778683487, "title": "Casaco, cardigan amarelo. Tam S /M. Há Outras cores e modelos diferentes.", "price": { "amount": "7.5", "currency_code": "EUR" }, "currency": "EUR", "brand": null, "size": null, "condition": "New without tags", "description": "Beautiful yellow cardigan in excellent condition...", "photos": [ "https://images1.vinted.net/t/02_00303_UXe2HPfMwtYSKeAAY365rGrB/f800/1753880031.jpeg?s=30123f11c8496d66077411cf496cf36021bfe6ea", "https://images1.vinted.net/t/01_00476_in49mA74L8pZBwspYryaFs1h/f800/1753880031.jpeg?s=3c848ea1d7513701fa2cbe4d0ccfe262df0dd1c1" ], "url": "https://www.vinted.pt/items/6778683487-casaco-cardigan-amarelo-tam-s-m-ha-outras-cores-e-modelos-diferentes", "isVisible": true, "isSold": false, "isReserved": false, "createdAt": "2024-01-15T10:30:00Z", "updatedAt": "2024-01-20T14:22:00Z", "viewCount": 156, "favouriteCount": 44, "category": "Women's Clothing", "timestamp": "2025-07-31T07:39:40.189Z" } ] ## Additional Features ### Summary Statistics The actor automatically generates summary statistics saved to the key-value store under seller_products_summary: json { "sellerUrl": "https://www.vinted.pt/member/74292334", "country": "pt", "page": 1, "perPage": 20, "timestamp": "2025-07-31T07:39:40.189Z", "totalItemsOnPage": 20, "totalPages": 15, "totalItems": 287, "hasNextPage": true, "summary": { "itemsProcessed": 20, "averagePrice": 12.45, "soldItems": 3, "reservedItems": 1, "visibleItems": 19 } } ### Error Handling The actor includes comprehensive error handling: - URL Validation: Ensures seller URLs are properly formatted - Country Validation: Warns about unsupported country codes - Pagination Validation: Validates page numbers and items per page - Network Error Handling: Graceful handling of connection issues - Data Parsing: Safe handling of missing or malformed data ## Usage Examples ### Basic Usage Scrape the first 20 products from a Portuguese seller: json { "sellerUrl": "https://www.vinted.pt/member/74292334", "country": "pt" } ### Pagination Example Scrape page 3 with 50 items per page: json { "sellerUrl": "https://www.vinted.fr/member/12345678", "country": "fr", "page": 3, "perPage": 50 } ### Large Batch Scraping For scraping multiple pages, run separate actor instances or use the pagination information from the summary to iterate through pages. ## Best Practices 1. Respect Rate Limits: Don't run too many concurrent instances 2. Use Appropriate Page Sizes: Balance between efficiency and resource usage 3. Monitor for Changes: Vinted's structure may change; monitor for errors 4. Data Storage: Use Apify's dataset for large amounts of data 5. Error Monitoring: Check logs for validation warnings and errors ## Troubleshooting ### Common Issues Invalid Seller URL - Ensure the URL follows the correct format - Check that the seller ID is numeric - Verify the country domain matches the URL No Products Returned - Seller may have no products or all products are sold - Check if the seller profile is active - Verify the country setting matches the seller's location Pagination Issues - Check if the requested page number exists - Some sellers may have fewer products than expected - Use the summary data to understand total available pages ### Error Messages - sellerUrl is required: Provide a valid seller URL - page must be a positive integer: Use page numbers starting from 1 - perPage must be a positive integer between 1 and 100: Adjust the items per page value - No seller products retrieved: The seller may have no visible products ## API Integration This actor can be integrated into your applications using Apify's API: javascript // Example API call const client = new ApifyClient({ token: 'your-token', }); const run = await client.actor('the-actor-id').call({ sellerUrl: 'https://www.vinted.pt/member/74292334', country: 'pt', page: 1, perPage: 20 }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); ## Support If you have any questions or encounter any issues, please consult the Apify documentation or reach out to us through one of the following channels: * Telegram: @pintoflow * Email: pintoflowpt@gmail.com * Apify Platform: You can also contact us directly through this platform. ---