Endpoints

2

Ungrouped Endpoints
2

What is the Superbet Odds API?

Superbet Greece odds as JSON: live and pre-match soccer, basketball and tennis with Superbet's full market list and Betradar ids. Updated every few seconds.

Superbet Odds API is available on the JoJ API marketplace. Subscribe with a single JoJ API key, call it through one gateway, and pay from one wallet — no separate account or contract with the provider.

Superbet Odds API endpoints

  • GET/v1/data/{filename}

    Data by filename

    Returns one odds file inside an envelope: {"company", "file", "updated_at", "data"}. data is the bookmaker's own JSON, unchanged; updated_at is when the file was last refreshed (UTC). The same time is sent as the Last-Modified header — send it back as If-Modified-Since to get 304 Not Modified until the file changes. Request gzip: responses arrive about 6–10 times smaller. Errors (body {"detail": "…"}): 400 invalid filename · 401 missing or invalid API key · 403 unknown file or a file of another bookmaker · 404 file temporarily unavailable · 429 too many requests (see Retry-After) · 500 file temporarily invalid.

    $0.01 / call
  • GET/v1/files

    Files

    Lists the odds files your subscription can read, sorted by name. Returns {"company", "count", "files"}. Call it first and request only the names it returns.

    $0.01 / call

Frequently asked questions about Superbet Odds API

What does this API provide?

Structured JSON feeds of Superbet live and pre-match odds for soccer, basketball, and tennis, split by sport. Call GET /v1/files then GET /v1/data/{filename}.

How do I authenticate?

Use your JoJ API key in X-JoJAPI-Key: YOUR_API_KEY. Authorization: Bearer YOUR_API_KEY also works.

Which datasets can I download?

Live: site_live_superbet_soccer.json, site_live_superbet_basketball.json, site_live_superbet_tennis.json. Pre-match: site_pregame_superbet_soccer.json, site_pregame_superbet_basketball.json, site_pregame_superbet_tennis.json.

How fresh is the data?

Live data refreshes about every 2-5 seconds and pre-match about every 6-10 seconds. The big pre-match soccer file refreshes roughly every 1-2 minutes. There is no guaranteed SLA.

What is the rate limit?

See Pricing for plan limits. The origin may return 429 above 10 requests per second.

Is this an official Superbet API?

No. It aggregates publicly displayed Superbet odds and is not affiliated with or endorsed by Superbet or Superbet Group.

Can I place bets through this API?

No. Informational and analytical use only. It does not place bets.

Are live and pre-match in the same file?

No. Superbet live and pre-match are separate files, each split by sport.

What does a successful response look like?

JSON envelope with company, file, updated_at (Last-Modified / If-Modified-Since, 304 when unchanged) and data. Gzip makes responses about 6-10x smaller.