API-Football v3

✓ Official Vendor SpecData EnrichmentData TransformationapiKey18 EndpointsREST

For Agents

Pull live scores, standings, fixtures, player and team statistics, transfers, injuries, predictions, and odds from api-sports.io's football v3 surface.

Quickstart

Get started with API-Football v3 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 from api-sports"

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

Capabilities

What an agent can do with API-Football v3 API.

Check the current account status and subscription tier with /status

List supported countries, seasons, and leagues for query-building

Retrieve fixtures filtered by league and season including live in-play matches

Get current and historical league standings with points, wins, draws, and losses

GET STARTED

Start building with API-Football v3 API

Explore with Jentic

View OpenAPI Document

Use for: I need to check my api-sports.io account quota with /status, Get all fixtures for La Liga in the current season, Find the live in-play matches across all supported leagues, Retrieve the top scorers for the Premier League this season

Not supported: Does not handle ticketing, fantasy league management, or non-football sports — use for football fixtures, standings, statistics, transfers, injuries, predictions, and odds only.

API-Football v3 from api-sports.io provides programmatic access to football (soccer) data covering 900+ leagues and cups, including fixtures, standings, players, coaches, transfers, injuries, predictions, and odds. Coverage includes real-time scores, pre-match and in-play odds, and team and player statistics. The 18 endpoints in this spec deliver the core surface for live scores, standings, player profiles, and predictions. Authentication is via the x-apisports-key header.

Use Cases

Patterns agents use API-Football v3 API for, with concrete tasks.

★ Live Scores Service

Build a live football scoreboard by polling /fixtures with the live filter to surface in-progress matches with their period, score, and elapsed time. Pair the returned fixture id with /predictions and /odds for richer context. The api-sports.io listing is suited to direct subscribers who want to call the v3 host without going through RapidAPI.

Call /fixtures with live=all and read the score, period, and elapsed time for each returned match

Season Standings and Top Scorers

Surface league tables and top scorer lists for editorial widgets, fantasy reminders, or analyst notebooks by calling /standings and /players together with consistent league and season parameters. The data feeds weekly recaps, season previews, and value-tracking tools across the 900+ supported leagues.

Call /standings with league=39 season=2024 and /players with league=39 season=2024 type=topscorers and merge into a single team-and-player snapshot

Transfer and Injury Watch

Track squad changes by combining /transfers with /injuries for a tracked team. The pair gives an up-to-date view of incoming and outgoing players plus availability for the next fixture, which is core data for fantasy app reminders and editorial coverage of a club's selection problems.

Call /transfers with team=541 and /injuries with team=541 to build a single availability report for Real Madrid's next fixture

Agent Integration via Jentic

An AI agent built on Jentic can search for the api-sports.io football operations by intent and execute them without holding the x-apisports-key in agent context. Jentic's MAXsystem holds the credential and returns scoped access at call time, which matters when the same agent needs to call both api-sports.io and other sports providers in the same workflow.

Use Jentic search for 'get live football fixtures from api-sports', load the /fixtures operation, execute it with live=all, and return the in-progress matches

Key Endpoints

18 endpoints — api-football v3 from api-sports.

METHOD

PATH

DESCRIPTION

GET

/status

Check account status and quota

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 team statistics

GET

/predictions

Get match predictions for a fixture

GET

/transfers

List transfers by team or player

GET

/injuries

List player injuries by team or fixture

GET

/status

Check account status and quota

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 team statistics

Why though Jentic?

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

Credential isolation

The x-apisports-key is stored encrypted in the Jentic vault. Agents receive scoped execution tokens at call 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 from api-sports' and Jentic returns the matching operation with its full input schema, so the agent can call the right endpoint without reading the docs.

Time to first call

Direct integration: 1 day to wire auth, status checks, and a few 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

RapidAPI listing of the same v3 football data surface

Use api-football.com when you subscribe via RapidAPI; use api-sports.io when you subscribe directly

Alternative

Sportmonks Football API

Football data provider with a different licence model and bookmaker mix

Choose Sportmonks if its bookmaker coverage or commercial licence terms fit better

Complementary

TheSportsDB

Open sports database covering teams, leagues, and events across multiple sports

Use TheSportsDB to enrich api-sports.io data with logos, stadium photos, and cross-sport coverage

Complementary

SportsData.io

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

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

FAQs

Specific to using API-Football v3 API through Jentic.

What authentication does API-Football v3 on api-sports.io use?

Authentication is via the x-apisports-key header. 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, never the raw key.

Can I get live in-play scores from api-sports.io?

Yes. Call GET /fixtures with the live=all filter to receive only currently in-progress matches with their period, score, and elapsed time. Pair the returned fixture id with /predictions and /odds for richer context.

What are the rate limits for api-sports.io football?

Rate limits depend on your subscription tier on api-sports.io: free plans permit 100 requests per day, paid plans raise the daily ceiling and per-minute caps. Call GET /status to inspect your current quota and respect any 429 responses with exponential backoff.

How do I get league standings 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 this API include predictions and odds?

Yes. GET /predictions returns model-driven match probabilities for a fixture and the wider api-sports.io football surface includes pre-match and in-play odds for the same fixtures. Combine the two to compare model output with the bookmaker market.

What's the difference between this and the api-football.com listing?

Both expose the same v3 football data hosted at v3.football.api-sports.io. The api-sports.io listing is for direct api-sports.io subscribers using x-apisports-key, while the api-football.com listing is the RapidAPI surface using x-rapidapi-key. Pick whichever matches your subscription channel.