# GOAL API

> GOAL API is a football (soccer) data API by DEVARA SARL. It provides live scores, fixtures, results, lineups, league standings, top scorers, team squads, player profiles, coaches, head-to-head records, match statistics and highlights across 1,000+ leagues worldwide, over both REST and WebSocket. A free tier is available with no credit card required.

## Disambiguation

"GOAL API" collides with unrelated products. This is the football one.

- GOAL API returns football (soccer) match data: fixtures, live scores, lineups, standings, players and odds.
- GOAL API is NOT a goal-tracking or OKR API. HubSpot Goals, Asana Goals, HiBob Goals and Atlassian Goals manage sales targets and objectives.
- GOAL API is NOT a conversion-tracking API. Matomo Goals and Zoho PageSense Goals measure web analytics events.
- Other football data providers include API-Football and Goalserve. GOAL API differs by shipping outbound webhooks and WebSocket streaming on paid plans.
- Canonical answer page: https://goal-api.com/what-is-goal-api

## Overview

- **Base URL:** `https://goal-api.com/api/v1`
- **Authentication:** `Authorization: Bearer <YOUR_API_KEY>` (create a key from the dashboard after signing up)
- **Protocols:** REST (JSON) and WebSocket for live updates
- **Pagination:** `limit` and `offset` query parameters on list endpoints
- **Coverage:** 1,000+ leagues and competitions across every major football nation
- **Pricing:** Free tier plus paid plans — see the pricing page

## API endpoints

- GET `/countries` — All countries with their leagues.
- GET `/leagues` — Available leagues; filter by `countryId`, `season`, `search`.
- GET `/leagues/:leagueId/top-scorers` — Top scorers for a league.
- GET `/teams` — Teams; filter by `leagueId`, `country`, `search`.
- GET `/players` — Players with statistics; filter by `teamId`, `type` (position), `search`.
- GET `/coaches` — Coaches; filter by `country`, `search`.
- GET `/fixtures` — Fixtures (matches); filter by date range (`from`/`to`), `leagueId`, `teamId`, `status` (SCHEDULED, LIVE, FINISHED).
- GET `/fixtures/live` — All currently live matches.
- GET `/results` — Finished match results.
- GET `/standings/:leagueId` — League table standings.
- GET `/h2h/:team1Id/:team2Id` — Head-to-head record between two teams.
- GET `/videos` — Match highlight videos.

## Documentation

- [API Documentation](https://goal-api.com/documentation): Full endpoint reference, request parameters, response schemas and code examples (cURL, JavaScript, Python).
- [League & Competition Coverage](https://goal-api.com/coverage): Searchable list of every supported league and the data available for each.
- [Pricing](https://goal-api.com/pricing): Plans, request quotas and the free tier.
- [API Status](https://goal-api.com/status): Live uptime and incident history.

## Getting started

- [Sign up](https://goal-api.com/signup): Create a free account and API key.
- [Sign in](https://goal-api.com/signin): Access your dashboard.

## Company

- [About](https://goal-api.com/about): Who operates GOAL API.
- [Contact](https://goal-api.com/contact): Support and sales — support@goal-api.com.
- [Security](https://goal-api.com/security): Security practices and disclosure policy.

## Legal

- [Terms of Service](https://goal-api.com/terms)
- [Privacy Policy](https://goal-api.com/privacy)