The EmbedSportex API provides a public JSON endpoint exposing live and upcoming sports match data — organized by sport category — with embeddable iframe URLs for each available stream server. It's designed for frontend integration: fetch once, render a match schedule, embed player iframes directly.
All endpoints are accessible via the primary domain. The API is deployed on Cloudflare Pages for global low-latency delivery.
?cache=TIMESTAMPto bust browser/CDN caches during polling (e.g.?cache=1776943275).This endpoint is publicly accessible — no API key or authentication token is required. CORS is open (Access-Control-Allow-Origin: *), so you can call it directly from browser-side JavaScript.
There is no hard rate limit enforced. However, please follow these guidelines to avoid being throttled or blocked:
Returns all available sport categories with their match list and stream server options. Data is filtered to show only currently live or upcoming matches (matches that haven't ended yet based onendTime).
| Parameter | Type | Description |
|---|---|---|
| cache | integer | Optional. Unix timestamp to bust cache. e.g. ?cache=1776943275 |
The top-level JSON object contains metadata fields and one key per sport category.
| Field | Type | Description |
|---|---|---|
| successalways | boolean | Indicates whether the request was processed successfully. |
| timestamp | integer | Unix timestamp of when the response was generated. |
| READ_ME | string | Informational note for API users. |
| football | array<Match> | Football / soccer matches. |
| basketball | array<Match> | Basketball matches (NBA, etc.). |
| amfootball | array<Match> | American football matches (NFL, etc.). |
| baseball | array<Match> | Baseball matches (MLB, etc.). |
| badminton | array<Match> | Badminton events (BWF tours, etc.). |
| volleyball | array<Match> | Volleyball matches. |
| tennis | array<Match> | Tennis tournaments. |
| race | array<Match> | Motorsport events (F1, MotoGP, WRC, Formula E). |
| fight | array<Match> | Combat sports / wrestling events. |
| other | array<Match> | Miscellaneous sports not in the above categories. |
[]— the key is always present in the response.Each sport key maps to an array of Match objects. Iterate all keys or pick specific ones.
Each item inside a sport category array is a Match object.
| Field | Type | Description |
|---|---|---|
| slugkey | string | URL-friendly unique identifier for the match. e.g. "malut-surabaya" |
| tag | string | Human-readable match title / event name. e.g. "Malut United vs Persebaya Surabaya" |
| kickoff | string | Match start time inWIB (UTC+7)using formatYYYY-MM-DD HH:mm.Always add +07:00offset when parsing to a Date object. |
| endTime | string | Estimated match end time, same format and timezone askickoff.Used to determine live/ended status. May cross midnight (check date carefully). |
| league | string | Competition or league name. e.g. "BRI Super League","NBA","Formula 1" |
| iframes | array<Iframe> | One or more stream server objects for this match. See Iframe Object below. Always check length ≥ 1 before accessing index 0. |
kickoffandendTimevalues are in WIB (UTC+7). Parse with:new Date(kickoff.replace(' ', 'T') + '+07:00')Each match has aniframesarray with one entry per available stream server. Use theurlto embed directly into an<iframe>element.
| Field | Type | Description |
|---|---|---|
| server | string | Display label for the server / quality. Common patterns: SD/iOS,HD/iOS,FHD/iOS,AUTO,VIP |
| url | string | Full embeddable URL. Set as thesrcof an<iframe>element to stream.URLs point to https://api.embedsportex.site/player#... |
Abbreviated real response from the API showing one football match and one basketball match.
// GET https://api.embedsportex.site/api/streams{"success":true,"timestamp":1776943275,"READ_ME":"Interested in using our API? Contact us for more information.","football": [ {"slug":"malut-surabaya","tag":"Malut United vs Persebaya Surabaya","kickoff":"2026-04-23 19:00",// WIB (UTC+7)"endTime":"2026-04-23 21:15",// WIB (UTC+7)"league":"BRI Super League","iframes": [ {"server":"AUTO/iOS","url":"https://api.embedsportex.site/player#c2VydmVyMQ=="}, {"server":"VN1/iOS","url":"https://api.embedsportex.site/player#c2VydmVyMg=="}, {"server":"VIP/iOS","url":"https://api.embedsportex.site/player#c2VydmVyMw=="} ] } ],"basketball": [ {"slug":"knicks-hawks","tag":"New York Knicks vs Atlanta Hawks","kickoff":"2026-04-24 06:00","endTime":"2026-04-24 09:00","league":"NBA","iframes": [ {"server":"SD1/iOS","url":"https://api.embedsportex.site/player#c2VydmVyMQ=="}, {"server":"FHD/iOS","url":"https://api.embedsportex.site/player#c2VydmVyMg=="} ] } ],"amfootball": [/* ... */],"baseball": [/* ... */],"badminton": [/* ... */],"volleyball": [/* ... */],"tennis": [/* ... */],"race": [/* ... */],"fight": [/* ... */],"other": [] }
Fetch all matches and render football with iframe embed:
constAPI ='https://api.embedsportex.site/api/streams';async functionloadMatches() {constres =awaitfetch(`${API}?cache=${Date.now()}`);constdata =awaitres.json();// Parse timestamp, determine live/upcomingfunctiongetStatus(kickoff, endTime) {constnow = Date.now();conststart =newDate(kickoff.replace(' ','T') +'+07:00').getTime();constend =newDate(endTime.replace(' ','T') +'+07:00').getTime();if(now < start)return'upcoming';if(now <= end)return'live';return'ended'; }// Render football matchesdata.football.forEach(match =>{conststatus = getStatus(match.kickoff, match.endTime);constfirstUrl = match.iframes[0]?.url; console.log(`[${status.toUpperCase()}] ${match.tag} — ${match.league}`);// Embed first server as iframeif(firstUrl) {constiframe = document.createElement('iframe'); iframe.src = firstUrl; iframe.width ='100%'; iframe.height ='400'; iframe.allowFullscreen =true; document.body.appendChild(iframe); } }); } loadMatches(); setInterval(loadMatches,30000);// poll every 30s
importrequestsfromdatetimeimportdatetime, timezone, timedelta API ="https://api.embedsportex.site/api/streams"WIB = timezone(timedelta(hours=7)) res = requests.get(API, timeout=10) data = res.json()forsport, matchesindata.items():if notisinstance(matches, list)or notmatches:continueprint(f"\n=== {sport.upper()} ===")forminmatches: kickoff = datetime.fromisoformat(m['kickoff']).replace(tzinfo=WIB) servers = [s['server']forsinm['iframes']] print(f" {m['tag']} [{m['league']}]") print(f" Kickoff : {kickoff.strftime('%d %b %Y %H:%M')} WIB") print(f" Servers : {', '.join(servers)}") print(f" URL : {m['iframes'][0]['url']}")
curl -s "https://api.embedsportex.site/api/streams" \ -H "Accept: application/json" | python3 -m json.tool
Send a live request to the API and see the raw JSON response.
Please follow these rules to ensure reliable access for all users.
iframes[0]gracefully.Interested in using this API commercially, integrating into a larger product, or need extended access? Reach out via the EmbedSportex website.