Vinted Product Description Actor

A powerful Apify actor for scraping detailed product information from Vinted listings across multiple countries and domains.

Overview

The Vinted Product Description Actor extracts comprehensive product data from Vinted marketplace listings, including product details, pricing, seller information, images, and metadata. It supports all major Vinted domains and provides structured JSON output for easy integration.

Features

• ✅ Multi-country support - Works with 22 Vinted domains
• ✅ Comprehensive data extraction - Product details, pricing, seller info, images
• ✅ Error handling - Robust error handling and logging
• ✅ Structured output - Clean JSON format with timestamps
• ✅ Data storage - Automatic dataset and key-value store integration

Supported Countries

The actor supports the following Vinted domains:

Country	Domain	Code
International	vinted.com	com
France	vinted.fr	fr
Germany	vinted.de	de
Spain	vinted.es	es
Italy	vinted.it	it
Belgium	vinted.be	be
Netherlands	vinted.nl	nl
Austria	vinted.at	at
Switzerland	vinted.ch	ch
Czech Republic	vinted.cz	cz
Denmark	vinted.dk	dk
Finland	vinted.fi	fi
Hungary	vinted.hu	hu
Lithuania	vinted.lt	lt
Latvia	vinted.lv	lv
Luxembourg	vinted.lu	lu
Poland	vinted.pl	pl
Portugal	vinted.pt	pt
Romania	vinted.ro	ro
Sweden	vinted.se	se
Slovakia	vinted.sk	sk
Slovenia	vinted.si	si

Input Configuration

Required Parameters

Parameter	Type	Description
productUrl	String	Complete Vinted product URL to scrape

Optional Parameters

Parameter	Type	Default	Description
country	String	com	Country domain code for Vinted

Input Schema

{
  "productUrl": "https://www.vinted.pt/items/6770233619-saia-forrada-florida-tam-m-cintura-33cm-comprimento-81cm",
  "country": "pt"
}

URL Format Requirements

Product URLs must follow this pattern:

https://www.vinted.[domain]/items/[product-id]-[product-slug]

Example valid URLs:

• https://www.vinted.com/items/1234567890-blue-dress-size-m
• https://www.vinted.fr/items/9876543210-chemise-homme-taille-l
• https://www.vinted.pt/items/6770233619-saia-forrada-florida-tam-m-cintura-33cm-comprimento-81cm

Output Format

The actor returns comprehensive product data in the following structure:

{
  "productUrl": "https://www.vinted.pt/items/6770233619-saia-forrada-florida-tam-m-cintura-33cm-comprimento-81cm",
  "country": "pt",
  "timestamp": "2025-07-29T07:45:43.672Z",
  "product": {
    "id": 6770233619,
    "title": "Saia forrada, florida. Tam M. Cintura 33cm. Comprimento 81cm.",
    "description": "Novo sem etiqueta. Há várias peças a preços incríveis, fazendo conjunto recebe um desconto 🤗",
    "status_id": 1,
    "disposal_conditions": 4,
    "catalog_id": 199,
    "currency": "EUR",
    "price": {
      "amount": "7.5",
      "currency_code": "EUR"
    },
    "brand_dto": {
      "id": 226316,
      "title": "Local",
      "slug": "local"
    },
    "color1": "White",
    "status": "New without tags",
    "favourite_count": 16,
    "is_favourite": false,
    "is_sold": true,
    "photos": [
      {
        "id": 27536090505,
        "image_no": 1,
        "width": 590,
        "height": 800,
        "url": "https://images1.vinted.net/t/01_0033f_eoHbJxPUsuJaT9Zwvkno1yTL/f800/1753770337.jpeg",
        "is_main": true,
        "thumbnails": [...]
      }
    ],
    "user": {
      "id": 74292334,
      "login": "acvs80",
      "country_id": 21,
      "feedback_count": 270,
      "feedback_reputation": 1,
      "city": "Guimarães",
      "item_count": 61,
      "followers_count": 138,
      "following_count": 4
    }
  }
}

