Ligue 1 API
A football (soccer) API for Ligue 1, France's top division: get the fixtures for every matchday, live scores with the match minute on paid plans, results with goals per half, the table with the European, relegation playoff and relegation places, and the squads of Paris Saint-Germain, Marseille, Monaco and every other club. The free plan covers the current season's fixtures, results, table and squads.
Ligue 1 is served by the Football (Soccer) API with league=ligue1. The same API key works for every sports API.
Available endpoints:
- /v1/soccermatches - Ligue 1 fixtures, live scores and results
- /v1/soccerstandings - Ligue 1 table
- /v1/soccerclubs - Ligue 1 clubs
- /v1/soccerplayers - Ligue 1 squads and players
Ligue 1 data at a glance
| Season value | season=2026 is the 2026-27 season, August to May |
|---|---|
| Format | 18 clubs, 34 matchdays; league matches have season_type=regular |
| Match day | date is the date in France (Central European time) |
| Scoring | Goals per half in period_scores; draws have winner: null |
| Live matches | On paid plans: score, half, match minute and halftime |
| Club ids | soccer-paris-saint-germain, soccer-marseille: one id per club, shared with the Champions League and Europa League |
| Squads | Position, shirt number, nationality, birth date, height and weight |
Ligue 1 table fields
points, wins, draws, losses, goals_for, goals_against, goal_difference and league_rank, ordered by points with Ligue 1's tiebreakers applied. qualification shows the Champions League, Champions League qualifying, Europa League and Conference League qualifying places, the 16th-place Relegation playoff and the two Relegation places.
https://api.api-ninjas.com/v1/soccermatches
Returns fixtures, live scores and results. Ask for one day, a team's season or one match; with only league you get today's matches. Paid plans see matches in progress with the score, half and match minute updated throughout the match; the free plan sees their status and the final score once they end. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.
Full parameter and response reference: /v1/soccermatches.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
cURL
Python
JavaScript
Node.js
Java
Swift
TypeScript
PHP
C#
Ruby
Go
Kotlin
Rust
React
Vue
Angular
Laravelcurl -X GET "https://api.api-ninjas.com/v1/soccermatches?league=ligue1" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/soccerstandings
Returns the table for a season, ordered by league rank, or by conference or division rank when you filter. Tables update throughout the season, shortly after each match ends. The free plan covers the current season. Developer plans add the three previous seasons, and the Business tier and above gets the full season archive.
Full parameter and response reference: /v1/soccerstandings.
Live Demo
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/soccerstandings?league=ligue1" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/soccerclubs
Lists clubs with their domestic league, country and home venue. Available on every plan.
Full parameter and response reference: /v1/soccerclubs.
Live Demo
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/soccerclubs?league=ligue1" \
-H "X-Api-Key: YOUR_API_KEY"https://api.api-ninjas.com/v1/soccerplayers
Returns current squads and player profiles, by team or by name. Rosters refresh every day. Available on every plan.
Full parameter and response reference: /v1/soccerplayers.
Live Demo
Get a free API key to get started — no credit card required.
Code Examples
curl -X GET "https://api.api-ninjas.com/v1/soccerplayers?league=ligue1&team=PSG" \
-H "X-Api-Key: YOUR_API_KEY"Frequently Asked Questions
Can I use the Ligue 1 API for commercial purposes?
Yes, but you must have a premium subscription. Commercial use of the Ligue 1 API is not permitted on the free tier. See our pricing page to choose a plan that fits your needs.How do I get an API key and start using the Ligue 1 API?
Sign up for a free account to instantly get your API key, then pass it in theX-Api-Keyheader on every request. The documentation above includes ready-to-run examples in cURL, Python, JavaScript, Node.js, and more.What happens if I exceed my quota for the month?
Your API requests will simply be denied once you hit your monthly quota — you will never be charged more than the plan you signed up for. To increase your quota, you can upgrade your plan any time on our pricing page.What happens if a request to the Ligue 1 API fails?
The API responds with a standard HTTP status code and a JSON error message describing the problem. See our error codes reference for the full list of codes and how to resolve each one, or contact support if you need help.Is there an official Ligue 1 API?
Ligue 1 does not publish a public API for developers. The API Ninjas Football (Soccer) API provides Ligue 1 fixtures, live scores, results, the table and squads withleague=ligue1. API Ninjas is not affiliated with or endorsed by the LFP or Ligue 1.How do I get Paris Saint-Germain's matches?
Call/v1/soccermatches?league=ligue1&team=PSGfor the club's matches this season; each match'sleaguetells you the competition. The club id issoccer-paris-saint-germainin Ligue 1 and in the Champions League.How many clubs and matchdays does Ligue 1 have?
18 clubs and 34 matchdays. The table'squalificationfield marks the Champions League, Europa League and Conference League places, the 16th-placeRelegation playoffand the twoRelegationplaces.What does a Ligue 1 result look like?
Each final match has the score, goals per half inperiod_scores,decided_in=regulationand thewinnerclub id, orwinner: nullfor a draw.
Explore API integration use cases for recommended APIs and workflow examples.
API Ninjas is not affiliated with or endorsed by the NFL, the NBA, the NHL or any other league, competition or team. League, competition and team names are trademarks of their owners and are used only to identify them.