You need live sports data you can ship this week: team winner odds by bookmaker, fresh team/player news, and a tennis tournament calendar you can plug into your app without scraping. By the end of this guide, you’ll query FlashScore - Live API for those datasets with copy-pasteable requests, parse the responses, and wire them into your product or a cron-driven job.
What you can build with FlashScore - Live API
The FlashScore - Live API provides structured sports data that’s ready for production use:
- Team winner outright odds across bookmakers, with “best” and “active” flags you can use to highlight market-leading prices.
- Latest news for specific teams and players, including title, link, source, image, and publication time (as an epoch timestamp).
- A tennis tournament calendar (example provided) with tournament metadata, surface, schedule, country, and winner details.
Typical use cases include sportsbook comparison widgets, betting content pages, fan apps with targeted news feeds, CRM/email personalization based on player/team mentions, and tennis schedule modules. Everything runs over HTTPS via Zyla API Hub so you use a single API key and subscription across thousands of APIs.
Getting started on Zyla API Hub
Open the API page, click Subscribe or Start 7-day trial, and grab your API key. Authentication is via Authorization: Bearer YOUR_API_KEY on every request. Billing is subscription + quota (not pay-per-call). There is no Free Plan; the first API includes a 7-day trial or 50 requests—check the API page for current access options and pricing.
- Start 7-day trial on FlashScore - Live API
- Explore more than 10,000 public APIs at Zyla API Hub
Endpoints you can ship today
Below are the endpoints available in this article, including exact request URLs and methods. All requests must include the Authorization: Bearer YOUR_API_KEY header.
1) Get Team Winner Odds
Returns the odds of a specific team to win each tournament it plays in, per bookmaker.
- Method: GET
- URL: https://zylalabs.com/api/12518/flashscore-live-api/40619/get-team-winner-odds
- Query params:
- team_id (string, required): e.g., Wtn9Stg0
- geo_ip_code (string, optional): e.g., GB (use to constrain bookmaker availability by region)
cURL (copy-paste):
curl -s -X GET "https://zylalabs.com/api/12518/flashscore-live-api/40630/get-tennis-tournament-calendar?type=atp" \
-H "Authorization: Bearer YOUR_API_KEY"
Notes for implementers:
- Use is_best to highlight the current top price.
- Only display active markets (is_active) where required by your UX.
- The same team may appear in multiple tournaments; iterate all array items.
2) Get Player News
Returns the latest news articles about a specific player with title, link, image, source and publication time.
- Method: GET
- URL: https://zylalabs.com/api/12518/flashscore-live-api/40617/get-player-news
- Query params:
- player_id (string, required): e.g., dMPo6IPH
cURL (for reference):
Example response:
[
{
"name": "Brisbane ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/brisbane/",
"start_timestamp": 1767510600,
"end_timestamp": 1768104000,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "O8qG0Nhb",
"name": "Medvedev Daniil",
"player_url": "/player/medvedev-daniil/O8qG0Nhb/",
"country": {
"country_id": 8,
"name": "World"
}
}
},
{
"name": "Hong Kong ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/hong-kong/",
"start_timestamp": 1767591600,
"end_timestamp": 1768111200,
"country": {
"country_id": 222,
"name": "Hong Kong"
},
"winner": {
"player_id": "t0WN9vR6",
"name": "Bublik Alexander",
"player_url": "/player/bublik-alexander/t0WN9vR6/",
"country": {
"country_id": 102,
"name": "Kazakhstan"
}
}
},
{
"name": "Auckland ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/auckland/",
"start_timestamp": 1768171200,
"end_timestamp": 1768618800,
"country": {
"country_id": 140,
"name": "New Zealand"
},
"winner": {
"player_id": "UFj257G8",
"name": "Mensik Jakub",
"player_url": "/player/mensik-jakub/UFj257G8/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Adelaide ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/adelaide/",
"start_timestamp": 1768191300,
"end_timestamp": 1768618800,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "S44E7UYr",
"name": "Machac Tomas",
"player_url": "/player/machac-tomas/S44E7UYr/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Australian Open ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/australian-open/",
"start_timestamp": 1768694400,…
Fields to use:
- title, url, image_url: renderable content for your feed.
- source: attribution.
- published_at: Unix timestamp (seconds). Convert to your user’s timezone at render time.
3) Get Team News
Returns the latest news articles about a specific team with title, link, image, source and publication time.
- Method: GET
- URL: https://zylalabs.com/api/12518/flashscore-live-api/40618/get-team-news
- Query params:
- team_id (string, required): e.g., Wtn9Stg0
cURL (for reference):
Example response (truncated by source):
[
{
"title": "Calvin Bassey responds to Man Utd interest after Fulham star frustrates Man City",
"url": "https://www.flashscore.com/newsfeed/fV482r4K/",
"image_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x225q60/4f932562-5d33-4ea7-8801-53a3d021681b.jpeg",
"source": "Metro",
"published_at": 1795273228,
"is_flashscore_news": false
},
{
"title": "Iwobi, Bassey In Action As Fulham Share Spoils With Man City",
"url": "https://www.flashscore.com/newsfeed/xOJnSh9O/",
"image_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x225q60/6180f2b3-7829-4ede-8d16-3223253a6997.jpeg",
"source": "Completesports",
"published_at": 1795272889,
"is_flashscore_news": false
},
{
"title": "VAR denies Haaland as Man City struggle to break down resolute Fulham",
"url": "https://www.flashscore.com/newsfeed/b9UIzKdK/",
"image_url": "https://livesport-ott-images.ssl.cdn.cra.cz/r300x225q60/47d8bb5a-7dc3-48c9-86e2-239488bdd4a6.jpeg",
"source": "timeslive.co.za",
"published_at": 1795272787,
"is_flashscore_news": false
},
{…
Tips:
- Display a readable time by converting published_at (seconds) to your locale.
- is_flashscore_news flags whether the article is from the Flashscore newsroom or an external source.
Official sample: Get Tennis Tournament Calendar
The following official sample shows how a tennis calendar response is structured. This is useful for building schedule pages, week-by-week previews, or filtering by surface.
cURL:
JSON:
[
{
"name": "Brisbane ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/brisbane/",
"start_timestamp": 1767510600,
"end_timestamp": 1768104000,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "O8qG0Nhb",
"name": "Medvedev Daniil",
"player_url": "/player/medvedev-daniil/O8qG0Nhb/",
"country": {
"country_id": 8,
"name": "World"
}
}
},
{
"name": "Hong Kong ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/hong-kong/",
"start_timestamp": 1767591600,
"end_timestamp": 1768111200,
"country": {
"country_id": 222,
"name": "Hong Kong"
},
"winner": {
"player_id": "t0WN9vR6",
"name": "Bublik Alexander",
"player_url": "/player/bublik-alexander/t0WN9vR6/",
"country": {
"country_id": 102,
"name": "Kazakhstan"
}
}
},
{
"name": "Auckland ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/auckland/",
"start_timestamp": 1768171200,
"end_timestamp": 1768618800,
"country": {
"country_id": 140,
"name": "New Zealand"
},
"winner": {
"player_id": "UFj257G8",
"name": "Mensik Jakub",
"player_url": "/player/mensik-jakub/UFj257G8/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Adelaide ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/adelaide/",
"start_timestamp": 1768191300,
"end_timestamp": 1768618800,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "S44E7UYr",
"name": "Machac Tomas",
"player_url": "/player/machac-tomas/S44E7UYr/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Australian Open ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/australian-open/",
"start_timestamp": 1768694400,…
Implementation notes:
- start_timestamp and end_timestamp are Unix seconds. Use these to render schedule spans and to filter by date ranges.
- surface lets you power “filter by surface” UI.
- winner is present when the tournament has concluded; guard against null/absent winner data for in-progress events.
A minimal Python client you can drop into your codebase
The snippet below fetches player news, converts timestamps to ISO8601, and prints a compact list for your UI layer. Swap the endpoint URL to query team news or team winner odds with the same pattern.
import requests
from datetime import datetime, timezone
API_KEY = "YOUR_API_KEY"
BASE = "https://zylalabs.com/api/12518/flashscore-live-api"
def iso(ts):
# ts comes as Unix seconds (int)
return datetime.fromtimestamp(ts, tz=timezone.utc).isoformat()
def get_player_news(player_id="dMPo6IPH"):
url = f"{BASE}/40617/get-player-news"
resp = requests.get(url, params={"player_id": player_id}, headers={"Authorization": f"Bearer {API_KEY}"})
resp.raise_for_status()
articles = resp.json()
results = []
for a in articles:
results.append({
"title": a.get("title"),
"url": a.get("url"),
"image": a.get("image_url"),
"source": a.get("source"),
"published_at_iso": iso(a["published_at"]) if a.get("published_at") else None,
"is_flashscore_news": a.get("is_flashscore_news"),
})
return results
if __name__ == "__main__":
for item in get_player_news():
print(f"[{item['published_at_iso']}] {item['source']}: {item['title']} - {item['url']}")
This code uses the Authorization: Bearer header, reads the documented response fields, and converts timestamps. You can adapt the same structure for:
- Team news: change the path to /40618/get-team-news and pass team_id.
- Team winner odds: change the path to /40619/get-team-winner-odds and pass team_id (and optionally geo_ip_code).
Real-world use cases and integration patterns
Odds comparison bar for a team’s outright chances
- Fetch Get Team Winner Odds with team_id.
- Sort odds by value and highlight the row with is_best = true.
- Filter to is_active where you need to comply with current availability.
- If your audience is location-specific, set geo_ip_code (e.g., GB) to align bookmakers to that market.
Team and player news feeds
- Fetch Get Team News or Get Player News during page render or via a scheduled job.
- Show title, source, and a relative time by converting published_at (seconds) to local time.
- Use is_flashscore_news to badge official newsroom pieces differently from external sources.
Tennis schedule module
- Use the tennis tournament calendar sample to design your schema and UI.
- Allow filtering by surface and date ranges via start_timestamp and end_timestamp.
- Display winner data when present; otherwise show in-progress/preview state.
Production tips that save you time
- Timestamps: All samples show Unix timestamps in seconds. Convert on the client or server to your display timezone.
- Caching: For news, a 1–5 minute cache is typically fine for high-traffic pages. For odds, cache more conservatively if your UI emphasizes recency; always respect is_active.
- Regionalization: geo_ip_code on odds helps align to bookmaker markets by region (example: GB). If unsure, default to no geo_ip_code to receive general availability.
- Error handling: Treat all endpoints as network-bound. Implement retry with backoff on 5xx and idempotent GETs.
- Quotas and access: Access is subscription + quota. The first API usually provides a 7-day trial or 50 requests—confirm details on the API page.
If you’re onboarding multiple APIs, the single key and consolidated billing on Zyla API Hub reduce overhead when you expand beyond sports into related services on the same platform.
Call the API from AI agents via MCP
You can expose FlashScore - Live API to Claude Code, Cursor, Windsurf, and any MCP-compatible client through Zyla’s MCP endpoint. Point your agent tooling at the MCP URL below, supply your Zyla API key, and the agent can invoke the same endpoints shown above:
When your agent asks for team odds, have it call the Get Team Winner Odds tool with team_id, or fetch player/team news with the corresponding parameters. Authentication remains Authorization: Bearer YOUR_API_KEY through MCP as configured in your client.
Putting it all together fast
A common launch path:
- Subscribe and get your key on the API page: Start 7-day trial on FlashScore - Live API.
- Ship a news component using Get Player News or Get Team News. Convert published_at to local time, render title, image_url, and source.
- Add an odds comparison widget using Get Team Winner Odds. Sort by value, highlight is_best, and respect is_active.
- If you cover tennis, integrate the calendar sample structure to list events and winners.
cURL you can run now: Get Team Winner Odds
Paste into your terminal (replace YOUR_API_KEY):
Partial example response (truncated by source):
[
{
"tournament_id": "SY30SsKF",
"name": "Premier League",
"image_path": "https://static.flashscore.com/res/image/data/rN76jpW1-naArgzhi.png",
"odds": [
{
"bookmaker_id": 16,
"bookmaker_name": "bet365",
"bookmaker_image": "https://static.flashscore.com/res/image/data/bookmakers/80-16.png",
"value": 17,
"change": "UP",
"is_best": true,
"is_active": true
},
{
"bookmaker_id": 1281,
"bookmaker_name": "BetMGM.uk",
"bookmaker_image": "https://static.flashscore.com/res/image/data/bookmakers/80-1281.png",
"value": 15,
"change": "UP",
"is_best": false,
"is_active": false
},
{
"bookmaker_id": 21,
"bookmaker_name": "Betfred",
"bookmaker_image": "https://static.flashscore.com/res/image/data/bookmakers/80-21.png",
"value": 11,
"change": "UP",
"is_best": false,
"is_active…
Key fields:
- name: Tournament name for the outright market.
- odds[].value: Odds value to display; combine with bookmaker_name and bookmaker_image.
- odds[].is_best: Visual indicator for the standout price.
- odds[].is_active: Use to filter unavailable markets.
FAQ
-
How do I authenticate requests?
Send Authorization: Bearer YOUR_API_KEY on every request to zylalabs.com endpoints.
-
What time format do published_at and start_timestamp use?
They are Unix timestamps in seconds. Convert them to your desired timezone and format in your app.
-
What does geo_ip_code do on the odds endpoint?
It scopes bookmaker availability by region (e.g., GB). If omitted, you’ll get general availability data.
-
Is there a free plan?
No. Access is subscription + quota, not pay-per-call. The first API includes a 7-day trial or 50 requests; check the API page for current details.
-
Can I call this API from an AI agent?
Yes. Use Zyla’s MCP endpoint in compatible tools and route calls to these endpoints through your configured Authorization: Bearer key.
Ready to ship? Create your key and start integrating team odds, player/team news, and tennis schedules with the FlashScore - Live API. Start here: Start 7-day trial on FlashScore - Live API. Explore more categories anytime at Zyla API Hub.
Official API response
[
{
"name": "Brisbane ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/brisbane/",
"start_timestamp": 1767510600,
"end_timestamp": 1768104000,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "O8qG0Nhb",
"name": "Medvedev Daniil",
"player_url": "/player/medvedev-daniil/O8qG0Nhb/",
"country": {
"country_id": 8,
"name": "World"
}
}
},
{
"name": "Hong Kong ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/hong-kong/",
"start_timestamp": 1767591600,
"end_timestamp": 1768111200,
"country": {
"country_id": 222,
"name": "Hong Kong"
},
"winner": {
"player_id": "t0WN9vR6",
"name": "Bublik Alexander",
"player_url": "/player/bublik-alexander/t0WN9vR6/",
"country": {
"country_id": 102,
"name": "Kazakhstan"
}
}
},
{
"name": "Auckland ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/auckland/",
"start_timestamp": 1768171200,
"end_timestamp": 1768618800,
"country": {
"country_id": 140,
"name": "New Zealand"
},
"winner": {
"player_id": "UFj257G8",
"name": "Mensik Jakub",
"player_url": "/player/mensik-jakub/UFj257G8/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Adelaide ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/adelaide/",
"start_timestamp": 1768191300,
"end_timestamp": 1768618800,
"country": {
"country_id": 24,
"name": "Australia"
},
"winner": {
"player_id": "S44E7UYr",
"name": "Machac Tomas",
"player_url": "/player/machac-tomas/S44E7UYr/",
"country": {
"country_id": 62,
"name": "Czech Republic"
}
}
},
{
"name": "Australian Open ATP",
"surface": "hard",
"tournament_url": "/tennis/atp-singles/australian-open/",
"start_timestamp": 1768694400,…