vinted.fi APIvinted.fi ↗
Access Vinted.fi secondhand marketplace data: search listings by keyword and filters, retrieve full item details, and fetch user profile and wardrobe info.
curl -X GET 'https://api.parse.bot/scraper/2a3df212-cb44-4b61-b5fa-1e7ac9d4001b/search_listings?page=1&order=relevance&query=nike' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for product listings on Vinted.fi by keyword and optional filters. Returns paginated results from the catalog page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination. |
| order | string | Sort order. Accepted values: relevance, newest_first, price_low_to_high, price_high_to_low. |
| query | string | Search keyword (e.g. 'nike', 'adidas takki') |
| price_to | number | Maximum price filter in EUR. |
| price_from | number | Minimum price filter in EUR. |
| catalog_ids | string | Catalog/category IDs to filter by (e.g. '1206' for outerwear/jackets). |
{
"type": "object",
"fields": {
"page": "integer, current page number",
"items": "array of listing objects, each containing id, url, thumbnail, title, price, size, and condition",
"query": "string or null, the search query used"
},
"sample": {
"data": {
"page": 1,
"items": [
{
"id": "8790821400",
"url": "https://www.vinted.fi/items/8790821400-nike-space-hippie-04?referrer=catalog",
"size": "43",
"price": "27.08",
"title": "Nike Space Hippie 04",
"condition": "Erittäin hyvä",
"thumbnail": "https://images1.vinted.net/t/06_002d6_xS1qb8SCRbrb6Xu8bRWHAPkH/310x430/1777619178.webp?s=..."
}
],
"query": "nike"
},
"status": "success"
}
}About the vinted.fi API
The Vinted.fi API provides 3 endpoints to query the Finnish Vinted secondhand marketplace, covering listing search, full item detail pages, and seller profile data. The search_listings endpoint accepts keyword queries, price range filters, category IDs, and sort orders, returning paginated arrays of items with price, size, condition, and thumbnail. The get_listing_details and get_user_profile endpoints expose deeper fields including brand, seller identity, images, follower counts, and recent activity.
Listing Search
The search_listings endpoint queries the Vinted.fi catalog and returns paginated results. Each item in the items array includes id, url, thumbnail, title, price, size, and condition. You can narrow results using price_from and price_to (in EUR), catalog_ids for category filtering (for example, 1206 targets outerwear/jackets), and order for sorting by relevance, newest_first, price_low_to_high, or price_high_to_low. The query parameter accepts Finnish-language terms as well as brand names.
Listing Details
The get_listing_details endpoint accepts either a numeric item ID or a full Vinted.fi item URL via the item_id_or_url parameter. It returns a richer field set: brand, description (seller-written text), images (array of full-resolution URLs), condition, currency, and a seller object with username, id, and url. This is the endpoint to use when you need the full item description or want to resolve a seller identity from a search result.
User Profiles
The get_user_profile endpoint takes a numeric user ID or a Vinted member URL. It returns username, location, followers, following, last_active, and reviews counts. The listings array contains the user's current wardrobe items, each with id, title, price, currency, brand, size, status, url, and thumbnail — useful for monitoring a specific seller's active inventory or comparing wardrobe composition across users.
- Track price trends for specific brands by querying
search_listingswith brand keywords andprice_from/price_tofilters over time - Build a wardrobe monitoring tool that polls
get_user_profilefor new listings in a seller's active inventory - Aggregate full item descriptions and multi-image arrays from
get_listing_detailsto train secondhand clothing classifiers - Compare seller reputation across profiles using
followers,reviews, andlast_activefields - Filter Finnish-language listings by category via
catalog_idsto build niche category feeds (e.g. jackets, shoes) - Cross-reference listing prices from search results with full item details to flag underpriced items by condition and brand
- Compile seller contact points and profile URLs for reseller research using the
sellerobject returned in item detail responses
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Vinted have an official public developer API?+
What does `get_listing_details` return beyond what search results include?+
id, title, price, size, condition, and thumbnail. The get_listing_details endpoint adds brand, description (the seller's full written text), an images array of full-resolution URLs, currency, and a structured seller object containing username, id, and profile url. You can pass either a numeric ID or a full Vinted item URL to the item_id_or_url parameter.Does the API cover Vinted marketplaces outside Finland, such as vinted.de or vinted.fr?+
Does the profile endpoint return transaction history or sold item data?+
get_user_profile endpoint returns active wardrobe listings, along with followers, following, reviews, location, and last_active. Sold or completed transaction history is not currently exposed. You can fork the API on Parse and revise it to add an endpoint targeting sold items if that data is accessible on the profile page.Is there a limit to how many pages of search results the API can return?+
search_listings endpoint supports a page integer parameter for pagination, but the maximum accessible page depth depends on what Vinted.fi surfaces for a given query. Deep pagination (very high page numbers) may return empty items arrays once results are exhausted. Test with your specific query and filter combination to determine the practical depth.