Pricing

Rating

Developer

Actor stats

Categories

Share

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:

Input Parameters

Required Parameters

Optional Parameters

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

Product Object Structure

Each product in the products array contains:

Pagination Object

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.