Skip to content

Livematches in play

Demo: Matchboard, opens in a new tab

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.

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"
GET /v2/leagues/172801 · trimmed
{ "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.

TopicHistoryWhat it covers of the Süper Lig
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: 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

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.