Sport Live Partner API

English

فارسی

English

فارسی

Appearance

Sport Live Partner APIIntegrate live sports data & streams

Production-ready REST API for licensed broadcast partners — leagues, schedules, multi-channel playback, VOD, and analytics on your domain.

Get started →
API reference
فارسی
Sport Live
🌐

Domain-scoped access

Each API key is bound to your domain. You only receive channels, events, and assets published for your site — never another partner's catalog.

🏆

League access control

Leagues are granted per partner in the Sport Live panel. Always use internal league IDs from GET /leagues — external catalog IDs are not accepted.

📡

Stream & CDN rewriting

Playback URLs, banners, badges, and posters are rewritten according to your CDN agreement so end users never leave your infrastructure.

⚡

Filters & pagination

Filter live events by league, sport, date range, and status. Paginate large schedules with page/per_page and rich metadata.

📺

Multi-channel events

When one match airs on two of your channels, the API returns one row per channel with the correct stream URL for each.

🔒

Server-to-server security

Read-only GET endpoints with API key auth. Designed for backend proxies — never expose production keys in browser JavaScript.

Base URL ​

All Partner API endpoints share this prefix:

https://api.matato.ir/partner/api/v1
ℹ️Read-only API

Every endpoint is HTTP GET. There are no write operations — your integration fetches published data only. Mutations happen in the Sport Live panel by your account team.

Quick start ​

bash
curl -s -H "X-API-Key: YOUR_API_KEY" \
  "https://api.matato.ir/partner/api/v1/leagues"

Replace YOUR_API_KEY with the key issued by Sport Live. See Authentication for header formats and security guidance.

API endpoints at a glance ​

🏆
Leagues
Leagues enabled for your key — banners, badges, posters, bilingual names.
⚽
Sport categories
Football, basketball, tennis, and more — filter live events by sport.
🔴
Live events
Schedules, live status, participants, streams, and VOD links.
📺
Channels
Channels on your domain with rewritten playback URLs.
🎬
VOD
On-demand highlights and full matches linked to your catalog.
📊
Analytics
View counts and engagement metrics for your published content.
  1. Authenticate — send X-API-Key on every request (guide).
  2. Bootstrap — call /leagues and /sport-categories once and cache the IDs.
  3. Schedule UI — poll /live-events with league_id, from/to or at, and status.
  4. Playback — use the stream field from live events or /channels; URLs are already rewritten.
  5. Post-match — check vod_url / vod_item_id on ended events or browse /vods.
💡Cache aggressively

League and category lists change rarely. Cache them for hours. Live event lists should refresh every 30–60 seconds during match days, or more often when status=live.

Event status lifecycle ​

StatusMeaning
scheduledPublished, not yet started
liveCurrently broadcasting
halftimeHalf-time break (football)
endedFinished — VOD may be available

Support & onboarding ​

Contact your Sport Live account manager to:

  • Enable additional leagues on your API key
  • Rotate a compromised key
  • Adjust CDN / stream rewrite rules
  • Whitelist a staging domain for pre-production testing