Blog · Takwimu za mpira · dakika 5 za kusoma

API ya Ligi Kuu Bara: mwongozo kamili kwa waandaaji wa programu

Na MatchGrind · 23 Oktoba 2026 · makala zote

Data ya Ligi Kuu Bara imekuwa ngumu kupata kwa njia ya programu. Timu nyingi za Tanzania zinatangaza ratiba na matokeo kwenye kurasa za mitandao ya kijamii, na tovuti ya ligi haitoi API rasmi kwa wajenzi. Matokeo yake, mtu anayetaka kujenga app ya mashabiki wa Simba, Yanga au Azam analazimika kuchambua kurasa za HTML au kukaa bila data kabisa.

Makala hii inaeleza jinsi ya kupata data hiyo kwa njia ya API: ratiba, matokeo, msimamo, orodha ya klabu, na mabao yenye dakika. Kila kitu hapa ni cha kweli — majibu yaliyoonyeshwa yametolewa moja kwa moja kutoka kwenye mfumo, si mifano ya kubuni.

Ni nini kinapatikana?

Msimu wa 2026. Kwa tza.1 kuna mechi 152 ambazo bado hazijachezwa (hadi tarehe 23 Oktoba 2026), na matokeo ya mechi zilizopita yapo. Kwa tza.2 kuna mechi 192 zilizosalia. Kila mechi ina saa ya kuanza na hali yake (bado haijaanza, inaendelea, au imeisha); uwanja unapatikana pale chanzo kinapoutoa.

Msimamo wa sasa wa Ligi Kuu Bara

Huu ni msimamo halisi unaotolewa na API, ukihesabiwa kutoka matokeo ya mechi zilizochezwa — si takwimu zilizoandikwa kwa mkono:

Msimamo hadi 23 Oktoba 2026. Pointi, mabao ya kufunga na kufungwa, na tofauti ya mabao vinapatikana vyote kupitia API.

Mechi zijazo

Saa zote hapa ni kwa saa za Afrika Mashariki (EAT, UTC+3) — API inatoa saa za UTC, kwa hiyo ongeza masaa matatu:

Jinsi ya kuanza

API iko kwenye RapidAPI. Fungua akaunti ya bure, chukua key yako, kisha anza na ombi hili:

curl 'https://global-football-api1.p.rapidapi.com/get/soccer/leagues' \
  -H 'X-RapidAPI-Key: KEY_YAKO' \
  -H 'X-RapidAPI-Host: global-football-api1.p.rapidapi.com'

Utaona orodha ya mashindano yote. Tafuta tza.1 — hiyo ni Ligi Kuu Bara. Kisha:

# Ratiba na matokeo yote ya msimu
GET /get/soccer/tza.1/fixtures

# Mechi zijazo tu
GET /get/soccer/tza.1/fixtures?status=scheduled&limit=10

# Msimamo wa ligi
GET /get/soccer/tza.1/standings

# Matokeo ya siku moja (YYYYMMDD)
GET /get/soccer/tza.1/scoreboard?dates=20261024

# Klabu zote 16
GET /get/soccer/tza.1/clubs

Kumbuka: parameter ya status inakubali all, scheduled, live, au finished pekee.

Mfano wa jibu: mabao yenye dakika

Hii ni sehemu muhimu. Kila mechi iliyochezwa ina mabao yenye dakika halisi. Mfano kutoka mechi ya Geita Gold vs Dodoma Jiji (16 Oktoba 2026):

{
  "keyEvents": [
    { "scoringPlay": true,
      "text": "Khleffin Hamdoun goal for Dodoma Jiji",
      "clock": { "value": 180, "displayValue": "3'" } },
    { "scoringPlay": true,
      "text": "Mwana Kibuta David goal for Dodoma Jiji",
      "clock": { "value": 360, "displayValue": "6'" } },
    { "scoringPlay": true,
      "text": "Khleffin Hamdoun goal for Dodoma Jiji",
      "clock": { "value": 420, "displayValue": "7'" } }
  ]
}

Crest za klabu zote zinahifadhiwa kwenye seva yetu, kwa hiyo hazitapotea ghafla kama picha zinazotolewa na tovuti za nje. Uwanja unapatikana pale chanzo kinapoutoa.

Unaweza kujenga nini?

• App ya mashabiki wa Simba, Yanga au Azam — ratiba, msimamo, na mabao yenye dakika.
• Bot ya WhatsApp au Telegram — tuma matokeo na mabao kwa makundi ya mashabiki mara mechi inapoisha.
• Widget ya tovuti — jedwali la msimamo linaloonyesha klabu unayoipenda.
• Dashibodi ya uchambuzi — wachezaji wanaofunga zaidi (kutoka matukio ya mabao) na rekodi za uwanja kwa uwanja.
• Ligi ya daraja la pili (tza.2) — tza.2 ina muundo uleule, kwa hiyo app moja inaweza kuhudumia ligi zote mbili.

Ukweli kuhusu data (muhimu)

Hatupendi kuahidi zaidi ya tulichonacho. Mambo matatu ya kujua:

1. Hakuna mchezo kwa mchezo (play-by-play) kwa Ligi Kuu. Chanzo cha data hakitoi maelezo ya kila tukio la sekunde kwa sekunde, kwa hiyo jibu la mechi linaonyesha meta.dataAvailability.timeline.available = false. Utapata mabao tu; kadi, mabadiliko na maandishi ya kila mpira hazipo kwa ligi hizi.
2. Msimamo unahesabiwa kutoka matokeo. Hii ni nzuri: hauwezi kuwa na jedwali linalokinzana na matokeo yenyewe. Lakini kama matokeo hayajaingizwa, jedwali litaonyesha hivyo.
3. Saa ni UTC. Ongeza masaa matatu kwa EAT. Mechi ya 16:00 EAT ni 13:00 UTC — usikose mechi kwa sababu ya saa.

Bei

Mpango wa BASIC ni bure kabisa: maombi 100 kwa siku, bila kadi. Hiyo inatosha kwa app ndogo ya mashabiki au bot. Kwa matumizi makubwa kuna Pro ($9.99/mwezi, maombi 20,000), Ultra ($19.99/mwezi, 150,000) na Mega ($49.99/mwezi, milioni moja).

Anza sasa

Chukua key yako ya bure kwenye ukurasa wa RapidAPI. Mfano wa msimbo wa JavaScript, Python na curl upo kwenye GitHub — pamoja na nyaraka za endpoints zote.

Ushauri wa mwisho: weka cache kwa matokeo. API inasasisha mechi zilizo hai kila sekunde 20; kama app yako inaomba kila sekunde, utamaliza kikomo chako bure. Omba mara moja kwa dakika na uhifadhi jibu — mashabiki hawataona tofauti.

Una swali au unahitaji kitu ambacho hakipo? Andika kwenye sehemu ya majadiliano ya ukurasa wa RapidAPI. Tunaongeza data inayohitajika na wajenzi wa Tanzania.

MatchGrind haihusiani rasmi na NBC Premier League, Shirikisho la Mpira wa Miguu Tanzania (TFF) au klabu yoyote; majina yao ni mali ya wamiliki.