// Get started
Soccer Data API
Football data over a simple REST API, from fixtures and live scores to xG and bookmaker odds.
Soccer Data gives you competitions, teams, players, fixtures, results, live scores, league tables, season and match stats, xG shot maps, heatmaps and betting odds. You ask with a plain HTTPS GET request and get JSON back.
Tip Building with an AI coding tool? Start with Build with AI. It shows you how to hand your assistant the whole API reference in one file.
Start here
| Page | What you'll find |
|---|---|
| Quickstart | Your first requests in about five minutes. |
| Introduction | What the API covers and how requests and responses look. |
| Authentication | How to send your key and keep it safe. |
| API reference | Every endpoint, with parameters, fields and examples. |
| Coverage | Which competitions and seasons have which data. |
Guides
- Find any ID: look up competitions, seasons, teams and players by name.
- Fixtures and results: upcoming matches, recent scores and matchdays.
- Live matches: scores, events and stats while the ball is rolling.
- League tables: current and past tables, including tournament groups.
- Player and team stats: season totals, match stats, shot maps and heatmaps.
- Odds: pre-match and in-play prices from several bookmakers.
How it works
- Create an account. Your first API key is made for you when you sign up; you can add more on the API keys page of your dashboard.
- Send the key in the
X-Api-Keyheader with every request. - Call any endpoint under
https://api.soccer-data.co/v1and read the JSON that comes back.
Try it
This request asks for Arsenal's next scheduled match:
curl "https://api.soccer-data.co/v1/matches?team_id=team_f0ibhxdw7hs5&status=scheduled&sort=utc_date&per_page=1" \
-H "X-Api-Key: YOUR_API_KEY"
Prefer clicking to typing? The API tester in your dashboard runs any endpoint as your signed-in account, with no key to paste, and shows the response.
# Soccer Data API Football data over a simple REST API, from fixtures and live scores to xG and bookmaker odds. Soccer Data gives you competitions, teams, players, fixtures, results, live scores, league tables, season and match stats, xG shot maps, heatmaps and betting odds. You ask with a plain HTTPS `GET` request and get JSON back. > **Tip:** Building with an AI coding tool? Start with [Build with AI](/docs/build-with-ai). It shows you how to hand your assistant the whole API reference in one file. ## Start here | Page | What you'll find | |---|---| | [Quickstart](/docs/quickstart) | Your first requests in about five minutes. | | [Introduction](/docs/introduction) | What the API covers and how requests and responses look. | | [Authentication](/docs/authentication) | How to send your key and keep it safe. | | [API reference](/docs/reference) | Every endpoint, with parameters, fields and examples. | | [Coverage](/docs/concepts/coverage) | Which competitions and seasons have which data. | ## Guides - [Find any ID](/docs/guides/finding-ids): look up competitions, seasons, teams and players by name. - [Fixtures and results](/docs/guides/fixtures-and-results): upcoming matches, recent scores and matchdays. - [Live matches](/docs/guides/live-matches): scores, events and stats while the ball is rolling. - [League tables](/docs/guides/standings): current and past tables, including tournament groups. - [Player and team stats](/docs/guides/player-and-team-stats): season totals, match stats, shot maps and heatmaps. - [Odds](/docs/guides/odds): pre-match and in-play prices from several bookmakers. ## How it works 1. [Create an account](/register). Your first API key is made for you when you sign up; you can add more on the [API keys](/dashboard/keys) page of your dashboard. 2. Send the key in the `X-Api-Key` header with every request. 3. Call any endpoint under `https://api.soccer-data.co/v1` and read the JSON that comes back. ## Try it This request asks for Arsenal's next scheduled match: ```bash curl "https://api.soccer-data.co/v1/matches?team_id=team_f0ibhxdw7hs5&status=scheduled&sort=utc_date&per_page=1" \ -H "X-Api-Key: YOUR_API_KEY" ``` Prefer clicking to typing? The [API tester](/dashboard/tester) in your dashboard runs any endpoint as your signed-in account, with no key to paste, and shows the response.