Reef AI: ask for any data. Try it
This page is the Tradera parameter reference. What the data is used for, a real sample and pricing are on Tradera API: what you get →
Classifieds & Second-hand

Tradera API & Scraper: parameters and responses

This is the reference for the 4 Tradera endpoints under /tradera/v1 (search, detail, categories and seller) and their 13 parameters. Each endpoint lists its parameters, required or optional, with allowed values and defaults, and comes with a cURL, Python and JavaScript call; every response uses the same { ok, data, meta, error } envelope.

Tradera API returns live Tradera data as clean JSON for tradera The primary endpoint, search, returns {query, status, total_available, page, page_count, currency, results[]} — each result has item_id, url, title, listing_type, is_auction,….

4 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready
Get a free keyOpen in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Tradera scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, detail, categories, seller. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on .

Captured request
{
  "method": "POST",
  "url": "https://api.reefapi.com/tradera/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "query": "rolex",
    "max_results": 10
  }
}
Captured response
{
  "ok": true,
  "meta": {
    "api": "tradera",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 642.3,
    "record_count": 10,
    "bytes": 263522,
    "cache_hit": false,
    "stop_reason": "limit_reached",
    "total_available": 423,
    "page_size": 80,
    "reachable_pages": 6,
    "listing_types": {
      "auction": 2,
      "fixed_price": 8
    },
    "total_is_capped": false,
    "charged_credits": 1,
    "version": "1.0.0",
    "request_id": "d34320ae79b247f3",
    "queue_ms": 1.4,
    "fetched_at": "2026-11-03T17:32:13.196Z"
  },
  "data": {
    "query": "rolex",
    "status": "live",
    "sort": "relevance",
    "filters": {
      "category_id": null,
      "listing_type": "any",
      "seller_type": "any",
      "county": null,
      "min_price": null,
      "max_price": null
    },
    "total_available": 423,
    "total_is_capped": false,
    "page": 1,
    "page_count": 10,
    "currency": "SEK",
    "listing_types": {
      "auction": 2,
      "fixed_price": 8
    },
    "amounts_note": "All amounts are in SEK. On an auction with no bids the figure is the STARTING price (`starting_bid`), not a bid — `current_bid` is null until someone bids.",
    "results": [
      {
        "item_id": 758068447,
        "url": "https://www.tradera.com/item/191506/758068447/rolex-datejust-hafte-september-1996-pa-tyska",
        "title": "ROLEX DATEJUST-häfte, september 1996, på tyska",
        "listing_type": "auction",
        "listing_type_raw": "Auction",
        "is_auction": true,
        "is_buy_now": false,
        "currency": "SEK",
        "starting_bid": 302,
        "current_bid": null,
        "bid_count": 0,
        "reserve_met": false,
        "buy_now_price": null,
        "price_before_discount": null,
        "discount_percent": null,
        "is_ended": false,
        "is_sold": null,
        "final_price": null,
        "starts_at": "2026-10-27T17:37:46Z",
        "ends_at": "2026-11-03T17:37:46Z",
        "category_id": 191506,
        "condition": "Gott skick",
        "is_authenticated_item": false,
        "accepts_offers": false,
        "is_promoted": false,
        "seller": {
          "alias": "NSlivDK",
          "member_id": 6689499,
          "country": "DK",
          "is_company": false
        },
        "free_shipping": false,
        "shipping_options": [
          {
            "provider": "[trimmed-depth]",
            "cost": "[trimmed-depth]"
          },
          {
            "provider": "[trimmed-depth]",
            "cost": "[trimmed-depth]"
          },
          {
            "provider": "[trimmed-depth]",
            "cost": "[trimmed-depth]"
          }
        ],
        "shipping_cost_min": 0,
        "image": "https://img.tradera.net/images/658/665018658_035cd23b-709e-4bc7-93ce-1ed9c3fb42c4.jpg",
        "images": [
          "https://img.tradera.net/images/658/665018658_035cd23b-709e-4bc7-93ce-1ed9c3fb42c4.jpg",
          "https://img.tradera.net/images/658/665018658_778b19de-2b62-4d86-8490-b3a50fda0e2b.jpg"
        ],
        "thumbnail": "https://img.tradera.net/multithumb/658/665018658_035cd23b-709e-4bc7-93ce-1ed9c3fb42c4.jpg"
      },
      {
        "item_id": 757967629,
        "url": "https://www.tradera.com/item/191504/757967629/rolex-metallask",
        "title": "Rolex metallask",
        "listing_type": "fixed_price",
        "listing_type_raw": "PureBin",
        "is_auction": false,
        "is_buy_now": true,
        "currency": "SEK",
        "starting_bid": null,
        "current_bid": null,
        "bid_count": null,
        "reserve_met": null,
        "buy_now_price": 327,
        "price_before_discount": null,
        "discount_percent": null,
        "is_ended": false,
        "is_sold": null,
        "final_price": null,
        "starts_at": "2026-10-26T22:16:47Z",
        "ends_at": "2026-12-25T22:16:47Z",
        "category_id": 191504,
        "condition": "Gott skick",
        "is_authenticated_item": false,
        "accepts_offers": true,
        "is_promoted": false,
        "seller": {
          "alias": "NSlivDK",
          "member_id": 6689499,
          "country": "DK",
          "is_company": false
        },
        "free_shipping": false,
        "shipping_options": [
          {
            "provider": "[trimmed-depth]",
            "cost": "[trimmed-depth]"
          },
          {
            "provider": "[trimmed-depth]",
            "cost": "[trimmed-depth]"
          },
          {
            "provider": "[trimmed-depth]",
            "cost": "[trimmed-depth]"
          }
        ],
        "shipping_cost_min": 0,
        "image": "https://img.tradera.net/images/860/665889860_8d66144c-cb71-488e-bc3b-ef28a6706c37.jpg",
        "images": [
          "https://img.tradera.net/images/860/665889860_8d66144c-cb71-488e-bc3b-ef28a6706c37.jpg",
          "https://img.tradera.net/images/860/665889860_93df905c-06fb-479f-ba52-2903e90cb999.jpg"
        ],
        "thumbnail": "https://img.tradera.net/multithumb/860/665889860_8d66144c-cb71-488e-bc3b-ef28a6706c37.jpg"
      },
      {
        "item_id": 757987292,
        "url": "https://www.tradera.com/item/191504/757987292/rolex-korthallare",
        "title": "Rolex korthållare",
        "listing_type": "auction",
        "listing_type_raw": "Auction",
        "is_auction": true,
        "is_buy_now": false,
        "currency": "SEK",
        "starting_bid": null,
        "current_bid": 110,
        "bid_count": 25,
        "reserve_met": true,
        "buy_now_price": null,
        "price_before_discount": null,
        "discount_percent": null,
        "is_ended": false,
        "is_sold": null,
        "final_price": null,
        "starts_at": "2026-10-27T08:04:35Z",
        "ends_at": "2026-11-07T16:04:35Z",
        "category_id": 191504,
        "condition": "Gott skick",
        "is_authenticated_item": false,
        "accepts_offers": false,
        "is_promoted": false,
        "seller": {
          "alias": "Lennart8",
          "member_id": 5372557,
          "country": "SE",
          "is_company": false
        },
        "free_shipping": false,
        "shipping_options": [
          {
            "provider": "[trimmed-depth]",
            "cost": "[trimmed-depth]"
          }
        ],
        "shipping_cost_min": 22,
        "image": "https://img.tradera.net/images/242/665906242_216a6a3a-631a-4e27-9179-b4e05b517be5.jpg",
        "images": [
          "https://img.tradera.net/images/242/665906242_216a6a3a-631a-4e27-9179-b4e05b517be5.jpg",
          "https://img.tradera.net/images/242/665906242_8c0cb779-1449-4217-9e68-96684caa0527.jpg"
        ],
        "thumbnail": "https://img.tradera.net/multithumb/242/665906242_216a6a3a-631a-4e27-9179-b4e05b517be5.jpg"
      }
    ]
  }
}
Actions

