Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

Football · France · Tier 1

Ligue 1 API with every season since 1970/71

A Ligue 1 API for France's top flight: live scores, fixtures, the table, line-ups, statistics and transfers on league id 195793, with every season back to 1970/71, in the same JSON as the rest of football.

  • 57 seasons since 1970/71
  • 18 clubs · 306 matches a season
  • League id 195793
  • Every player's statistics from Pro

Ligue 1

GET /v2/leagues/195793

League id
195793
Category
France
Tier
1
Archive
57 seasons since 1970/71
Teams
18 clubs
Matches
306 matches a season
Division below
Ligue 2
Live channel
league:195793

In the data

The Ligue 1 in the API

What league id 195793 holds, and how its seasons are laid out.

Not the only Ligue 1

Several French-speaking countries call their top flight Ligue 1 as well, the DR Congo among them, so pin league id 195793 rather than matching on the name. Its league card says France, tier 1, and names Ligue 2 in lowerDivisions; /seasons lists every season from 1970/71 to the current one, newest first.

Eighteen clubs, read in full

Since 2023/24 Ligue 1 has 18 clubs, 34 rounds and 306 matches; older seasons keep the size they were played at. From Pro, /v2/leagues/195793/player-statistics puts every player of a season in one table, 20 to a page, sorted by any statistic and filtered by club or position, which turns a scouting list or a fantasy tool into one request per page.

Who comes and who goes

The transfer feed, /v2/transfers?league=195793, follows every move into or out of the league's clubs, newest, biggest fee or most followed first, and narrows by position, nationality and age. A club's arrivals and departures over the past year come from /v2/teams/{id}/transfers, its squad with contract dates and injuries from /squad, and a player's career path from /v2/players/{id}/transfers.

First request

The Ligue 1 in three calls

Every call starts from the league id, 195793. The seasons list gives the season ids, newest first, and the season id is what the tables, rounds, leaderboards and statistics ask for.

The answers use the usual { data, meta } envelope and the same field names as every other football competition, so the code works unchanged for the next league you add.

# Every season, newest first, with its season id
curl "https://api.datasportsapi.com/v2/leagues/195793/seasons" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"

# Every player of the season, 20 to a page (Pro and up)
curl "https://api.datasportsapi.com/v2/leagues/195793/player-statistics?season={seasonId}" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"

# The latest moves into and out of Ligue 1
curl "https://api.datasportsapi.com/v2/transfers?league=195793" \
  -H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
GET /v2/leagues/195793 · trimmed
{ "data": {
    "id": 195793, "name": "Ligue 1", "sport": "football",
    "category": "France", "country": { "code": "FR", "name": "France" },
    "tier": 1, "gender": "male",
    "lowerDivisions": [ { "name": "Ligue 2", … } ],
    …
} }

History

How much of the Ligue 1 each plan reads

The archive goes back to 1970/71. Each plan reads back a set time from today; nothing live or upcoming is ever held back.

TopicHistoryWhat it covers of the Ligue 1
FreeLast 7 daysLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 7 days.
StarterLast 30 daysLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 30 days.
ProLast 6 monthsLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 6 months.
BusinessLast 12 monthsLive and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 12 months.
EnterpriseFull historyThe whole archive: 57 seasons since 1970/71.

Questions

Ligue 1 API, answered

Anything else? The full FAQ covers quota, plans and the data in general.

How many clubs and matches does a Ligue 1 season have?

Eighteen clubs and 306 matches over 34 rounds since 2023/24. Earlier seasons are kept at the size they were played at, so a season from the twenty-club years has 380 matches; /rounds and /fixtures always reflect the season you ask for.

Can I list every Ligue 1 player with their statistics?

Yes, from Pro. /v2/leagues/195793/player-statistics returns every player of a season, 20 to a page, with a column set of your choice (summary, attack, defense, passing, goalkeeping or other), sorted by any statistic and filtered by club or position.

Can I follow transfers into and out of Ligue 1?

Yes, on every plan. /v2/transfers?league=195793 keeps only moves to or from the league's clubs, 50 to a page, ordered by date, fee or popularity, and can be narrowed by position, nationality and age.

How far back does Ligue 1 data go?

To 1970/71: the archive holds 57 seasons of the Ligue 1. How far back a key can read is set by its plan, counted back from today: Free 7 days, Starter 30 days, Pro 6 months, Business 12 months, and Enterprise the whole archive. Live and upcoming matches, and the table and statistics of a season still being played, are open on every plan.

Can I follow Ligue 1 matches live on the free plan?

Yes. Live and upcoming matches are never held back by a plan, so a Free key follows every Ligue 1 match in play through /v2/livescores or /v2/fixtures/{id}, with score, status and clock current to the second, within the plan's request quota. On Business and Enterprise, the WebSocket channel league:195793 pushes every change instead.

Keep reading

Other competitions

Everything in the football data Sports statistics API Live scores API

Build on the Ligue 1 today.

1,000 free requests a day during the beta. No card, no sales call.