Tennis Live Scores & Fixtures

Get normalized live and upcoming tennis matches without supplying an external API key. Query ATP, WTA, Challenger, and ITF-level coverage, filter the feed, track meaningful changes across runs, and send signed webhook alerts to your workflow.

What you can collect

• Live tennis matches and scores
• Upcoming ATP and WTA fixtures
• ATP, WTA, Challenger, and ITF-level events available in the feed
• Singles and doubles matches
• Player, tournament, round, status, score, and start-time data
• Stable match IDs for integrations and recurring monitoring
• Cache freshness metadata on every result

Results use a consistent JSON structure across tours so they can be sent directly to databases, dashboards, spreadsheets, alerting systems, and data pipelines.

Quick start

Current live matches

{
  "mode": "liveMatches",
  "emit": "all",
  "maxItems": 100
}

Upcoming singles fixtures for a date

{
  "mode": "upcomingMatches",
  "date": "2026-08-11",
  "formats": ["singles"],
  "maxItems": 200
}

Find matches involving a player

{
  "mode": "allCachedMatches",
  "playerQuery": "Sinner",
  "emit": "all",
  "maxItems": 100
}

Monitor match changes

Set a stable monitorId and schedule the Actor with the same input. The Actor remembers the previous snapshot and can emit only new or changed matches.

{
  "mode": "liveMatches",
  "playerQuery": "Sinner",
  "monitorId": "sinner-live",
  "emit": "changes",
  "maxCacheAgeMinutes": 90
}

Detected changes include:

• newMatch
• scoreChanged
• statusChanged
• startTimeChanged
• oddsChanged when odds are available

The first run of a new monitor treats matching records as new. Later runs compare them with the saved monitor state.

Send webhook alerts

Provide an HTTPS endpoint to receive one JSON batch whenever matching changes are emitted.

{
  "mode": "liveMatches",
  "tournamentQuery": "Montreal",
  "monitorId": "montreal-live",
  "emit": "changes",
  "webhookUrl": "https://example.com/tennis-alerts",
  "webhookSecret": "YOUR_SIGNING_SECRET"
}

When webhookSecret is supplied, the request includes an X-Tennis-Monitor-Signature HMAC-SHA256 signature.

Filters

You can combine the following inputs:

• mode: live matches, upcoming matches, or both
• date: UTC match date in YYYY-MM-DD format
• eventIds: match IDs returned by an earlier run
• playerQuery: case-insensitive player or team name
• tournamentQuery: case-insensitive tournament name
• statuses: in progress, not started, finished, canceled, or postponed
• formats: singles or doubles
• maxItems: maximum number of results

Output

Each dataset item represents one match and includes:

• Match and source identifiers
• Tournament, season, and round
• Home and away players or doubles teams
• Match status and scheduled start time
• Set, game, and point score information when available
• Match format and surface when available
• Optional odds, statistics, timeline, and point-by-point fields
• Monitoring change types
• Cache freshness information

Important freshness fields:

• cacheUpdatedAt: when the managed snapshot was refreshed
• cacheAgeSeconds: snapshot age when the Actor ran
• isCacheStale: whether it exceeds your maxCacheAgeMinutes threshold

Stale records are returned rather than silently discarded, allowing workflows to detect a delayed refresh without losing the last available snapshot.

Coverage and freshness

Live snapshots are currently refreshed approximately hourly. Upcoming fixtures are refreshed twice daily. These intervals may improve as demand grows.

Coverage varies by tour, tournament, and match. Odds, statistics, timelines, surface information, and point-by-point data are optional and can be null. Do not treat the Actor as an official scoring service or use it where delayed or incomplete sports data could create safety-critical or financial risk.

Usage notes

• No external API credential is required from customers.
• Use emit: "all" for complete filtered snapshots.
• Use emit: "changes" with a stable monitorId for scheduled monitoring.
• Check isCacheStale when freshness is important to your workflow.
• Use narrow filters and an appropriate maxItems value to keep datasets compact.

This Actor aggregates data supplied by independent third-party data services. It is not affiliated with or endorsed by ATP, WTA, ITF, or any tournament organizer.