Tradera APItradera.com ↗
Access Tradera listings via API. Search auctions and fixed-price items, retrieve seller ratings, shipping options, images, and bid counts from Sweden's largest marketplace.
What is the Tradera API?
The Tradera API exposes 2 endpoints for querying and inspecting listings on Sweden's largest auction and fixed-price marketplace. Use search_listings to run full-text searches returning up to 50 paginated item summaries per page — including price, bid count, itemType, and seller alias — then drill into any result with get_item_details to retrieve images, shipping options, seller ratings, and the full item description.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace tradera-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: Tradera SDK — search listings, drill into details, handle errors."""
from parse_apis.tradera_scraper_api import Tradera, ItemType, ItemNotFound
client = Tradera()
# Search for Lego listings — limit caps total items fetched across pages.
for listing in client.listingsummaries.search(query="lego", limit=5):
print(listing.title, listing.price, listing.item_type)
# Drill into the first result for full details (seller, shipping, images).
summary = client.listingsummaries.search(query="nike skor", limit=1).first()
if summary:
detail = summary.details()
print(detail.title, detail.current_price, detail.end_date)
print(detail.seller.alias, detail.seller.total_rating, detail.seller.city)
for option in detail.shipping:
print(option.provider, option.cost, option.to_country)
# Fetch a listing directly by ID and handle not-found errors.
try:
item = client.listings.get(item_id="735229927")
print(item.title, item.item_type, item.total_bids)
except ItemNotFound as exc:
print(f"Item not found: {exc.item_id}")
print("exercised: listingsummaries.search / summary.details / listings.get / ItemNotFound")
Full-text search across Tradera listings (auctions and fixed-price). Returns paginated item summaries with seller info and pricing. Pagination via integer page counter; each page returns up to 50 items. The query matches titles and descriptions server-side.
| 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 summary 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": 355,
"title": "Lego The Child 75318",
"itemId": 735229927,
"endDate": "2026-06-11T09:13:51.2150000Z",
"itemUrl": "https://www.tradera.com/item/180405/735229927/lego-the-child-75318",
"currency": "SEK",
"itemType": "Auction",
"condition": "Gott skick",
"totalBids": 0,
"categoryId": 180405,
"buyNowPrice": 0,
"sellerAlias": "jes_m84",
"sellerMemberId": 1698138
}
],
"query": "lego",
"pagination": {
"totalItems": 10000,
"totalPages": 125,
"currentPage": 1
}
},
"status": "success"
}
}About the Tradera API
Search Listings
The search_listings endpoint accepts a query string (e.g. 'lego' or 'nike skor') and an optional integer page parameter for pagination. Each response returns up to 50 item summaries. The items array contains fields including itemId, title, price, currency, buyNowPrice, totalBids, itemType, endDate, itemUrl, and sellerAlias. The pagination object reports currentPage, totalPages, and totalItems, so you can iterate through the full result set systematically.
Item Details
The get_item_details endpoint takes a numeric item_id — obtained from search_listings results — and returns the full listing record. Response fields include an images array of URL strings, a seller object with alias, totalRating, detailedRating, memberId, isCompany, city, and country, plus shipping as an array of option objects carrying provider, cost, toCountryCodeIso2, and fromCountryCodeIso2. The itemType field distinguishes between Auction, PureBin (fixed-price only), AuctionBin (auction with buy-now), and ShopItem.
Coverage and Scope
All listings are sourced from tradera.com, which operates exclusively in Sweden and prices in SEK. The endDate field is returned as an ISO 8601 string, making it straightforward to filter active versus ended listings in your application logic. The condition field is present on some listings and null on others depending on what the seller provided.
The Tradera API is a managed, monitored endpoint for tradera.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when tradera.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official tradera.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track price trends for specific search terms across Swedish auction listings using
priceandendDatefields. - Monitor competitor seller activity by querying
search_listingsand inspectingsellerAliasandtotalRatingfrom results. - Build a cross-border shipping cost estimator using the
shippingarray withprovider,cost, andtoCountryCodeIso2fields. - Identify buy-now vs. auction opportunities by filtering on
itemTypevalues (Auction,PureBin,AuctionBin,ShopItem). - Aggregate seller reputation data by collecting
totalRatinganddetailedRatingfromget_item_detailsacross multiple listings. - Alert users when specific item keywords appear in new listings by polling
search_listingsand comparingitemIdvalues. - Research second-hand market pricing in Sweden for a given product category using
buyNowPriceandtotalBidsfields.
| 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 | 100 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 public developer API?+
What does the `itemType` field distinguish in `get_item_details`?+
itemType field returns one of four string values: Auction (bid-only listing), PureBin (fixed-price only, no auction), AuctionBin (auction that also has a buy-now price), or ShopItem (store inventory item). This lets you filter or route listings by sale format without inspecting other fields.Does the API return seller contact details or transaction history?+
seller object in get_item_details includes alias, totalRating, detailedRating, memberId, isCompany, city, and country. Transaction history is not exposed. You can fork this API on Parse and revise it to add an endpoint targeting seller profile pages if additional seller-level data is needed.Are category-based browsing or category IDs supported for filtering search results?+
search_listings endpoint filters by full-text query only; there is no category ID or taxonomy parameter. You can fork this API on Parse and revise it to add a category-browse endpoint covering Tradera's category hierarchy.How does pagination behave when a search returns a very large result set?+
pagination response object includes currentPage, totalPages, and totalItems, so you can calculate the full result size and iterate by incrementing the page parameter. Pages are 1-indexed. Requesting a page beyond totalPages will return an empty items array.