Tradera
Tradera
/tradera/v1/search1 creditSearch Tradera — live listings, sold listings or unsold ones — across both sale types. Every filter is optional, but give at least `query` or `category_id` so the answer means something. Auction rows and fixed-price rows carry different fields: an auction has starting_bid/current_bid/bid_count/ends_at, a buy-now listing has buy_now_price. A field the listing does not have is null. All amounts are in SEK.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Free-text search over listing title and description, in Swedish (e.g. 'rolex', 'iittala vas', 'lego star wars'). Leave it out and give `category_id` to browse a whole category instead. |
| category_id | optional | 1– | Restrict to one Tradera category by its numeric id. Call the `categories` action for the ids, their names and how many matching listings each holds. |
| status = live | optional | live · sold · unsold | Which side of the marketplace to search. 'live' = still running; 'sold' and 'unsold' are the two halves of the closed archive and are separate queries — a closed listing is NOT automatically a sale. |
| listing_type = any | optional | any · auction · fixed_price · contact_only | Tradera sells two ways and the fields differ. 'auction' covers timed auctions (including ones that also carry a buy-now price); 'fixed_price' covers buy-now listings. Read `listing_type` on each row to tell them apart. |
| seller_type = any | optional | any · private · company | Restrict to private sellers or to companies. |
| county | optional | HelaSverige · Blekinge · Dalarna · Gavleborg · Gotland · Halland · Jamtland · Jonkoping · Kalmar · Kronoberg · Norrbotten · Skane · Sodermanland · Stockholm · Uppsala · Varmland · Vasterbotten · Vasternorrland · Vastmanland · VastraGotaland · Orebro · Ostergotland | Restrict to sellers in one Swedish county (Tradera's own spelling, without diacritics). 'HelaSverige' means the whole country, i.e. no restriction. |
| sort = relevance | optional | relevance · ending_soonest · newest · price_high_first · price_low_first · price_with_shipping_high_first · price_with_shipping_low_first · most_bids · least_bids · most_wishlisted | Row order. The price orders rank by the row's own price, which for an auction with no bids is its starting price. |
| min_price | optional | 0– | Lowest price in SEK (inclusive). Tradera applies it to the row's own price. |
| max_price | optional | 0– | Highest price in SEK (inclusive). |
| page = 1 | optional | 1–125 | 1-based page of 80 listings. Tradera serves at most 10,000 listings per query, so the last reachable page is 125 — narrow the query to reach deeper listings. |
| max_results = 80 | optional | 1–80 | How many of the page's listings to return, 1-80. Tradera's page size is fixed at 80; a smaller number just trims the answer. |
/tradera/v1/detail1 creditOne Tradera listing in full: the seller's own description and attributes, the category path, every image, the shipping and payment options, the seller's profile and rating, and — for an auction — the opening bid, the leading bid and the next valid bid. Takes the numeric item id or any tradera.com item URL.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| item | required | — | The numeric Tradera item id, or a full item URL such as https://www.tradera.com/item/1923/748340097/… |
/tradera/v1/categories1 creditTradera's category tree with a live listing count per category — the ids the `category_id` filter takes. Scope it with `query` and/or `category_id` to see how a search splits across categories, or call it bare for the top level. Also returns the attribute facets (brand, condition, colour…) Tradera publishes for that scope.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| query | optional | — | Free-text search over listing title and description, in Swedish (e.g. 'rolex', 'iittala vas', 'lego star wars'). Leave it out and give `category_id` to browse a whole category instead. |
| category_id | optional | 1– | Restrict to one Tradera category by its numeric id. Call the `categories` action for the ids, their names and how many matching listings each holds. |
| status = live | optional | live · sold · unsold | Which side of the marketplace to search. 'live' = still running; 'sold' and 'unsold' are the two halves of the closed archive and are separate queries — a closed listing is NOT automatically a sale. |
/tradera/v1/seller1 creditA Tradera seller's public profile — alias, city, member-since, rating count and detailed seller rating, follower counts, company flag — together with their currently active listings. Takes the numeric member id, which every search row and listing carries as `seller.member_id`.
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| member_id | required | 1– | The seller's numeric Tradera member id, as returned in `seller.member_id` by `search` and `detail`. |
| page = 1 | optional | 1–125 | 1-based page of 80 listings. Tradera serves at most 10,000 listings per query, so the last reachable page is 125 — narrow the query to reach deeper listings. |
| max_results = 80 | optional | 1–80 | How many of the page's listings to return, 1-80. Tradera's page size is fixed at 80; a smaller number just trims the answer. |
curl -X POST https://api.reefapi.com/tradera/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"rolex","max_results":10}'{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.
Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.
Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.
No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.
Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.