canonical: https://jentic.com/apis/allsportsapi.com/allsportsapi

# Allsportsapi All Sports Football API

Jentic publishes the only available OpenAPI specification for All Sports Football API, keeping it validated and agent-ready. AllSportsAPI exposes football (soccer) data - fixtures, live scores, standings, team and player records, head-to-head history, and odds - through a single GET /football/ endpoint. Behaviour is selected via a method query parameter (e.g. Fixtures, Standings, Teams), making this a method-dispatch style API rather than a resource-per-path REST design. Authentication is by query-parameter API key, and responses cover global leagues and competitions.

## For AI agents

Pull football fixtures, live scores, standings, teams, players, head-to-head data, and odds via a single dispatch endpoint, selecting the data type with a method parameter.

## Scope

Does not handle non-football sports, betting transactions, or video streams - use for football fixtures, scores, standings, rosters, head-to-head, and odds only.

## Capabilities

- Pull live football scores for in-progress fixtures
- List upcoming and past fixtures filtered by league or date range
- Read league standings for a chosen competition and season
- Look up team rosters and player profiles
- Retrieve head-to-head history between two clubs
- Read pre-match and live odds for fixtures

## Use cases

### Live score aggregation

Sports media bots and apps poll GET /football/ with method=Livescore to pull scores for in-progress matches and surface them in real time. Because all data flows through a single endpoint with a method dispatch, the integration is one operation to learn and one to maintain. This is the fastest route to wire football data into a content workflow.

Example prompt: Call GET /football/ with method=Livescore and leagueId for the Premier League, then post any goal events to a Slack channel.

### Fantasy sports data feed

Fantasy platforms pull fixtures, standings, and player records to populate weekly contests. The single-endpoint dispatch model means one connector handles every data type the fantasy app needs, and the API key sits in one query parameter - no header juggling. Schedules and rosters can be refreshed on a cron without complex pagination logic.

Example prompt: Call GET /football/ with method=Fixtures and a date range covering the upcoming gameweek, then write fixtures into the fantasy contest table.

### Odds-driven content generation

Editorial bots use pre-match odds from GET /football/ method=Odds to write match previews and trigger trending content workflows. Because the same endpoint also returns standings and head-to-head data, the bot can compose context-rich previews from a single API in one or two calls.

Example prompt: Pull odds for fixture ID 1234 via GET /football/ method=Odds, then pull the head-to-head record via the H2H method to draft a preview.

### AI agent sports content automation

An AI agent can answer user questions like 'who is playing tonight?' by hitting the AllSports method=Fixtures dispatch and summarising the result. Through Jentic the agent searches by intent, loads the input schema, and executes - the API key is held in the vault and never enters the prompt context.

Example prompt: Use Jentic to search 'get football fixtures for today', execute GET /football/ with method=Fixtures and today's date, and return the formatted match list.

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| GET | /football/ | Query football data - selects fixtures, livescores, standings, teams, players, H2H, or odds via the method parameter |

## Key resources

- **Football data dispatch** — Single endpoint that returns fixtures, standings, teams, players, livescores, head-to-head data, and odds based on the method query parameter

## Why Jentic

- **Setup:** Wiring the All Sports Football API by hand means attaching its API key to each request against apiv2.allsportsapi.com and encoding the fixture, score, and standings queries yourself. Through Jentic you install once, import the All Sports Football API from the API Directory, store the API key once, and your agent calls it.
- **Permission scoping:** The All Sports Football API exposes a single /football/ endpoint whose target is selected by query parameter rather than a path resource, so limit the agent to that operation and the query types it needs, such as fixtures, standings, or head-to-head. You choose whether the agent may call it, and no other operations exist to add.
- **Credential handling:** Your All Sports Football API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'get today's football fixtures' or 'read league standings', and Jentic returns the matching All Sports Football operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **API-Football** — Resource-oriented football API with fixtures, standings, and odds across endpoints
- **API-Sports** — Multi-sport API covering football, basketball, and others
- **SportMonks** — Detailed football data including expected goals and player stats

## FAQ

### Why is there no official OpenAPI spec for All Sports Football API?

AllSportsAPI does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call All Sports Football API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the All Sports Football API use?

An API key passed as the APIkey query parameter. Through Jentic, the key is stored in the encrypted vault and added at execution time so it never appears in agent prompts or logs.

### Can I get live football scores from this API?

Yes. Call GET /football/ with method=Livescore. The same endpoint serves fixtures, standings, team and player data, head-to-head, and odds depending on the method parameter you choose.

### How do I fetch fixtures via the AllSports API through Jentic?

Run pip install jentic, search 'get football fixtures', load the input schema for GET /football/, and execute with method=Fixtures and your chosen date or league filter.

### How is this API structured - is it one endpoint or many?

It is a single GET /football/ endpoint with a method query parameter that dispatches to different data types. Treat the method value as the resource selector when integrating.

### Does the AllSports API cover sports other than football?

This spec covers football (soccer) only. Other sports may be available via separate AllSportsAPI products that are not included in this OpenAPI definition.

### Can I limit what my agent is allowed to do with the All Sports Football API?

Yes. Because you run Jentic One yourself, your own rules decide which operations and credentials the agent may use. The All Sports Football API exposes a single GET /football/ endpoint whose target is selected by a query parameter, so you can allow the agent to call just that operation and only the query types it needs, such as Fixtures, Standings, or head-to-head. No other operations exist to grant, and you choose whether the agent may call it at all.