API-FOOTBALL

Name: API-FOOTBALL API
Brand: API-FOOTBALL
Availability: InStock

✓ Official Vendor SpecData EnrichmentData TransformationapiKey38 EndpointsREST

For Agents

Look up live and historical football fixtures, standings, lineups, statistics, transfers, injuries, predictions, and odds across more than a thousand leagues.

Quickstart

Get started with API-FOOTBALL in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"get live football fixtures"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

Capabilities

What an agent can do with API-FOOTBALL API.

Pull live and historical fixtures with status, score, lineups, events, and statistics for a chosen league and season

Retrieve current and historical standings for a league or cup with position, points, and goal difference

Look up team and player profiles, season statistics, transfer history, and injury status

Fetch pre-match and in-play odds plus model-driven match predictions for a fixture

GET STARTED

Start building with API-FOOTBALL API

Explore with Jentic

View OpenAPI Spec

API-FOOTBALL provides structured access to football (soccer) data covering 1100+ leagues and cups worldwide, including fixtures, lineups, events, statistics, standings, top scorers, transfers, injuries, predictions, and pre-match and in-play odds. Data is updated continuously and supports historical lookback as well as live in-play coverage. The 38 endpoints in this spec cover everything from base reference data such as countries and timezones to deep per-fixture statistics. Authentication is via an x-rapidapi-key style API key passed in the header.

Use Cases

Patterns agents use API-FOOTBALL API for, with concrete tasks.

★ Live Match Tracking

Build a live football scoreboard or in-play assistant that polls /fixtures with the live filter to surface in-progress matches and their current score, period, and event timeline. The same fixture id then unlocks /fixtures/lineups, /fixtures/events, and /fixtures/statistics for richer context. This supports media products, fan apps, and trading dashboards that need real-time match state across many leagues.

Call GET /fixtures with live=all, then for the first returned fixture id call /fixtures/events and /fixtures/statistics and summarise the current state

League Standings and Top Scorers

Build a season tracker that surfaces the current league table, top scorers, and top assists for a given league and season. /standings returns positional data with points, wins, draws, and losses, while /players/topscorers and /players/topassists rank individual contributions. This is core data for fantasy football tools, editorial widgets, and analyst dashboards.

Call /standings with league=39 season=2024 to fetch the Premier League table, then /players/topscorers with the same parameters to list the top scorers

Pre-Match Odds and Predictions

Retrieve pre-match odds from /odds and model-driven predictions from /predictions for an upcoming fixture, then combine the two to build value-spotting signals. The endpoints are scoped to league and season so the agent can iterate across all matches in a round. This pattern is used by tipping content, model-research notebooks, and trading research stacks.

Call /predictions for fixture id 12345 and /odds for the same fixture, then return the model probabilities alongside the bookmaker odds

Squad and Transfer Intelligence

Track squad changes by combining /players/squads for current rosters, /transfers for incoming and outgoing moves, and /injuries to flag players unavailable for selection. This gives an up-to-date view of a club's available pool ahead of a fixture and powers scout-style content and fantasy team selection tools.

Call /players/squads with team=541 to fetch Real Madrid's current squad, then /transfers and /injuries for the same team and merge into one report

Agent Integration via Jentic

An AI agent built on Jentic can search for the API-FOOTBALL fixture and standings operations by intent and execute them without holding the API key in agent context. Jentic's MAXsystem holds the credential and returns scoped access to the agent at execution time, which matters when the same agent calls multiple sports providers and credential isolation is a requirement.

Use Jentic search for 'get live football fixtures', load the /fixtures operation, execute it with live=all, and pass the returned fixture ids into a follow-up /fixtures/statistics call

Key Endpoints

38 endpoints — api-football provides structured access to football (soccer) data covering 1100+ leagues and cups worldwide, including fixtures, lineups, events, statistics, standings, top scorers, transfers, injuries, predictions, and pre-match and in-play odds.

