Api Sports API-Football v3
59
AI ReadinessFoundational (C+)59/100
Official vendor OpenAPI document · agent-readyData 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.
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.
Install Jentic One Beta
Connect the API-Football v3 to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the API-Football v3, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fapi-sports.io%2Fapi-sports" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fapi-sports.io%2Fapi-sports" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
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
Look up team and player profiles, top scorers, transfers, injuries, predictions, and odds
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 your Jentic One instance 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
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
Jentic AI Readiness Score
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
A
API-Football v3
- Foundational (C+)59/100
85
Foundational Compliance63
Developer Experience & Jentic Compatibility53
AI-Readiness & Agent Experience53
Agent Usability50
Security74
AI DiscoverabilityPowered by JenticScoring Framework 0.2.0 | Scoring Engine 0.3.10
Show dimension breakdown
85
Foundational Compliance
Base layer of spec validity and structural soundness.
Grade: ASignals: 4
98%
Lint Results
Aggregated quality score from linter diagnostics, weighted by severity.
100%
Resolution Completeness
Percentage of `$ref` references that resolve successfully.
100%
Specification Validity
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
42%
Structural Integrity
Structural correctness score based on schema issues using logarithmic dampening.
63
Developer Experience & Jentic Compatibility
Clarity, completeness, and ingestion readiness for developers and tooling.
Grade: B-Signals: 4
0%
Example Density
How richly the API is illustrated with examples.
100%
Example Validity
Percentage of examples that conform to their schemas.
50%
Response Coverage
Percentage of operations with complete response definitions (success, client error, server error).
100%
Tooling Readiness
Health of API ingestion, bundling, and resolution within Jentic pipelines.
53
AI-Readiness & Agent Experience
Semantic breadth, depth, and agent comprehension for AI systems.
Grade: CSignals: 4
62%
Description Coverage
Coverage of descriptions across API elements.
0%
Error Standardization
Coverage of RFC 9457 Problem Details for error responses.
100%
OperationId Quality
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
50%
Summary Coverage
Coverage of summaries across operations/tags/info.
53
Agent Usability
Functional utility, complexity comfort, and AI orchestration readiness.
Grade: C-Signals: 1
53%
Complexity Comfort
Agent comfort level based on API operational and structural complexity.
50
Security
Trust, risk posture, and security compliance.
Grade: C-Signals: 1
50%
Authentication Strength
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
74
AI Discoverability
Findability, semantic richness, and reasoning readiness.
Grade: A-Signals: 1
74%
Descriptive Richness
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring API-Football v3 by hand means handling its x-apisports-key header, targeting the v3 host, and mapping fixture, standings, transfer, and injury routes with their query parameters yourself. Through Jentic you install once, import API-Football from the API Directory, store the key once, and your agent calls it.
Permission scoping
API-Football selects data through query parameters rather than resource ids in the URL path, so you limit the agent to the operations it needs, such as reading fixtures, standings, or injuries. Operations like predictions or odds are only available if you include them in the allowed set.
Credential isolation
Your x-apisports-key is stored once, encrypted, by your own Jentic One instance and injected as the request header at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'get football league standings' or 'get live football fixtures', and Jentic returns the matching operation with its input schema so the agent calls the right endpoint without browsing the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
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 your Jentic One instance 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. Run it through Jentic One, the self-hosted execution layer 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.
Can I limit what my agent is allowed to do with the API-Sports Football v3 API?
Yes. Because you run Jentic One yourself, your own rules decide which API-Sports Football operations and credentials the agent may use, so you can allow it to read only what it needs, such as fixtures, standings, or injuries. API-Football selects data through query parameters rather than resource ids in the URL path, which lets you scope access at the operation level rather than per record. Operations like predictions or odds are reachable only if you add them to the allowed set, and your stored x-apisports-key is injected at call time without ever entering the agent's context.
GET STARTED