API-Football is a RESTful API providing comprehensive football (soccer) data covering 1,200+ leagues and cups worldwide. Operated by API-Sports, the platform delivers live scores, fixtures, standings, events, line-ups, player statistics, pre-match odds, and historical data. The API supports 9+ sports total including soccer, Formula 1, basketball, baseball, hockey, rugby, volleyball, and handball. Data is returned in JSON format and updates every 15 seconds during live matches.
API Football publishes 1 API on the APIs.io network. Tagged areas include Sports, Football, Soccer, Live Scores, and Statistics.
API Football’s developer surface includes authentication, API reference, engineering blog, documentation, pricing, signup flow, support, and 15 more developer resources.
Create-or-Update Ergonomics could not be measured. We hold no machine-readable contract for
this provider to read, so there is nothing to measure a write surface against. Excluded rather than scored zero:
never-measured and measured-empty are different facts. Publishing an OpenAPI is what makes this facet — and
several others — scorable at all.
Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from github.com/api-evangelist/api-football: open an issue to ask a question, or submit a pull request to add artifacts.
Submit an artifact on GitHub — free →Manage your own listing — the Influence plan, $499/mo →
API-Football provides comprehensive football data including leagues, fixtures, standings, events, line-ups, players, pre-match odds, live odds, and historical statistics for 1,2...
aid: api-football
name: API Football
description: API-Football is a RESTful API providing comprehensive football (soccer) data covering 1,200+ leagues and cups
worldwide. Operated by API-Sports, the platform delivers live scores, fixtures, standings, events, line-ups, player statistics,
pre-match odds, and historical data. The API supports 9+ sports total including soccer, Formula 1, basketball, baseball,
hockey, rugby, volleyball, and handball. Data is returned in JSON format and updates every 15 seconds during live matches.
type: Index
deliveryModel:
model: saas
open_source: false
commercial: true
callable_host: false
label: Hosted service · you call their endpoint
confidence: medium
source:
- pricing
generated: '2026-08-28'
method: derived
accessModel:
pricing: freemium
onboarding: unknown
trial: false
try_now: false
public: false
label: Freemium
confidence: medium
source:
- plans
generated: '2026-07-22'
method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/api-football.png
tags:
- Sports
- Football
- Soccer
- Live Scores
- Statistics
url: https://raw.githubusercontent.com/api-evangelist/api-football/refs/heads/main/apis.yml
created: '2025-03-01'
modified: '2026-09-02'
specificationVersion: '0.23'
apis:
- aid: api-football:api-football
name: API-Football
description: API-Football provides comprehensive football data including leagues, fixtures, standings, events, line-ups,
players, pre-match odds, live odds, and historical statistics for 1,200+ leagues and cups worldwide.
humanURL: https://www.api-football.com/
baseURL: https://v3.football.api-sports.io
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/api-football.png
tags:
- Sports
- Football
- Soccer
- Live Scores
properties:
- type: Documentation
url: https://www.api-football.com/documentation-v3
- type: APIReference
url: https://www.api-football.com/documentation-v3
- type: GettingStarted
url: https://www.api-football.com/documentation-v3#section/Introduction
- type: Pricing
url: https://www.api-football.com/pricing
- type: Authentication
url: https://www.api-football.com/documentation-v3#section/Authentication
- type: RateLimits
url: https://www.api-football.com/documentation-v3#section/Rate-limit
common:
- type: DomainSecurity
url: security/api-football-domain-security.yml
- type: Authentication
url: authentication/api-football-authentication.yml
- type: Conventions
url: conventions/api-football-conventions.yml
- type: ErrorCatalog
url: errors/api-football-problem-types.yml
- type: RateLimits
url: rate-limits/api-football-rate-limits.yml
- type: Plans
url: plans/api-football-plans-pricing.yml
- type: Packages
url: packages/api-football-packages.yml
- type: Components
url: components/api-football-components.yml
- type: Lifecycle
url: lifecycle/api-football-lifecycle.yml
- type: Conformance
url: conformance/api-football-conformance.yml
- type: LLMsTxt
url: llms/api-football-llms.txt
- type: FinOps
url: finops/api-football-finops.yml
- type: Website
url: https://www.api-football.com/
- type: APIReference
url: https://www.api-football.com/documentation-v3
- type: Blog
url: https://www.api-football.com/news/
- type: TermsOfService
url: https://www.api-football.com/terms
- type: PrivacyPolicy
url: https://www.api-football.com/privacy
- type: Documentation
url: https://www.api-football.com/documentation-v3
- type: Pricing
url: https://www.api-football.com/pricing
- type: Signup
url: https://dashboard.api-football.com/register
- type: Login
url: https://dashboard.api-football.com/login
- type: Support
url: https://www.api-football.com/contact
- type: Features
data:
- name: 1200+ Leagues and Cups
description: Comprehensive coverage of over 1,200 football leagues and cups worldwide including major leagues, cups, and
international competitions.
- name: Live Scores
description: Real-time match data updated every 15 seconds during live matches, including scores, events, and match statistics.
- name: Fixtures and Results
description: Complete fixture schedules and match results including past, present, and upcoming matches with full event
details.
- name: Standings
description: League standings and tables for all supported competitions with points, wins, draws, losses, and goal difference.
- name: Player Statistics
description: Individual player statistics including goals, assists, cards, appearances, and detailed performance metrics.
- name: Pre-Match and Live Odds
description: Pre-match betting odds and live odds from major bookmakers available in all pricing tiers.
- name: Historical Data
description: Multiple years of historical match data available for statistical analysis, fantasy football, and predictive
modeling.
- name: Multi-Sport Coverage
description: Beyond football/soccer, API-Sports covers Formula 1, basketball, baseball, hockey, rugby, volleyball, and
handball.
- type: UseCases
data:
- name: Sports Applications
description: Build mobile and web apps displaying live scores, fixtures, standings, and player statistics for football
fans.
- name: Fantasy Football Platforms
description: Power fantasy football platforms with player statistics, injury updates, match results, and historical performance
data.
- name: Sports Betting
description: Integrate pre-match odds, live odds, and real-time match events into sports betting and prediction platforms.
- name: Sports Analytics
description: Analyze historical match data, player performance, and team statistics for sports analytics and scouting
platforms.
- name: Widgets and Embeds
description: Embed live score widgets and statistics panels into websites using API-Football's data and widget integrations.
- type: Integrations
data:
- name: RapidAPI
description: API-Football is available on the RapidAPI hub enabling discovery and access through the RapidAPI marketplace.
- name: Stripe and PayPal
description: Subscriptions managed via Stripe or PayPal with no auto-renewal and prepaid plan options.
maintainers:
- FN: Kin Lane
email: info@apievangelist.com
x-enrichment:
date: '2026-09-02'
status: enriched
artifacts_added: 10
pass: local-v1
x-contract-note:
finding: 'API-Football DOES publish an OpenAPI document, and this repository does NOT hold it. The Redoc documentation page
declares it inline as `<redoc spec-url="public/doc/openapi.yaml" hide-download-button>`, resolving to https://www.api-football.com/public/doc/openapi.yaml.
Every HTML and .yaml path on www.api-football.com is served to non-browser clients as a Cloudflare managed challenge (HTTP
403, `cf-mitigated: challenge`), so the spec could not be retrieved on 2026-09-02. Do NOT record this provider as publishing
no machine-readable contract — the contract exists and the wall is on our side. A future pass with a browser-capable fetcher
should harvest it into openapi/ and then derive data-model/, skills/, overlays/ and a tool crosswalk from it.'
spec_url: https://www.api-football.com/public/doc/openapi.yaml
spec_status: 403
checked: '2026-09-02'
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
Kin Score
How this is scored →