Primeira Liga API

Primeira Liga data as JSON for developers: the 2026-27 table, fixtures and results, live scores every 30 seconds, lineups, match events and per-player statistics. One REST call per question, through RapidAPI, with a free tier.

Get a key for Primeira Liga

What the API holds for the Primeira Liga

This season
2026-27: 18 clubs, 98 of 305 matches played.
Match detail
Lineups with formations and player ratings for 98 of 98 finished matches, 53 statistics per player (xG, passes, duels, saves) for 98, and the timeline of goals, cards and substitutions for 98.
History
2025-26, 2026-27: 406 finished matches stored. Earlier seasons answer through the same endpoints with ?season=.
Live
Score, minute, lineups and events refresh every 30 seconds while a match is on. Next: Maritimo v Nacional Madeira, 27 Nov.
Price
Free for 500 calls a month, no card. Then $5 for 5,000, $10 for 50,000 or $20 for 500,000. Every plan reaches every endpoint, live scores included.

A real response

The latest Primeira Liga match, Rio Ave 0–1 SC Braga on 8 Nov, exactly as the API returns it, cut to one player, one event and eight of that player's statistics.

curl -H "X-RapidAPI-Key: YOUR_KEY" \
  -H "X-RapidAPI-Host: primeira-liga1.p.rapidapi.com" \
  "https://primeira-liga1.p.rapidapi.com/matches/809908996"
{
  "data": {
    "id": 809908996,
    "competition": "primeira-liga",
    "season": "2026-27",
    "stage": null,
    "round": 11,
    "kickoff": "2026-11-08T20:30:00.000Z",
    "status": "finished",
    "minute": 90,
    "homeTeam": {
      "id": 1215139073,
      "slug": "rio-ave",
      "name": "Rio Ave",
      "shortName": null,
      "code": "RIO",
      "crestUrl": "https://football-api.yuvron.online/images/team/1215139073.png"
    },
    "awayTeam": {
      "id": 618108432,
      "slug": "sc-braga",
      "name": "SC Braga",
      "shortName": "Braga",
      "code": "BRA",
      "crestUrl": "https://football-api.yuvron.online/images/team/618108432.png"
    },
    "score": {
      "home": 0,
      "away": 1
    },
    "venue": "Estádio do Rio Ave Futebol Clube",
    "referee": "Cláudio Pereira",
    "playedMinutes": 96,
    "lineups": {
      "home": {
        "formation": "4-2-3-1",
        "starting": [
          {
            "player": {
              "id": 1295391161,
              "slug": "miguel-patricio",
              "name": "Miguel Patrício",
              "photoUrl": "https://football-api.yuvron.online/images/player/1295391161.png"
            },
            "shirtNumber": 79,
            "position": "AM",
            "minutes": 76,
            "rating": 7,
            "goals": 0,
            "assists": 0,
            "stats": {
              "expectedGoals": 0.06,
              "shots": 1,
              "shotsOnTarget": 1,
              "keyPasses": 1,
              "expectedAssists": 0.04,
              "passesCompleted": 12,
              "passesAttempted": 16,
              "tacklesWon": 0,
              "…": "45 more fields"
            }
          },
          "… 10 more starters"
        ],
        "bench": [
          "… 12 substitutes, the same shape"
        ]
      },
      "away": "… the same, for SC Braga"
    },
    "events": [
      {
        "minute": 67,
        "addedTime": 0,
        "type": "goal",
        "subtype": "penalty",
        "label": "Penalty goal",
        "teamId": 618108432,
        "player": {
          "id": 1877835684,
          "slug": "ricardo-horta",
          "name": "Ricardo Horta",
          "photoUrl": "https://football-api.yuvron.online/images/player/1877835684.png"
        },
        "secondaryPlayer": null
      },
      "… 13 more events"
    ]
  },
  "meta": {
    "season": "2026-27"
  }
}

Endpoints

/standingsLeague table
/matchesFixtures and results
/matches/liveLive matches
/matches/{id}Match detail
/teams/{id}/squadSquad
/teams/{id}/statsTeam season statistics
/players/{id}Player
/stats/top-scorersTop scorers
/stats/expected-goalsHighest expected goals (xG)
/teams/{id}/head-to-head/{otherId}Head to head

Every path sits under https://primeira-liga1.p.rapidapi.com. The rest, with every parameter, are in the API reference.

2026-27 table

#TeamPWDLGDPtsForm
1FC Porto111100+2233WWWWW
2Benfica11911+2028LWWWW
3Sporting CP11731+1324DWLWW
4Santa Clara11632+821DWLWL
5Arouca11623+520DWWWL
6Viseu11623+220WWWWL
7Gil Vicente FC11533+218WWLDW
8SC Braga11524+217LLLWW
9Moreirense11425-514DLWWL
10Famalicão11344+113WLWLW
11Alverca11335-112WWLLD
12Estrela da Amadora11245-510LLLLL
13Nacional Madeira11317-810LLWLW
14Guimarães11236-19DLWDL
15Maritimo10226-128LDLLL
16Casa Pia AC11227-148WLWLD
17Rio Ave11218-157LWLLL
18Estoril10028-142LLLLL

Latest results

8 NovRio Ave0–1SC Braga
8 NovEstrela da Amadora2–3Benfica
8 NovGuimarães1–2FC Porto
8 NovNacional Madeira1–0Viseu
8 NovSanta Clara1–2Gil Vicente FC
7 NovSporting CP1–0Moreirense
7 NovAlverca1–1Casa Pia AC
6 NovFamalicão1–0Arouca
2 NovBenfica1–0Alverca
2 NovGil Vicente FC0–0Guimarães

Next fixtures

27 NovMaritimovNacional Madeira
28 NovMoreirensevSanta Clara
28 NovAroucavRio Ave
28 NovViseuvAlverca
28 NovGuimarãesvEstrela da Amadora
29 NovGil Vicente FCvEstoril
29 NovFC PortovSporting CP
30 NovBenficavFamalicão
30 NovCasa Pia ACvSC Braga
4 DecSporting CPvMaritimo

Top scorers

#PlayerClubGoalsAssistsxG
1Vangelis PavlidisBenfica1138.4
2Luis SuarezSporting CP915.6
3Gianluca PrestianniBenfica742.3
4Borja SainzFC Porto613.3
5Gabri VeigaFC Porto543.3
6Gonçalo PaciênciaSanta Clara513.5
7Pau VictorSC Braga513.9
8André ClovisViseu514.7
9Leandro AntonettiEstrela da Amadora513.9
10Ivan BarberoArouca503.3

The same ranking is /stats/top-scorers; /stats/expected-goals orders it by xG.

The season so far

98 matches played, 207 more scheduled. 258 goals, 2.63 a match. The home side won 40%, 20% ended level and the away side won 40%. Widest margin so far: Casa Pia AC 0–7 Benfica on 17 Aug.

Other competitions

Premier League · La Liga · Serie A · Bundesliga · Ligue 1 · Eredivisie · Super Lig · Championship · Champions League · Europa League · Conference League · Nations League · MLS · Brasileirao