What the Tradera API does

ActionDescriptionConcrete use caseKey params
searchSearch 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.Price-intelligence teams call search to search Tradera.query, category_id, status, listing_type, seller_type, ...
detailOne 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.Classifieds aggregators call detail to get one Tradera listing in full.item
categoriesTradera'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.Resale and arbitrage tools call categories to get tradera's category tree with a live listing count per category.query, category_id, status
sellerA 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`.Lead-generation teams call seller to get a Tradera seller's public profile.member_id, page, max_results
Code samples

Call search from your stack

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}'
MCP one-liner
Ask your MCP-connected assistant: call reefapi.tradera.search with {"query":"rolex","max_results":10}.
Use cases

Who uses this API and why

  • Price-intelligence teams use Tradera to search Tradera.
  • Classifieds aggregators use Tradera to get one Tradera listing in full.
  • Resale and arbitrage tools use Tradera to get tradera's category tree with a live listing count per category.
  • Lead-generation teams use Tradera to get a Tradera seller's public profile.
FAQ

Questions developers ask before integrating

What is the Tradera API?

Tradera API is a ReefAPI endpoint group for tradera It returns live JSON through POST requests under /tradera/v1.

Is the Tradera API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Tradera calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Tradera login or account?

No login to Tradera is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Tradera data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Tradera API use?

Tradera actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Tradera from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call tradera actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Tradera API a Tradera scraper?

It is the managed alternative to a DIY Tradera scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same tradera back as clean JSON.

Why does my Tradera scraper keep getting blocked?

Most Tradera scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

docs / tradera

Tradera

Tradera

base /tradera/v14 endpoints
post/tradera/v1/detail1 credit

One 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.

ParameterAllowed / rangeDescription
itemrequired—The numeric Tradera item id, or a full item URL such as https://www.tradera.com/item/1923/748340097/…
Try in playground →
post/tradera/v1/categories1 credit

Tradera'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.

ParameterAllowed / rangeDescription
queryoptional—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_idoptional1–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 = liveoptionallive · sold · unsoldWhich 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.
Try in playground →
post/tradera/v1/seller1 credit

A 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`.

ParameterAllowed / rangeDescription
member_idrequired1–The seller's numeric Tradera member id, as returned in `seller.member_id` by `search` and `detail`.
page = 1optional1–1251-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 = 80optional1–80How 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.
Try in playground →
Built for volume
5M+ requests a day

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.

Missing a source?
We build it

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.

Support
2 minute median reply

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.

One key, one balance
Every API included

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.