tradera.com APItradera.com ↗
Access Tradera.com auction and fixed-price listings via API. Search items, retrieve seller ratings, shipping options, bid counts, and item attributes.
curl -X GET 'https://api.parse.bot/scraper/956803de-aead-4645-9c37-2732b14f44ff/search_listings?page=1&query=lego' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for product listings on Tradera including auctions and fixed-price items. Returns paginated results with item summaries.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number to retrieve (1-indexed) |
| queryrequired | string | Search keyword or phrase (e.g. 'lego', 'nike skor') |
{
"type": "object",
"fields": {
"items": "array of listing objects with itemId, title, price, currency, buyNowPrice, totalBids, itemType, endDate, itemUrl, sellerAlias, sellerMemberId, categoryId, condition",
"query": "string echoing the search query",
"pagination": "object with currentPage, totalPages, totalItems"
},
"sample": {
"data": {
"items": [
{
"price": 114,
"title": "Nike Skor, Black, EUR 39",
"itemId": 726273303,
"endDate": "2026-06-09T18:54:25.2670000Z",
"itemUrl": "https://www.tradera.com/item/340303/726273303/nike-skor-black-eur-39",
"currency": "SEK",
"itemType": "PureBin",
"condition": "Gott skick",
"totalBids": 0,
"categoryId": 340303,
"buyNowPrice": 114,
"sellerAlias": "Kimkim928",
"sellerMemberId": 5105708
}
],
"query": "nike skor",
"pagination": {
"totalItems": 10000,
"totalPages": 125,
"currentPage": 1
}
},
"status": "success"
}
}About the tradera.com API
The Tradera API provides 2 endpoints for accessing Sweden's largest online marketplace, covering both auction and fixed-price listings. The search_listings endpoint returns paginated item summaries including prices, bid counts, and seller aliases, while get_item_details retrieves full listing data across 15+ fields such as seller ratings, shipping options, item condition, and image URLs.
Search Listings
The search_listings endpoint accepts a required query string (e.g. 'lego' or 'nike skor') and an optional page integer for pagination. It returns an array of item objects, each containing itemId, title, price, currency, buyNowPrice, totalBids, itemType, endDate, itemUrl, and sellerAlias. The pagination object includes currentPage, totalPages, and totalItems, making it straightforward to walk through result sets programmatically.
Item Details
The get_item_details endpoint takes an item_id sourced from search results and returns a full listing record. The seller object includes alias, totalRating, detailedRating, memberId, isCompany, city, and country — useful for assessing seller reputation without visiting the listing page. The shipping array contains one or more option objects with provider, cost, toCountryCodeIso2, and fromCountryCodeIso2. The itemType field distinguishes between Auction, PureBin (fixed-price only), AuctionBin (auction with buy-now), and ShopItem.
Item Types and Auction Data
Tradera mixes auction-format and fixed-price listings in the same search index. The itemType field in both endpoints lets you filter downstream. For auctions, totalBids and endDate (ISO 8601) are the key fields for tracking competition and timing. The buyNowPrice field is populated for AuctionBin listings where a direct purchase option exists alongside bidding.
- Track auction price trends for a specific product category by polling
search_listingsover time and recordingpriceandtotalBids. - Build a seller reputation checker using
get_item_detailsto surfacetotalRatinganddetailedRatingbefore a purchase decision. - Aggregate shipping cost data across listings by extracting the
shippingarray fromget_item_detailsresponses. - Monitor
endDateon auctions to build a deal-alert tool that flags listings closing within a set time window. - Compare
priceagainstbuyNowPriceacrossAuctionBinlistings to identify underpriced buy-now opportunities. - Filter Swedish marketplace inventory by
conditionanditemTypeto surface only fixed-price (PureBin) listings in specific states. - Identify active sellers by collecting
sellerAliasandisCompanydata across paginated search results.
| 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 Tradera have an official developer API?+
What does the `itemType` field in search results actually distinguish?+
itemType returns one of four values: Auction (bid-only), PureBin (fixed-price only), AuctionBin (auction with a buy-now option), or ShopItem (seller shop item). This lets you filter the result set to the format relevant to your use case before fetching item details.Does the API return historical sold prices or completed auction results?+
How deep does pagination go in `search_listings`?+
pagination object returns currentPage, totalPages, and totalItems. You can iterate through all pages by incrementing the page parameter up to totalPages. Very broad queries may return large page counts; narrow your query string to reduce result sets to a manageable size.Does `get_item_details` return buyer or bidder information?+
seller object) and listing metadata, but not bidder identities or buyer history. If you need bid-level data, you can fork this API on Parse and revise it to add an endpoint targeting the bid history view for a given listing.