Vinted Product Search Actor

Overview

This actor is a web scraping tool for the Vinted marketplace. It searches and extracts product listings from Vinted across multiple countries, returning structured data like prices, images, and seller details.

Key Features

• Search & Pagination: Search by keyword and browse multiple pages of results.
• Multi-Country Support: Search across 13 Vinted country domains (e.g., vinted.fr, vinted.de).
• Filtering: Filter results by category, size, brand, condition, color, and material using IDs.
• Sorting: Sort results by newest, price (high/low), or relevance.
• Data Extraction: Retrieves comprehensive product details including title, price, brand, images, and seller info.

How to Use

Configure the actor with input parameters. Only the query is required.

Input Parameters

Required:
* query (String): Your search term (e.g., "nike shoes").

Key Optional Parameters:
* country (String): Country domain code. Default is "com" (global). Use codes like "fr", "de", or "es".
* page (Integer): Page number for pagination. Default is 1.
* perPage (Integer): Items per page (max 96). Default is 96.
* orderBy (String): Sort order. Options: "newest_first", "price_low_to_high", "price_high_to_low", "relevance".
* Filter IDs: Provide comma-separated IDs for precise filtering:
* catalogIds: Category IDs.
* sizeIds: Size IDs.
* brandIds: Brand IDs.
* statusIds: Condition IDs.
* colorIds: Color IDs.
* materialIds: Material IDs.

Example Input:

{
  "query": "boots",
  "page": 1,
  "country": "fr",
  "orderBy": "price_low_to_high",
  "brandIds": "53,88"
}

Input/Output

Output Format

The actor returns a JSON object with the search metadata and an array of products.

Main Output Structure:

{
  "query": "boots",
  "page": "1",
  "country": "fr",
  "totalResults": 2450,
  "products": [...],
  "pagination": {...},
  "timestamp": "2023-10-26T10:30:00.000Z"
}

Product Object (within the products array) includes:
* id: Unique product identifier.
* title: Product title/name.
* price: Object with amount and currency.
* brand_title: Brand name.
* url: Link to the product page.
* photo: Object containing image URLs.
* user: Object with seller information (e.g., login, feedback_reputation).

The output provides all necessary data to process listings, including pagination details to navigate through result sets.