Key Data Fields

Product Information

• id - Unique product identifier
• title - Product title/name
• description - Seller's product description
• status - Condition (e.g., "New without tags", "Used - Good")
• color1 - Primary color
• brand_dto - Brand information
• is_sold - Whether item has been sold

Pricing

• price.amount - Item price
• price.currency_code - Currency (EUR, USD, etc.)
• service_fee - Platform service fee
• total_item_price - Total price including fees

Images

• photos - Array of product images
• url - High-resolution image URL
• thumbnails - Various sized thumbnails
• is_main - Indicates main product image

Seller Information

• user.login - Seller username
• user.feedback_count - Number of reviews
• user.feedback_reputation - Seller rating
• user.city - Seller location
• user.item_count - Total items for sale

Usage Examples

Basic Usage

// Input
{
  "productUrl": "https://www.vinted.com/items/1234567890-blue-summer-dress"
}

Multi-country Usage

// Scrape from French Vinted
{
  "productUrl": "https://www.vinted.fr/items/9876543210-robe-ete-bleue",
  "country": "fr"
}

// Scrape from German Vinted
{
  "productUrl": "https://www.vinted.de/items/5555555555-blaues-sommerkleid",
  "country": "de"
}

Data Storage

The actor automatically stores data in two locations:

Dataset

All scraped products are pushed to the default dataset with the following structure:

• productUrl - Original product URL
• country - Country domain used
• product - Complete product data
• timestamp - ISO timestamp of scraping
• error - Error message (if applicable)

Key-Value Store

The latest product data is saved to the key-value store under the key product_description.

Error Handling

The actor includes comprehensive error handling:

Common Error Scenarios

• Invalid URL format - Returns validation error
• Product not found - Returns null product data
• Network issues - Retries with exponential backoff
• Rate limiting - Handles API rate limits gracefully

Error Output Format

{
  "productUrl": "https://www.vinted.com/items/invalid-url",
  "country": "com",
  "error": "Product not found or URL invalid",
  "timestamp": "2025-07-29T08:00:00.000Z",
  "product": null
}

Rate Limits and Best Practices

Recommended Settings

• Memory: 1024 MB minimum
• Timeout: 300 seconds for single products
• Concurrent runs: Limited by Vinted's rate limits

Best Practices

1. URL validation - Ensure URLs match the required format
2. Country matching - Use the correct country code for the domain
3. Batch processing - For multiple products, add delays between requests
4. Error monitoring - Check the dataset for failed scrapes

Integration Examples

Using the Data

// Access scraped data from dataset
const dataset = await Actor.openDataset();
const items = await dataset.getData();

items.items.forEach(item => {
  if (item.product) {
    console.log(`Product: ${item.product.title}`);
    console.log(`Price: ${item.product.price.amount} ${item.product.price.currency_code}`);
    console.log(`Seller: ${item.product.user.login}`);
  }
});

API Integration

// Use with Apify API
const client = new ApifyClient({ token: 'your-token' });

const run = await client.actor('the-actor-id').call({
  productUrl: 'https://www.vinted.com/items/1234567890-product-name',
  country: 'com'
});

const dataset = await client.dataset(run.defaultDatasetId).listItems();
console.log(dataset.items[0]);

Troubleshooting

Common Issues

"Product not found"

• Verify the URL is correct and accessible
• Check if the product is still available (not deleted)
• Ensure the country code matches the domain

"Invalid URL format"

• URL must include the complete path with product ID
• Remove any query parameters or fragments
• Ensure the domain matches supported countries

"Rate limit exceeded"

• Reduce concurrent requests
• Add delays between scraping sessions
• Consider upgrading your Apify plan

Debug Information

The actor provides detailed logging:

• Input validation results
• HTTP request/response details
• Data extraction progress
• Error stack traces

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.

---