Football · Turkey · 18 clubs
Süper Lig API with every season since 1980/81
A Süper Lig API that serves Turkey's top division from a single league id, 172801: fixtures and live scores, the table, referees, line-ups and match statistics. Every season from 1980/81 to the current one sits in the archive, and the answers use the field names of all our other football data.
- 47 seasons since 1980/81
- 18 clubs · 306 matches a season
- League id 172801
- Referee records on every plan

Trendyol Süper Lig
GET /v2/leagues/172801
- League id
172801- Category
- Turkey
- Tier
- 1
- Archive
- 47 seasons since 1980/81
- Teams
- 18 clubs
- Matches
- 306 matches a season
- Division below
- Trendyol 1.Lig
- Live channel
league:172801
In the data
The Süper Lig in the API
What league id 172801 holds, and how its seasons are laid out.
Trendyol Süper Lig, id 172801
The API returns the league under its full name, Trendyol Süper Lig, so code that matches on the name has to cope with the Trendyol prefix and the ü; look the league up once and keep the id. GET /v2/leagues/172801 files it under Turkey at tier 1, names the Trendyol 1.Lig in lowerDivisions and dates the current season from 14 August 2026 to 23 May 2027. Its /seasons call goes back to 1980/81 with the newest season on top, and the season id it hands out is the key to that season's table, fixtures and statistics.
Home and away, 306 matches
Each of the 18 clubs meets the other seventeen at home and away: 34 matches apiece, 306 in the season. /standings serves the table overall, or from home or away matches alone with type=home or type=away, and every row carries form, its last five results, and zone, the qualification or relegation band it sits in. /v2/teams/{id}/position-history charts a club's place week by week, and the season's own detail lists the clubs up from the Trendyol 1.Lig in newcomersLowerDivision, Erzurumspor FK among them in 2026/27.
Referees and managers on record
Of all the fixture calls, only /v2/fixtures/{id} names the referee, with their career cards per game, and the two managers. /v2/referees/{id} splits a referee's appearances, cards and penalties awarded by competition, so their Süper Lig record reads apart from the rest of their career, and /v2/referees/{id}/fixtures lists the matches they have had and those they are assigned to. For the benches, /v2/managers/{id} gives every job a manager has held with its own record, and /v2/fixtures/{id}/h2h adds the two managers' personal duel.
Endpoints
The calls behind a Süper Lig app
Each takes league id 172801, a season id from its seasons list, or a match or team id from those. Every row opens its page in the docs.
- GET
/v2/leagues/{id}/seasonsSeasonsEvery Süper Lig season since 1980/81, newest first.All plans - GET
/v2/leagues/{id}/seasons/{seasonId}SeasonRunning totals of a season and the clubs up from the Trendyol 1.Lig.All plans - GET
/v2/leagues/{id}/standingsStandingsOverall, home-only or away-only table, with form and zone per row.All plans - GET
/v2/teams/{id}/position-historyPosition historyA club's league place at the end of every week of the season.All plans - GET
/v2/fixtures/{id}FixtureOne match in full, with the referee and both managers.All plans - GET
/v2/referees/{id}RefereeA referee's career cards, and appearances, cards and penalties per competition.All plans - GET
/v2/fixtures/{id}/h2hHead to headThe clubs' recent meetings tallied, plus the two managers' own duel.All plans - GET
/v2/rankings/{type}RankingUEFA coefficients for countries and clubs, leaders first.All plans
First request
The Süper Lig in three calls
Every call starts from the league id, 172801. 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/172801/seasons" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
# The home table: points won at home only
curl "https://api.datasportsapi.com/v2/leagues/172801/standings?season={seasonId}&type=home" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"
# Season totals and the clubs promoted from the 1.Lig
curl "https://api.datasportsapi.com/v2/leagues/172801/seasons/{seasonId}" \
-H "Authorization: Bearer $DATASPORTSAPI_API_KEY"{ "data": {
"id": 172801, "name": "Trendyol Süper Lig", "sport": "football",
"category": "Turkey", "tier": 1,
"lowerDivisions": [ { "name": "Trendyol 1.Lig", … } ],
"currentSeasonStart": "2026-08-14", "currentSeasonEnd": "2027-05-23",
…
} }History
How much of the Süper Lig each plan reads
The archive goes back to 1980/81. Each plan reads back a set time from today; nothing live or upcoming is ever held back.
| Topic | History | What it covers of the Süper Lig |
|---|---|---|
| Free | Last 7 days | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 7 days. |
| Starter | Last 30 days | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 30 days. |
| Pro | Last 6 months | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 6 months. |
| Business | Last 12 months | Live and upcoming matches, the table and statistics of a season still being played, and finished matches from the last 12 months. |
| Enterprise | Full history | The whole archive: 47 seasons since 1980/81. |
Questions
Süper Lig API, answered
Anything else? The full FAQ covers quota, plans and the data in general.
Which league id is the Süper Lig?
172801. The API calls the league Trendyol Süper Lig, so matching on whatever name a user types, with or without the ü, is fragile. Our league ids are permanent and can be hard-coded, and the league card gives the Trendyol 1.Lig's id in lowerDivisions as well.
Which clubs were promoted to the Süper Lig this season?
/v2/leagues/172801/seasons/{seasonId} lists them in newcomersLowerDivision; for 2026/27, Erzurumspor FK is one of them. Next to them sit the season's figures so far, from goals scored to yellow and red cards. The race for the next promotion places is in the Trendyol 1.Lig's own table, reached with the id from lowerDivisions.
Can I get Turkey's UEFA coefficient?
Yes, on every plan. /v2/rankings/uefa-countries ranks the countries, leaders first; on its rows team is null, country holds the country and league its top division, which for Turkey is this league. Turkish clubs' own coefficients are in /v2/rankings/uefa-clubs, or one club at a time in /v2/teams/{id}/rankings.
How far back does Süper Lig data go?
To 1980/81: the archive holds 47 seasons of the Süper Lig. 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 Süper Lig matches live on the free plan?
Yes. Live and upcoming matches are never held back by a plan, so a Free key follows every Süper Lig 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:172801 pushes every change instead.
Keep reading
Other competitions
Premier League APILeague id 195828: live scores, the table, xG and every season since 1992/93.
Champions League APILeague id 4409: the 36-club league phase, the knockout bracket and every season since 1992/93.
La Liga APILeague id 4408: Spain's top flight, head-to-head records and every season since 1969/70.
Serie A APILeague id 195910: Italy's top flight, venues and the longest big-five archive, back to 1965/66.
Bundesliga APILeague id 195937: Germany's 18 clubs, the team of the week and every season since 1970/71.
Ligue 1 APILeague id 195793: France's top flight, every player's statistics and seasons since 1970/71.
World Cup APILeague id 195843: all 23 tournaments from 1930 to 2026, group tables and the bracket.
MLS APILeague id 6540: 30 clubs, two conference tables and calendar-year seasons since 2008.
Europa League APILeague id 43443: one 36-club table, knockout ties on aggregate and seasons since 2009/10.
NBA APILeague id 198277: box scores, play-by-play, shot charts, the draft and live player tracking.
NFL APILeague id 201295: down and distance live, win probability, the draft and seasons back to 1920.
NHL APILeague id 201302: conference and division tables, shot maps by strength, the three stars and playoff series.
MLB APILeague id 201220: the live count, every at-bat and pitch, umpire crews and ballpark weather.
IPL APILeague id 195830: full scorecards, every ball with wagon wheel and pitch map, and seasons since 2013.
Everything in the football data Sports statistics API Live scores API
Build on the Süper Lig today.
1,000 free requests a day during the beta. No card, no sales call.