PredictIQ Pro
API reference

API Docs.

The same fixtures, predictions, and probabilities shown on this site — as a REST API. Free to start, higher rate limits from $9/month. Also available as an MCP server for AI agents.

your-terminal, live
$

Authentication

Every request needs your API key in the Authorization header:

Authorization: Token YOUR_API_KEY

Get a key at predictiqpro.com/register — free tier, no card required.

Base URL & rate limits

All endpoints are relative to:

https://api.predictiqpro.com

Rate limits depend on your plan — 100 requests/hour on Free, up to 10,000/hour on Pro. See pricing for details. Check your current usage anytime with GET /account/me.

Endpoints

MethodPathDescriptionParams
GET/predictions/liveCurrent live and upcoming match predictions — probabilities, expected goals, best bet.—
GET/predictions/{match_id}Prediction detail for one specific match.match_id
GET/fixtures/Fixtures filtered by status or league — finished, scheduled, or live.status, league_id
GET/fixtures/{match_id}Full fixture detail: teams, score, kickoff, league.match_id
GET/lineups/{match_id}Confirmed starting XI and substitutes, if available.match_id
GET/odds/{match_id}Bookmaker odds comparison for a specific match, if available.match_id
GET/live/arena/{fixture_id}/momentum-historyPer-minute live match momentum history (home/away, goal markers) for a fixture.fixture_id
GET/account/meYour API key's plan and current usage — check rate-limit status.—

Live demo

This isn't a screenshot — it's the real /predictions/live endpoint above, rendered as one of the drop-in embeddable widgets.

Log in to render this exact widget with your own key, or see it live on the widgets page.

Get a free key

Response format

Every endpoint returns JSON. List endpoints (like /fixtures/) are wrapped in a results array; single-resource endpoints return the object directly.

Errors

Non-2xx responses return { "error": "..." }. A 401 means a missing or invalid key; a 429 means you've hit your plan's rate limit — check GET /account/me or upgrade on the pricing page.

curl https://api.predictiqpro.com/predictions/live \
  -H "Authorization: Token YOUR_API_KEY"

Prefer AI agents call this directly? See the MCP server docs.