Vinted Product Search Actor

Overview

The Vinted Product Search Actor is a web scraping tool designed to search and extract product information from the Vinted marketplace. This actor allows you to search for products across different Vinted country domains, apply various filters, and retrieve detailed product data including pricing, seller information, images, and more.

Features

• 🔍 Product Search: Search for products using keywords across Vinted marketplace
• 🌍 Multi-Country Support: Search across 13 different Vinted country domains
• 📄 Pagination: Browse through multiple pages of search results
• 🎛️ Advanced Filtering: Filter by category, size, brand, condition, color, and material
• 📊 Sorting Options: Sort results by newest, price, or relevance
• 📸 Complete Product Data: Extract comprehensive product information including images, pricing, and seller details

Supported Countries

The actor supports the following Vinted country domains:

Country	Code	Domain
Global	com	vinted.com
Portugal	pt	vinted.pt
France	fr	vinted.fr
Germany	de	vinted.de
Spain	es	vinted.es
Italy	it	vinted.it
Belgium	be	vinted.be
Netherlands	nl	vinted.nl
Czech Republic	cz	vinted.cz
Slovakia	sk	vinted.sk
Lithuania	lt	vinted.lt
Latvia	lv	vinted.lv
Luxembourg	lu	vinted.lu

Input Parameters

Required Parameters

Parameter	Type	Description	Example
query	String	Search term for products	"nike shoes", "summer dress"

Optional Parameters

Parameter	Type	Default	Description	Example
page	Integer	1	Page number for pagination	1, 2, 3
perPage	Integer	96	Number of items per page (max 96)	50, 96
country	String	"com"	Country domain code	"pt", "fr", "de"
orderBy	String	"newest_first"	Sort order	"price_low_to_high", "relevance"
catalogIds	String	""	Comma-separated category IDs	"1,2,3"
sizeIds	String	""	Comma-separated size IDs	"206,207,208"
brandIds	String	""	Comma-separated brand IDs	"53,88,304"
statusIds	String	""	Comma-separated condition IDs	"1,2,3"
colorIds	String	""	Comma-separated color IDs	"1,2,3"
materialIds	String	""	Comma-separated material IDs	"1,2,3"

Sort Options

• newest_first - Sort by newest listings first
• price_low_to_high - Sort by price ascending
• price_high_to_low - Sort by price descending
• relevance - Sort by search relevance

Input Example

{
  "query": "boots",
  "page": 1,
  "perPage": 96,
  "country": "com",
  "orderBy": "newest_first",
  "catalogIds": "",
  "sizeIds": "",
  "brandIds": "",
  "statusIds": "",
  "colorIds": "",
  "materialIds": ""
}

Output Format

The actor returns a JSON object containing the search results with the following structure:

Main Output Object

Field	Type	Description
query	String	The search query used
page	String	Current page number
perPage	String	Items per page
country	String	Country domain used
orderBy	String	Sort order applied
filters	Object	Applied filters
totalResults	Number	Total number of results found
products	Array	Array of product objects
pagination	Object	Pagination information
timestamp	String	ISO timestamp of the search

Product Object Structure

Each product in the products array contains:

Field	Type	Description
id	Number	Unique product ID
title	String	Product title
price	Object	Price information (amount, currency)
brand_title	String	Brand name
path	String	Product URL path
url	String	Full product URL
photo	Object	Main product image information
user	Object	Seller information
size_title	String	Product size
status	String	Product condition
favourite_count	Number	Number of favorites
view_count	Number	Number of views
service_fee	Object	Vinted service fee
total_item_price	Object	Total price including fees

Pagination Object

Field	Type	Description
current_page	Number	Current page number
total_pages	Number	Total number of pages
total_entries	Number	Total number of products
per_page	Number	Items per page
time	Number	Unix timestamp

Output Example

{
  "query": "boots",
  "page": "1",
  "perPage": "96",
  "country": "com",
  "orderBy": "newest_first",
  "filters": {
    "catalogIds": "",
    "sizeIds": "",
    "brandIds": "",
    "statusIds": "",
    "colorIds": "",
    "materialIds": ""
  },
  "totalResults": 960,
  "products": [
    {
      "id": 6777712452,
      "title": "Western style black cowboy boots",
      "price": {
        "amount": "25.0",
        "currency_code": "USD"
      },
      "brand_title": "NO LABEL",
      "path": "/items/6777712452-western-style-black-cowboy-boots",
      "url": "https://www.vinted.com/items/6777712452-western-style-black-cowboy-boots",
      "photo": {
        "id": 27566964484,
        "url": "https://images1.vinted.net/t/03_01452_UNE7mywriJbTPPVkLckfwgjt/f800/1753871869.jpeg",
        "width": 800,
        "height": 600,
        "dominant_color": "#98968A"
      },
      "user": {
        "id": 235470340,
        "login": "dionnamarie",
        "profile_url": "https://www.vinted.com/member/235470340-dionnamarie"
      },
      "size_title": "7.5",
      "status": "Very good",
      "favourite_count": 0,
      "view_count": 0,
      "service_fee": {
        "amount": "1.95",
        "currency_code": "USD"
      },
      "total_item_price": {
        "amount": "26.95",
        "currency_code": "USD"
      }
    }
  ],
  "pagination": {
    "current_page": 1,
    "total_pages": 10,
    "total_entries": 960,
    "per_page": 96,
    "time": 1753872030
  },
  "timestamp": "2025-07-30T10:40:31.208Z"
}

Usage Examples

Basic Product Search

{
  "query": "nike sneakers"
}

Search with Filters

{
  "query": "dress",
  "country": "fr",
  "orderBy": "price_low_to_high",
  "perPage": 50,
  "sizeIds": "206,207,208"
}

Paginated Search

{
  "query": "boots",
  "page": 2,
  "perPage": 48,
  "orderBy": "newest_first"
}

Error Handling

The actor includes comprehensive error handling:

• Missing Query: Throws an error if the required query parameter is not provided
• Invalid Country: Warns if an unsupported country code is used but continues execution
• Search Failures: Returns error information in the output if the search fails
• No Results: Returns an empty products array with appropriate metadata if no products are found

Rate Limiting and Best Practices

• The actor respects Vinted's servers and implements appropriate delays
• Use reasonable perPage values (maximum 96)
• For large datasets, use pagination instead of very high perPage values
• Monitor your usage to avoid overwhelming the target website

Data Storage

The actor stores results in two ways:

1. Dataset: All search results are pushed to the actor's dataset
2. Key-Value Store: A summary of the search is saved to the key-value store under the key search_results

Use Cases

• Price Monitoring: Track prices of specific products across different markets
• Market Research: Analyze product availability and pricing trends
• Inventory Management: Monitor competitor listings and pricing
• Data Analysis: Collect data for fashion and retail analytics
• Personal Shopping: Find specific items across multiple Vinted markets

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.

---