API-Football
Use API-FOOTBALL for football leagues, teams, fixtures, standings, team statistics, and players.
Tools
| Name | Description |
|---|---|
list_leaguesList API-Football leagues by country, season, team, or current status. | List API-Football leagues by country, season, team, or current status. |
list_teamsSearch teams by ID, name, league/season, country, or venue. | Search teams by ID, name, league/season, country, or venue. |
list_fixturesList fixtures by date, date range, league/season, team, venue, round, status, or IDs. | List fixtures by date, date range, league/season, team, venue, round, status, or IDs. |
get_standingsGet standings for a league and season. | Get standings for a league and season. |
get_team_statisticsGet team statistics for a league and season. | Get team statistics for a league and season. |
list_playersList players by team, league, season, search term, or page. | List players by team, league, season, search term, or page. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('api-football', 'list_leagues', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'api-football',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect API-Football to my app?
Use Weavz Hosted Connect for API Key authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does API-Football support?
API-Football supports 6 tools including List Leagues, List Teams, List Fixtures, Get Standings, Get Team Statistics, and more.
Can I use API-Football with AI agents?
Yes. Add API-Football to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect API-Football to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add API-Football as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped API-Football tools exposed by that workspace.
Does API-Football work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved API-Football work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with API-Football?
API-Football exposes 6 tools, including List Leagues, List Teams, List Fixtures, Get Standings, Get Team Statistics, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can API-Football be used in stateful agent workflows?
Yes. Agents can combine API-Football tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does API-Football use?
API-Football uses API Key. Weavz stores credentials securely and uses them for authorized action execution.
How much does the API-Football integration cost?
The API-Football integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
Connect API-Football in minutes
Get 20,000 free action executions every month. No credit card required.