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

{
  "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

{
  "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

{
  "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

{
  "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

{
  "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

// 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.

---