# API-Sports AI integration on Definable

> API-Sports provides comprehensive sports data APIs covering over 2,000 competitions with more than 15 years of historical data, offering real-time updates and easy integration for developers.

## What this connects

API-Sports provides comprehensive sports data APIs covering over 2,000 competitions with more than 15 years of historical data, offering real-time updates and easy integration for developers.

Vendor: https://api-sports.io/

## Tools available

**67** tools available. First 12:

- `API_SPORTS_GET_AFL_GAMES` — Get AFL Games — Tool to retrieve AFL games and matches. Use when filtering games by id, date, league, season, team, or timezone to get upcoming, past, or live matches.
- `API_SPORTS_GET_AFL_GAMES_STATISTICS_PLAYERS` — Get AFL Game Player Statistics — Tool to retrieve player statistics from AFL (Australian Football League) game(s). Use when you need detailed player performance data for specific AFL games by game ID, player ID, or season.
- `API_SPORTS_GET_AFL_SEASONS` — Get AFL Seasons — Tool to get the list of available seasons for AFL. All seasons are 4-digit keys (e.g., 2018 for 2018-2019 season). Use when you need season filters for AFL endpoints.
- `API_SPORTS_GET_AFL_STANDINGS` — Get AFL Standings — Tool to retrieve AFL standings for a league. Use when needing current team rankings, points, and positions for a specific season.
- `API_SPORTS_GET_BASEBALL_GAMES_H2H` — Get Baseball Games Head-to-Head — Tool to get head-to-head baseball games between two teams. Use when comparing the match history between two specific baseball teams.
- `API_SPORTS_GET_BASKETBALL_BETS` — Get Basketball Bets — Tool to get all available basketball bet types. Use when you need to retrieve available betting options for basketball games.
- `API_SPORTS_GET_BASKETBALL_BOOKMAKERS` — Get Basketball Bookmakers — Tool to get all available basketball bookmakers. Use when you need to retrieve available bookmakers for basketball odds and betting data.
- `API_SPORTS_GET_BASKETBALL_STATISTICS` — Get basketball statistics — Tool to get basketball statistics for a team in a given league and season. Use when you need detailed basketball team statistics including games played, wins, losses, points, and other performance metrics.
- `API_SPORTS_GET_CIRCUITS` — Get Formula 1 Circuits — Tool to get the list of available Formula 1 circuits. Use when searching for circuits by id, competition, name, or search term.
- `API_SPORTS_GET_COACHS` — Get Coaches — Tool to fetch coaches and their career history. Use when you need coach info by ID, team filter, or name search.
- `API_SPORTS_GET_COUNTRIES` — Get Countries — Tool to fetch available countries for league queries. Use when filtering by name, code, or search string before retrieving leagues.
- `API_SPORTS_GET_FIGHTERS_RECORDS` — Get Fighters Records — Tool to get fighter career statistics. Use when you need a fighter's complete record including wins, losses, draws, knockouts, and submissions.

## Auth

Auth schemes: `API_KEY`.

## How agents use API-Sports

Inside a Definable workflow, API-Sports is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → API-Sports** — the Researcher (GPT-5.5) pulls context from API-Sports (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → API-Sports** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into API-Sports (create record, post message, draft email).
- **Designer / Engineer → Distributor → API-Sports** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via API-Sports (attach file, open PR comment, post status).

The Verifier checks every API-Sports call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- developer tools — https://definable.ai/apps/category/developer-tools/

## Related

- HTML page: https://definable.ai/apps/api_sports/
- Same category (developer tools): https://definable.ai/apps/category/developer-tools/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt