Cricket Intelligence API

Turn cricket data into production-ready match centres, dashboards, research tools, and sports experiences with one structured Actor.

Cricket Intelligence API gives you a consistent way to discover matches, inspect live scores, explore scorecards, follow players and series, and build historical views from the same JSON response format.

Why use it

• Build a complete cricket match centre with metadata, live score, scorecard, squads, overs, and optional ball-by-ball commentary.
• Find matches and players by familiar names instead of learning numeric identifiers first.
• Track score progression over time with compact match history snapshots.
• Combine live match discovery with series, player, team, venue, ranking, and news data.
• Use normalized fields for application logic while retaining rich nested detail for analysis.
• Export results as JSON, CSV, Excel, or XML through the standard Apify dataset tools.

Built for

• Sports websites and mobile apps
• Live score dashboards and newsroom tools
• Fantasy cricket and fan engagement products
• Match previews, reports, and editorial workflows
• Cricket research, analytics, and internal data products

Quick start

Choose a resource and run the Actor. Most workflows can start with the defaults.

Discover current matches

{
  "mode": "sync",
  "resource": "overview"
}

Get a match by teams and date

You can use friendly search fields without knowing a match ID. The response includes the canonical match ID that was selected.

{
  "mode": "sync",
  "resource": "match",
  "teamName": "India",
  "opponent": "Sri Lanka",
  "matchDate": "2026-08-23",
  "matchParts": ["info", "liveScore", "scorecard"]
}

Get a player profile by name

{
  "mode": "sync",
  "resource": "player",
  "playerName": "Virat Kohli"
}

Read a previously collected result

Use cache mode when you want a predictable read of available stored data without requesting a fresh collection.

{
  "mode": "cache",
  "resource": "matchHistory",
  "matchId": 163017,
  "historyLimit": 100
}

Direct match, series, player, team, and venue IDs are also supported for deterministic integrations.

Available resources

Resource	What you can build
Overview	Live, upcoming, and recent match discovery
Live matches	Scoreboard feeds and match watchlists
Match	Match centre data, scorecards, squads, overs, and commentary
Match history	Historical score progression snapshots
Series	Series metadata, fixtures, and match history
Player search	Player discovery and canonical IDs
Player	Player profile pages and research cards
Team	Team players, schedule, results, and statistics
Venue	Venue profiles and location details
Rankings	Team and player ranking tables
News	Cricket news feeds for briefings and content workflows

Full commentary is opt-in so ordinary match requests stay compact. Each response includes the selected resource, retrieval time, cache metadata, normalized data, and any friendly lookup resolution.

Customer example tasks

Try a workflow in one click:

• Browse Cricket Match Overview: live, upcoming, and recent matches.
• Read Live Cricket Scores: a ready-made live scoreboard response.
• Explore a Cricket Match Centre: friendly team and date lookup with scorecard data.
• Read Match History Snapshots: score progression for a watched match.
• Explore a Cricket Series: series lookup by name and category.
• Get a Player Profile by Name: name-based profile resolution.
• Search Cricket Players: discover player IDs for follow-up requests.
• Read ICC Team Rankings: current team rankings.
• Read a Cricket News Briefing: a ready-made news feed response.
• Fetch Full Match Commentary: opt-in ball-by-ball commentary.

Output and integrations

Every run writes one structured result to the default dataset. Use the Apify Console, Dataset API, webhooks, or your preferred integration to consume it in downstream applications.

The top-level result stays consistent across resources:

• resource identifies the requested workflow.
• mode identifies a fresh or stored read.
• retrievedAt records when the result was produced.
• data contains the normalized resource-specific payload.
• data.resolution explains a friendly name-based match, series, or player lookup.
• upstream reports request metadata for operational visibility.

Pricing

Cricket Intelligence API uses simple pay-per-result pricing. The main result event is $0.05 per completed dataset result. Apify displays the complete charge before a run and in the run billing details.

Data quality notes

Live availability depends on the match state and the information available for that fixture. Full commentary can be substantially larger than a normal scorecard, so request it only when your workflow needs ball-by-ball detail.

If a friendly lookup returns multiple candidates, add an opponent, date, or series name. The Actor reports the candidates instead of silently guessing.