Vinted Similar Products Actor ## Overview The Vinted Similar Products Actor is an Apify actor designed to scrape similar product listings from Vinted marketplace. Given a specific product URL, the actor retrieves a list of similar items available on Vinted, providing comprehensive product information including pricing, user details, and product metadata. ## Features - Extracts similar products from any Vinted product listing - Supports multiple Vinted country domains (22 countries) - Returns detailed product information including images, pricing, and seller details - Handles error cases gracefully - Stores results in both dataset and key-value store ## Supported Countries The actor supports the following Vinted domains: | Country | Domain | Code | |---------|--------|------| | International | .com | com | | France | .fr | fr | | Germany | .de | de | | Spain | .es | es | | Italy | .it | it | | Belgium | .be | be | | Netherlands | .nl | nl | | Austria | .at | at | | Switzerland | .ch | ch | | Czech Republic | .cz | cz | | Denmark | .dk | dk | | Finland | .fi | fi | | Hungary | .hu | hu | | Lithuania | .lt | lt | | Latvia | .lv | lv | | Luxembourg | .lu | lu | | Poland | .pl | pl | | Portugal | .pt | pt | | Romania | .ro | ro | | Sweden | .se | se | | Slovakia | .sk | sk | | Slovenia | .si | si | ## Input Parameters ### Required Parameters - productUrl (string): The complete Vinted product URL to scrape - Pattern: ^https://www\.vinted\.[a-z]{2,3}(/[a-z]{2})?/items/[0-9]+-.*$ - Example: https://www.vinted.pt/items/6770233619-saia-forrada-florida-tam-m-cintura-33cm-comprimento-81cm ### Optional Parameters - country (string): The country domain for Vinted - Default: com - Options: See supported countries table above - Example: pt for Portugal ### Input Schema Example json { "productUrl": "https://www.vinted.pt/items/6770233619-saia-forrada-florida-tam-m-cintura-33cm-comprimento-81cm", "country": "pt" } ## Output Format The actor returns detailed information about similar products in the following structure: ### Main Output Object json { "productUrl": "string", "country": "string", "similarProducts": [ { "id": "number", "user_id": "number", "title": "string", "is_visible": "boolean", "is_hidden": "boolean", "is_reserved": "boolean", "is_closed": "boolean", "is_for_sell": "boolean", "user": { "id": "number", "login": "string", "photo": "object|null", "profile_url": "string", "business": "boolean" }, "path": "string", "currency": "string", "price": { "amount": "string", "currency_code": "string" }, "promoted": "boolean", "favourite_count": "number", "is_favourite": "boolean", "url": "string", "photo": { "id": "number", "width": "number", "height": "number", "dominant_color": "string", "url": "string", "thumbnails": "array", "full_size_url": "string" }, "brand_title": "string", "service_fee": { "amount": "string", "currency_code": "string" }, "total_item_price": { "amount": "string", "currency_code": "string" }, "size_title": "string", "size": "string", "status": "string" } ], "totalCount": "number", "timestamp": "string" } ### Sample Output json { "productUrl": "https://www.vinted.pt/items/6770233619-saia-forrada-florida-tam-m-cintura-33cm-comprimento-81cm", "country": "pt", "similarProducts": [ { "id": 6619796506, "user_id": 21950948, "title": "Falda nueva sin estrenar talla M . Excelente calidad marca Hirsch", "is_visible": true, "is_for_sell": true, "user": { "id": 21950948, "login": "muack", "profile_url": "https://www.vinted.pt/member/21950948", "business": false }, "currency": "EUR", "price": { "amount": "4.0", "currency_code": "EUR" }, "favourite_count": 2, "url": "https://www.vinted.pt/items/6619796506-falda-nueva-sin-estrenar-talla-m-excelente-calidad-marca-hirsch", "brand_title": "Local", "size_title": "M / 38 / 10", "status": "New without tags", "total_item_price": { "amount": "4.9", "currency_code": "EUR" } } ], "totalCount": 24, "timestamp": "2025-07-30T13:32:29.981Z" } ## Key Features of Output Data ### Product Information - Basic Details: ID, title, visibility status, selling status - Pricing: Original price, service fees, total price including buyer protection - Images: High-resolution photos with multiple thumbnail sizes - Metadata: Brand, size, condition status, view count, favorite count ### Seller Information - User Details: ID, username, profile URL, business account status - Profile Photo: User avatar with multiple thumbnail sizes (if available) ### Additional Data - URLs: Direct links to product pages and seller profiles - Status Indicators: Reserved, closed, promoted status - Service Information: Buyer protection fees and total costs ## Error Handling The actor handles various error scenarios: ### Successful Response with No Results json { "productUrl": "https://www.vinted.pt/items/example", "country": "pt", "similarProducts": [], "totalCount": 0, "error": "No similar products retrieved", "timestamp": "2025-07-30T13:32:29.981Z" } ### Error Response json { "productUrl": "https://www.vinted.pt/items/example", "country": "pt", "similarProducts": [], "totalCount": 0, "error": "Error message description", "timestamp": "2025-07-30T13:32:29.981Z" } ## Usage Instructions ### Basic Usage 1. Set Input Parameters: Provide at minimum the productUrl parameter 2. Run Actor: Execute the actor through Apify Console or API 3. Retrieve Results: Access results from the dataset or key-value store ### Advanced Usage javascript // Example API call const input = { productUrl: "https://www.vinted.pt/items/6770233619-saia-forrada-florida-tam-m-cintura-33cm-comprimento-81cm", country: "pt" }; // Run actor const run = await apifyClient.actor('your-actor-id').call(input); // Get results const dataset = await apifyClient.dataset(run.defaultDatasetId).listItems(); ### URL Format Requirements The product URL must follow this pattern: - Domain: https://www.vinted.[country-code]/ - Path: items/[numeric-id]-[product-title-slug] - Example: https://www.vinted.pt/items/6770233619-saia-forrada-florida-tam-m-cintura-33cm-comprimento-81cm ## Data Storage The actor stores results in two locations: 1. Dataset: Each run creates records in the default dataset 2. Key-Value Store: Results are also saved with the key similar_products ## Performance Notes - The actor processes one product URL per run - Similar products are typically returned in batches (commonly 20-30 items) - Response time varies based on Vinted's server response and network conditions - Country validation is performed but non-supported countries may still work with warnings ## 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. ---