Developers & AI Agents

REST API for soccer match predictions. Built for developers, AI agents, and bots. JSON responses, CORS enabled. Pro subscription required for API access.

Pro subscription required

All API data endpoints require a valid API key from an active Pro subscription ($4.99/mo). Subscribe on the home page and find your API key on your account page.

What You Get

Pro API — $4.99/mo

Match schedules, scores & league metadata
Win/draw/loss probabilities for every match
Confidence scores
Full AI reasoning & analysis
Prediction accuracy statistics
Personal API key (fp_...)

Quick Start

# Get upcoming predictions
curl https://fpreds.com/api/v1/predictions \
  -H "Authorization: Bearer fp_your_api_key"

# Filter by league
curl https://fpreds.com/api/v1/predictions?league=PL \
  -H "Authorization: Bearer fp_your_api_key"

# Get past results with accuracy
curl https://fpreds.com/api/v1/results \
  -H "Authorization: Bearer fp_your_api_key"

Get your API key from your account page after subscribing to Pro.

Endpoints

GET/api/v1/predictionsAUTH

Upcoming match predictions (next 7 days)

Params: league (optional): PL, BL1, PD, FL1, SA, ED, TSL, PPL, UCL, UEL, WC, UNL

GET/api/v1/resultsAUTH

Past results with prediction accuracy (last 30 days)

Params: league (optional)

GET/api/v1/accuracyAUTH

Overall and per-league prediction accuracy statistics

GET/api/v1/match/{id}AUTH

Single match with full AI agent analyses and reasoning

Params: id (required): Match ID

GET/api/v1/openapi.json

OpenAPI 3.1 specification

Response Example

{
  "id": 2267365,
  "league": "PL",
  "home_team": "Arsenal",
  "away_team": "Chelsea",
  "kickoff_utc": "2026-03-15T15:00:00Z",
  "prediction": {
    "predicted_outcome": "HOME",
    "home_win_pct": 52,
    "draw_pct": 26,
    "away_win_pct": 22,
    "confidence": 68,
    "reasoning": "Arsenal's strong home form..."
  }
}

Without a valid API key, data endpoints return 401 or 403 errors.

Error Responses

401 — No API key provided

{
  "error": "Authentication required",
  "message": "The Developer API requires a Pro subscription ($4.99/mo). Include your API key as: Authorization: Bearer fp_..."
}

403 — Invalid or expired API key

{
  "error": "Invalid or expired API key",
  "message": "Your API key is invalid or your Pro subscription is no longer active."
}

League Codes

🏴󠁧󠁢󠁥󠁮󠁧󠁿PLPremier League

🇩🇪BL1Bundesliga

🇪🇸PDLa Liga

🇫🇷FL1Ligue 1

🇮🇹SASerie A

🇳🇱EDEredivisie

🇹🇷TSLSüper Lig

🇵🇹PPLPrimeira Liga

🏆UCLChampions League

🏆UELEuropa League

🌍WCWorld Cup 2026

🌍UNLNations League

For AI Agents

fpreds.com is designed to be machine-readable. AI agents can discover and use our API through:

/llms.txt — Machine-readable site description (LLM standard) /api/v1/openapi.json — OpenAPI 3.1 specification (public) /feed.xml — RSS feed with latest predictions

All data endpoints require a Pro API key (Authorization: Bearer fp_...). The OpenAPI spec and llms.txt are publicly accessible. Rate limit: 60 requests/minute.

Authentication

All data endpoints require authentication. Pro subscribers get a personal API key (starts with fp_). Include it in every request:

Authorization: Bearer fp_your_api_key

Requests without a valid key receive 401 or 403 responses. Find your API key on your account page.