← Back to marketplace

Goal

Fast JSON API for Goal football data - live scores, fixtures, match details, lineups, statistics, predictions, competitions, teams and players.

other
by Mark823 endpoints100% uptime269ms avg

Includes 100 free calls per month

After the free quota, standard per-request pricing applies via x402 (USDC on Base).

Endpoints

GET/v1/competition/details
$0.0010/req

Returns the competition overview (competition info, standings snapshot, recent/upcoming matches, seasons and teams).

GET/v1/competition/details/gamesets
$0.0010/req

Returns the competition game weeks / rounds (gamesets). Each gameset provides the game_set_type_id and round id required to load its matches.

GET/v1/competition/details/knockout
$0.0010/req

Returns the knockout bracket for cup competitions (e.g. World Cup). Empty for league competitions.

GET/v1/competition/details/matches
$0.0010/req

Returns the matches of a single game week. Pass a game_set_type_id taken from a gameset returned by the gamesets endpoint; when it is omitted the currently active game week is returned.

GET/v1/competition/details/standings
$0.0010/req

Returns the competition standings (overall, home and away).

GET/v1/competition/details/top-players
$0.0010/req

Returns the competition top players by stat (goals, assists, cards, shots on target, fouls, tackles, offsides). Empty for competitions whose current season has no player stats yet.

GET/v1/match/details
$0.0010/req

Returns the general match info (competition, teams, score, venue, referee, season, round).

GET/v1/match/details/events
$0.0010/req

Returns the match events, key events and scorers.

GET/v1/match/details/h2h
$0.0010/req

Returns the head-to-head history between the two teams.

GET/v1/match/details/lineups
$0.0010/req

Returns the lineups (formations, starters and bench) for both teams.

GET/v1/match/details/predictions
$0.0010/req

Returns the prediction/poll data for a match.

GET/v1/match/details/standings
$0.0010/req

Returns the competition standings related to the match.

GET/v1/match/details/stats
$0.0010/req

Returns the team match statistics.

GET/v1/match/details/top-players-ratings
$0.0010/req

Returns each team lineup and bench players that have a rating, sorted by rating (highest first).

GET/v1/match/list
$0.0010/req

Returns all football matches for a specific date, grouped by competition.

GET/v1/match/live
$0.0010/req

Returns football matches that are currently in progress, grouped by competition.

GET/v1/player/details
$0.0010/req

Returns the player profile (bio, position, nationality, current team and season stats).

GET/v1/player/details/career
$0.0010/req

Returns the player career history by team and season.

GET/v1/team/details
$0.0010/req

Returns the team overview (team, competition, standings snapshot and recent/upcoming matches).

GET/v1/team/details/matches
$0.0010/req

Returns the team matches (fixtures and results).

GET/v1/team/details/squad
$0.0010/req

Returns the team squad (players grouped by position and coach).

GET/v1/team/details/standings
$0.0010/req

Returns the league standings (overall, home and away) for the team competition.

GET/v1/team/details/top-players
$0.0010/req

Returns the team top players by stat (goals, assists, cards, etc.).

Quick start

Easiest way: the APIHub CLI. Credits cover x402, no wallet needed.

# install and set up once
npx @apihubio/cli register
npx @apihubio/cli topup 10

# call this service
npx @apihubio/cli call -X GET "https://proxy.apihub.io/goal/v1/competition/details?competition_id=34pl8szyvrbwcmfkuocjm3r6t"

Or call the proxy directly (curl / any HTTP client):

curl https://proxy.apihub.io/goal/v1/competition/details?competition_id=34pl8szyvrbwcmfkuocjm3r6t \
  -H "Authorization: Bearer ahk_your_key"

# If credits available: charged automatically, returns 200
# Otherwise: returns 402 (pay via @x402/fetch or top up credits)

Pricing calculator

Estimate your monthly cost for Goal.

GET /v1/competition/details$0.0010/req
-
GET /v1/competition/details/gamesets$0.0010/req
-
GET /v1/competition/details/knockout$0.0010/req
-
GET /v1/competition/details/matches$0.0010/req
-
GET /v1/competition/details/standings$0.0010/req
-
GET /v1/competition/details/top-players$0.0010/req
-
GET /v1/match/details$0.0010/req
-
GET /v1/match/details/events$0.0010/req
-
GET /v1/match/details/h2h$0.0010/req
-
GET /v1/match/details/lineups$0.0010/req
-
GET /v1/match/details/predictions$0.0010/req
-
GET /v1/match/details/standings$0.0010/req
-
GET /v1/match/details/stats$0.0010/req
-
GET /v1/match/details/top-players-ratings$0.0010/req
-
GET /v1/match/list$0.0010/req
-
GET /v1/match/live$0.0010/req
-
GET /v1/player/details$0.0010/req
-
GET /v1/player/details/career$0.0010/req
-
GET /v1/team/details$0.0010/req
-
GET /v1/team/details/matches$0.0010/req
-
GET /v1/team/details/squad$0.0010/req
-
GET /v1/team/details/standings$0.0010/req
-
GET /v1/team/details/top-players$0.0010/req
-