API Docs.
The same fixtures, predictions, and probabilities shown on this site — as a REST API. Free to start, higher rate limits from $3/month. Also available as an MCP server for AI agents.
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
| Method | Path | Description | Params |
|---|---|---|---|
| GET | /predictions/live | Current 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 | /account/me | Your API key's plan and current usage — check rate-limit status. | — |
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.