Betsprinter Public API

A free, read-only API for football data & AI picks.

Pull fixtures, AI predictions, and league top-scorers as JSON. SportMonks-backed, JSON-shaped, rate-limited. No signup required to start; mint a VIP key for 10× the throughput.

Anonymous: 60 req/min · VIP-keyed: 600 req/min · Cancel anytime.

Base URL
https://api.betsprinter.com/v1
Path alias (also valid):
https://betsprinter.com/api/public/v1

Endpoints

Six routes total. All return JSON. All return camelCase nothing — snake_case fields throughout, matching the rest of the Betsprinter surface.

MethodPathDescriptionAuth
GET/fixturesPaginated list of fixtures. Filter by league, status, and kickoff window.optional
GET/fixtures/{id}Single fixture by local id, including teams + league.optional
GET/picksPaginated list of AI picks (model probability, calibration, selection tier).optional
GET/picks/{id}Single pick with the full reasoning payload.optional
GET/leagues/{id}/top-scorersLeague's top goal-scorers for the current season.optional
GET/healthLiveness probe. Always public, never rate-limited.none

Try it now: https://betsprinter.com/api/public/v1/health

Authentication

Optional. Anonymous traffic gets the lower rate-limit tier; pass a key for 10× throughput.

Canonical header

Authorization: Bearer <key>

Standard bearer token. Works with every HTTP client out of the box (curl, fetch, Postman, Insomnia).

Fallback header

X-Public-Api-Key: <key>

Use when an upstream proxy strips the Authorization header (Cloudflare Access, Cloud Run with IAM, etc).

Get a VIP API key

Keys start with bspr_ and unlock 600 req/min. Self-served from your account page; revoke any time.

Rate limits

Two tiers. Bucketed per-IP for anonymous, per-key for keyed.

Anonymous

60req / min

Per IP. No headers required. Returns 429 Too Many Requests with a Retry-After header when exceeded.

VIP-keyed

600req / min

Per key. Each VIP can mint up to 5 active keys, each with an independent bucket. Same 429 + Retry-After contract on overflow.

Pagination caps: max page size 100, default 25.

Attribution

If you republish data from the API, include a visible link back to Betsprinter.

Required attribution sentence

Data via [Betsprinter](https://betsprinter.com).

Renders as Data via Betsprinter. Any visible variation that links to https://betsprinter.com with rel-following attributes satisfies the clause. Full terms in the terms of service.

Examples

Copy-pasteable curl. Substitute your bspr_… key in the keyed examples.

Anonymous — list today's fixtures

curl https://betsprinter.com/api/public/v1/fixtures?per_page=5

Keyed — top 10 picks for the Premier League (id 8)

curl -H "Authorization: Bearer bspr_YOUR_KEY_HERE" \
  "https://betsprinter.com/api/public/v1/picks?league_id=8&per_page=10"

Top scorers in a league

curl https://betsprinter.com/api/public/v1/leagues/8/top-scorers

Single fixture

curl https://betsprinter.com/api/public/v1/fixtures/{FIXTURE_ID}

Data source

All fixture, league, team, and player data exposed by the public API is sourced from sportmonks. AI picks are computed against those features by Betsprinter’s calibrated model.

Bookmaker prices (best odds, edge) are intentionally not redistributed via this API — consult bookmakers directly for current quotes.

Read the model methodology