METHOD

PATH

DESCRIPTION

GET

/fixtures

List fixtures filtered by league, season, team, or live status

GET

/standings

Get league or cup standings for a season

GET

/leagues

List supported leagues and cups

GET

/teams

Look up team profiles and search by name or country

GET

/players

Look up player profiles and season statistics

GET

/predictions

Get model-driven predictions for a fixture

GET

/odds

Get pre-match odds for a fixture or league round

GET

/fixtures

List fixtures filtered by league, season, team, or live status

GET

/standings

Get league or cup standings for a season

GET

/leagues

List supported leagues and cups

GET

/teams

Look up team profiles and search by name or country

GET

/players

Look up player profiles and season statistics

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The API-FOOTBALL key (x-rapidapi-key or x-apisports-key) is stored encrypted in the Jentic vault. Agents receive scoped access tokens at execution time and never hold the raw key.

Intent-based discovery

Agents search by intent such as 'get football league standings' or 'get live football fixtures' and Jentic returns the matching API-FOOTBALL operation with its full input schema, so the agent can call the right endpoint without reading the docs.

Time to first call

Direct API-FOOTBALL integration: 1-2 days to wire auth, parameter validation, and pagination across the 38 endpoints. Through Jentic: under 1 hour from search to first executed call.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

API-FOOTBALL (Free Tier)

The free-tier surface of API-FOOTBALL with the same endpoint set

Use the free-tier listing when prototyping or when the agent's quota fits within the daily free allowance

Alternative

API-Sports Football v3

The api-sports.io direct-listing of the same football data surface

Use api-sports.io when you have a direct api-sports.io subscription rather than RapidAPI

Alternative

Sportmonks Football API

Football data provider with a different licence model and coverage profile

Choose Sportmonks if you need its specific bookmaker coverage or commercial licensing terms

Complementary

TheSportsDB

Open sports database covering team, league, and event metadata across multiple sports

Use TheSportsDB to enrich API-FOOTBALL data with additional metadata such as logos, stadium photos, and cross-sport coverage

Complementary

SportsData.io

Multi-sport data provider including soccer, NFL, NBA, and others

Use SportsData.io when the agent must cover multiple sports beyond football

FAQs

Specific to using API-FOOTBALL API through Jentic.

What authentication does API-FOOTBALL use?

API-FOOTBALL is called with an API key in the request header (x-rapidapi-key when accessed through RapidAPI, or x-apisports-key when accessed directly via api-sports.io). When called through Jentic the key is held in the Jentic vault and a scoped execution token is granted to the agent at call time.

Can I get live in-play scores with API-FOOTBALL?

Yes. Call GET /fixtures with the live=all parameter to receive only currently in-progress matches with their period, score, and elapsed time. Pair the returned fixture id with /fixtures/events and /fixtures/statistics for live event and stat feeds.

What are the rate limits for API-FOOTBALL?

Rate limits are tied to your subscription tier on api-sports.io: the free plan permits 100 requests per day, while paid tiers raise the daily allowance and lift per-minute limits. The OpenAPI spec does not encode the limits — check your dashboard for the exact ceiling and respect any 429 responses with backoff.

How do I fetch a league table through Jentic?

Install the Jentic SDK with pip install jentic, search for 'get football league standings', load the GET /standings operation, and execute it with league and season parameters. Sign up at https://app.jentic.com/sign-up to get a Jentic agent key.

Does API-FOOTBALL include historical data?

Yes. Most endpoints accept a season parameter that lets you retrieve historical fixtures, standings, statistics, and transfers going back several seasons. Use GET /leagues/seasons to discover the seasons available for a given league before querying historical data.

Can I get bookmaker odds for upcoming matches?

Yes. GET /odds returns pre-match odds across multiple bookmakers for upcoming fixtures, scoped by league, season, and round. Pair it with GET /predictions for the same fixture id to compare model-driven probabilities against the market.