# ESPNCricinfo API & Statsguru Scraper (`fingolfin/espncricinfo-api-statsguru-scraper`) Actor

ESPN Cricinfo API: Live cricket scores, Statsguru, match schedules, scorecards, ball-by-ball updates, player stats & rankings. Features direct JSON endpoints and Cricket MCP support for AI agents. Direct RapidAPI link For RESTapi: https://rapidapi.com/matepapava123/api/espncricinfo-api

- **URL**: https://apify.com/fingolfin/espncricinfo-api-statsguru-scraper.md
- **Developed by:** [Mate Papava](https://apify.com/fingolfin) (community)
- **Categories:** Developer tools, Other, News
- **Stats:** 73 total users, 6 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).


# README

## ESPN Cricinfo Scraper - Apify Actor

Scrape cricket data from ESPN Cricinfo including live scores, player stats, team info, rankings, news, and more.

### Features

- **24 scraping actions** covering all major ESPN Cricinfo data
- **Teams & Players**: Get team lists, player details, search players
- **Live Scores & Matches**: Real-time scores, detailed scorecards
- **Series & Fixtures**: Current, upcoming, and past series
- **Rankings & Stats**: ICC rankings, batting/bowling statistics
- **News**: Cricket news articles and full story content
- **Team Details**: Fixtures, squads, stats, videos, galleries, photos, fan ratings
- **RSS Feeds**: Live scores and team news RSS feeds
- **AI Search**: ESPN's AI-powered cricket search

### Input Parameters

#### Required

| Parameter | Type | Description |
|-----------|------|-------------|
| `action` | string | The scraping action to perform (see Available Actions below) |

#### Action-Specific Parameters

##### Team Parameters
| Parameter | Type | Description | Used By |
|-----------|------|-------------|---------|
| `team_id` | string | Team ID (e.g., '6' for India) | get_team_players, get_team_details, get_team_* |
| `team_slug` | string | Team slug (e.g., 'india') | get_team_players, get_team_details, get_team_* |

##### Player Parameters
| Parameter | Type | Description | Used By |
|-----------|------|-------------|---------|
| `player_id` | string | Player ID | get_player_details |
| `use_api` | boolean | Use ESPN API instead of scraping (default: true) | get_player_details |

##### Search Parameters
| Parameter | Type | Description | Used By |
|-----------|------|-------------|---------|
| `query` | string | Search query string | search_players, ai_search |
| `limit` | integer | Max results (1-50, default: 5) | search_players |
| `tournament` | string | Tournament filter (e.g., 'menstest') | ai_search |

##### Match Parameters
| Parameter | Type | Description | Used By |
|-----------|------|-------------|---------|
| `match_id` | string | Match ID | get_match_details |

##### Series Parameters
| Parameter | Type | Description | Used By |
|-----------|------|-------------|---------|
| `series_id` | string | Series ID | get_series_details |
| `series_slug` | string | Series slug | get_series_details |
| `status` | string | Filter: 'current', 'upcoming', 'past', 'all' | get_series |

##### Format & Ranking Parameters
| Parameter | Type | Description | Used By |
|-----------|------|-------------|---------|
| `format` | string | Cricket format: 'test', 'odi', 't20', 't20i' | get_live_scores, get_rankings |
| `ranking_type` | string | 'teams', 'batting', 'bowling', 'all-rounder' | get_rankings |

##### Statistics Parameters
| Parameter | Type | Description | Used By |
|-----------|------|-------------|---------|
| `stats_type` | string | 'batting', 'bowling', 'team' | get_stats |
| `stats_format` | string | 'test', 'odi', 't20' | get_stats |
| `category` | string | Specific category (e.g., 'most-runs') | get_stats |

##### News Parameters
| Parameter | Type | Description | Used By |
|-----------|------|-------------|---------|
| `story_id` | string | Story ID or slug | get_story_details |
| `page` | integer | Page number (default: 1) | get_news, get_team_fan_ratings |

##### Fan Ratings Parameters
| Parameter | Type | Description | Used By |
|-----------|------|-------------|---------|
| `match_class` | string | Filter: 'tests', 'odis', 't20is', 'all' | get_team_fan_ratings |

### Available Actions

#### Teams & Players
| Action | Description | Required Parameters |
|--------|-------------|---------------------|
| `get_teams` | Get all cricket teams | - |
| `get_team_players` | Get players for a team by format | team_id |
| `get_player_details` | Get detailed player info and stats | player_id |
| `search_players` | Search for players | query |

#### Matches
| Action | Description | Required Parameters |
|--------|-------------|---------------------|
| `get_live_scores` | Get live cricket scores | - |
| `get_match_details` | Get full match scorecard | match_id |

#### Series
| Action | Description | Required Parameters |
|--------|-------------|---------------------|
| `get_series` | Get fixtures/series list | - |
| `get_series_details` | Get series details | series_id |

#### Rankings & Stats
| Action | Description | Required Parameters |
|--------|-------------|---------------------|
| `get_rankings` | Get ICC rankings | ranking_type |
| `get_stats` | Get cricket statistics | - |

#### News
| Action | Description | Required Parameters |
|--------|-------------|---------------------|
| `get_news` | Get cricket news articles | - |
| `get_story_details` | Get full article content | story_id |

#### Team Details
| Action | Description | Required Parameters |
|--------|-------------|---------------------|
| `get_team_details` | Get team home/overview | team_id, team_slug |
| `get_team_fixtures` | Get team match schedule | team_id, team_slug |
| `get_team_players_list` | Get current squad | team_id, team_slug |
| `get_team_stats` | Get team statistics | team_id, team_slug |
| `get_team_videos` | Get team videos | team_id, team_slug |
| `get_team_squads` | Get historical squads | team_id, team_slug |
| `get_team_galleries` | Get photo galleries | team_id, team_slug |
| `get_team_photos` | Get team photos | team_id, team_slug |
| `get_team_fan_ratings` | Get player fan ratings | team_id, team_slug |

#### RSS Feeds
| Action | Description | Required Parameters |
|--------|-------------|---------------------|
| `get_live_scores_rss` | Get live scores RSS feed | - |
| `get_team_news_rss` | Get team-specific news RSS | team_id |

#### AI Search
| Action | Description | Required Parameters |
|--------|-------------|---------------------|
| `ai_search` | ESPN AI-powered search | query |

### Example Inputs

#### Get Live Scores
```json
{
    "action": "get_live_scores"
}
````

#### Get ICC Team Rankings

```json
{
    "action": "get_rankings",
    "ranking_type": "teams",
    "format": "test"
}
```

#### Get Player Details

```json
{
    "action": "get_player_details",
    "player_id": "253802",
    "use_api": true
}
```

#### Get Team Details

```json
{
    "action": "get_team_details",
    "team_id": "6",
    "team_slug": "india"
}
```

#### Search Players

```json
{
    "action": "search_players",
    "query": "Virat Kohli",
    "limit": 5
}
```

#### Get Series List

```json
{
    "action": "get_series",
    "status": "current"
}
```

#### AI Search

```json
{
    "action": "ai_search",
    "query": "Who has the most centuries in Test cricket?",
    "tournament": "menstest"
}
```

### Output Format

All actions return a consistent output structure:

```json
{
    "action": "get_live_scores",
    "success": true,
    "data": { ... },
    "error": null,
    "timestamp": "2026-03-18T12:00:00.000Z"
}
```

On error:

```json
{
    "action": "get_live_scores",
    "success": false,
    "data": null,
    "error": "Error message here",
    "timestamp": "2026-03-18T12:00:00.000Z"
}
```

### Common Team IDs

| Team | ID | Slug |
|------|-----|------|
| Australia | 1 | australia |
| England | 2 | england |
| South Africa | 3 | south-africa |
| West Indies | 4 | west-indies |
| New Zealand | 5 | new-zealand |
| India | 6 | india |
| Pakistan | 7 | pakistan |
| Sri Lanka | 8 | sri-lanka |
| Zimbabwe | 9 | zimbabwe |
| Bangladesh | 25 | bangladesh |
| Ireland | 29 | ireland |
| Afghanistan | 40 | afghanistan |

### Deployment

```bash
cd rottentomato/cricketinfo-apify-actor
apify login
apify push
```

### Technical Notes

- Uses `curl-cffi` for HTTP requests with anti-bot bypass capabilities
- Parses both JSON data from `__NEXT_DATA__` scripts and HTML fallbacks
- Handles ESPN Cricinfo's modern Next.js-based architecture
- Supports pagination for news and fan ratings endpoints

# Actor input Schema

## `action` (type: `string`):

Select the scraping action to perform

## `team_id` (type: `string`):

REQUIRED for team actions. Team ID (e.g., '6' for India, '1' for Australia). Use get\_teams to find IDs.

## `team_slug` (type: `string`):

REQUIRED for team actions. Team slug (e.g., 'india', 'australia'). Use get\_teams to find slugs.

## `player_id` (type: `string`):

REQUIRED for get\_player\_details. Player ID from search or team players.

## `use_api` (type: `boolean`):

OPTIONAL for get\_player\_details. Use ESPN API instead of scraping (default: true).

## `query` (type: `string`):

REQUIRED for search\_players, ai\_search. Search query string.

## `limit` (type: `integer`):

OPTIONAL for search\_players. Max results (1-50, default: 5).

## `tournament` (type: `string`):

OPTIONAL for ai\_search. Tournament filter (e.g., 'menstest', 'menst20i', 'mensodi').

## `match_id` (type: `string`):

REQUIRED for get\_match\_details. Match ID from live scores or series.

## `match_slug` (type: `string`):

OPTIONAL for get\_match\_details. Full match slug for URL (e.g., 'team-a-vs-team-b-1st-match-1527674'). Improves reliability.

## `series_id` (type: `string`):

REQUIRED for series detail actions. Series ID.

## `series_slug` (type: `string`):

OPTIONAL for series detail actions. Series slug for URL construction (e.g., 'ipl-2026-1510719').

## `status` (type: `string`):

OPTIONAL for get\_series. Filter by series status.

## `format` (type: `string`):

OPTIONAL for get\_live\_scores, get\_rankings. Filter by cricket format.

## `ranking_type` (type: `string`):

REQUIRED for get\_rankings. Type of ranking.

## `stats_type` (type: `string`):

OPTIONAL for get\_stats. Type of statistics.

## `stats_format` (type: `string`):

OPTIONAL for get\_stats. Cricket format for stats.

## `category` (type: `string`):

OPTIONAL for get\_stats. Specific category (e.g., 'most-runs', 'most-wickets').

## `story_id` (type: `string`):

REQUIRED for get\_story\_details. Story ID or slug from news list.

## `page` (type: `integer`):

OPTIONAL for get\_news, get\_team\_fan\_ratings. Page number (default: 1).

## `match_class` (type: `string`):

OPTIONAL for get\_team\_fan\_ratings. Filter by match type.

## `ground_id` (type: `string`):

REQUIRED for get\_ground\_details. Ground object ID (e.g., '56544' for SCG).

## `country` (type: `string`):

OPTIONAL for get\_grounds. Country ID to filter grounds (e.g., '6' for India, '2' for Australia).

## `format_slug` (type: `string`):

REQUIRED for get\_format\_records. Format slug (e.g., 'test-matches-1', 'one-day-internationals-2', 'twenty20-internationals-3').

## `category_slug` (type: `string`):

OPTIONAL for get\_format\_records. Record category slug (e.g., 'batting-records-3', 'bowling-records-4').

## `team_slug_id` (type: `string`):

REQUIRED for get\_team\_records. Team slug-ID (e.g., 'india-6', 'australia-2'). Or use team\_name instead.

## `team_name` (type: `string`):

OPTIONAL for get\_team\_records. Team name (e.g., 'india', 'australia'). Used if team\_slug\_id not provided.

## `trophy_slug` (type: `string`):

REQUIRED for get\_trophy\_records. Trophy slug (e.g., 'indian-premier-league-117', 'world-cup-12', 'the-ashes-1').

## `ground_slug` (type: `string`):

REQUIRED for get\_ground\_records. Ground slug for records.

## `decade_slug` (type: `string`):

REQUIRED for get\_decade\_records. Decade slug (e.g., '2020s-202', '2010s-201', '2000s-200').

## `statsguru_class` (type: `string`):

Cricket format for StatsGuru queries. Default: test.

## `statsguru_type` (type: `string`):

Type of statistics for statsguru\_query. Default: batting.

## `statsguru_view` (type: `string`):

How to group/display the results. Default: overall.

## `statsguru_team` (type: `string`):

Filter by team name (e.g., 'india', 'australia') or StatsGuru team ID.

## `statsguru_opposition` (type: `string`):

Filter by opposition team name or ID.

## `statsguru_host` (type: `string`):

Filter by host country name or ID.

## `statsguru_ground` (type: `string`):

Filter by ground ID (e.g., '131' for Adelaide Oval).

## `statsguru_season` (type: `string`):

Filter by season (e.g., '2023/24', '2024').

## `statsguru_orderby` (type: `string`):

Sort column (e.g., 'runs', 'batting\_average', 'wickets', 'hundreds', 'bowling\_average', 'dismissals').

## `statsguru_page` (type: `integer`):

Page number for paginated results. Default: 1.

## `statsguru_home_or_away` (type: `string`):

Filter by home/away status.

## `statsguru_result` (type: `string`):

Filter by match result.

## `statsguru_spanmin` (type: `string`):

Start date filter (e.g., '01 Jan 2020').

## `statsguru_spanmax` (type: `string`):

End date filter (e.g., '31 Dec 2023').

## Actor input object example

```json
{
  "action": "get_live_scores",
  "use_api": true,
  "limit": 5,
  "ranking_type": "teams",
  "stats_type": "batting",
  "stats_format": "test",
  "page": 1,
  "statsguru_class": "test",
  "statsguru_type": "batting",
  "statsguru_view": "overall",
  "statsguru_page": 1
}
```

# Actor output Schema

## `results` (type: `string`):

Scraped cricket data from ESPN Cricinfo stored in the default dataset. For StatsGuru actions, each result includes: headers (column names), rows (data rows with player/team info and parsed links/IDs), pagination (total results, current page, pages available), query metadata (class, type, view, url), and summary row if present.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "action": "get_live_scores",
    "ranking_type": "teams"
};

// Run the Actor and wait for it to finish
const run = await client.actor("fingolfin/espncricinfo-api-statsguru-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "action": "get_live_scores",
    "ranking_type": "teams",
}

# Run the Actor and wait for it to finish
run = client.actor("fingolfin/espncricinfo-api-statsguru-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "action": "get_live_scores",
  "ranking_type": "teams"
}' |
apify call fingolfin/espncricinfo-api-statsguru-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=fingolfin/espncricinfo-api-statsguru-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "ESPNCricinfo API & Statsguru Scraper",
        "description": "ESPN Cricinfo API: Live cricket scores, Statsguru, match schedules, scorecards, ball-by-ball updates, player stats & rankings. Features direct JSON endpoints and Cricket MCP support for AI agents. Direct RapidAPI link For RESTapi: https://rapidapi.com/matepapava123/api/espncricinfo-api",
        "version": "1.0",
        "x-build-id": "3wIXRinDLtuV4d6oA"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/fingolfin~espncricinfo-api-statsguru-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-fingolfin-espncricinfo-api-statsguru-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/fingolfin~espncricinfo-api-statsguru-scraper/runs": {
            "post": {
                "operationId": "runs-sync-fingolfin-espncricinfo-api-statsguru-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/fingolfin~espncricinfo-api-statsguru-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-fingolfin-espncricinfo-api-statsguru-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "action"
                ],
                "properties": {
                    "action": {
                        "title": "Action",
                        "enum": [
                            "get_teams",
                            "get_team_players",
                            "get_player_details",
                            "search_players",
                            "get_live_scores",
                            "get_match_details",
                            "get_series",
                            "get_series_details",
                            "get_series_points_table",
                            "get_series_squads",
                            "get_series_stats",
                            "get_rankings",
                            "get_stats",
                            "get_news",
                            "get_story_details",
                            "get_team_details",
                            "get_team_fixtures",
                            "get_team_players_list",
                            "get_team_stats",
                            "get_team_videos",
                            "get_team_squads",
                            "get_team_galleries",
                            "get_team_photos",
                            "get_team_fan_ratings",
                            "get_live_scores_rss",
                            "get_team_news_rss",
                            "get_grounds",
                            "get_ground_details",
                            "get_format_records",
                            "get_team_records",
                            "get_trophy_records",
                            "get_ground_records",
                            "get_decade_records",
                            "ai_search",
                            "statsguru_query",
                            "statsguru_batting",
                            "statsguru_bowling",
                            "statsguru_fielding",
                            "statsguru_allround",
                            "statsguru_team",
                            "statsguru_meta"
                        ],
                        "type": "string",
                        "description": "Select the scraping action to perform"
                    },
                    "team_id": {
                        "title": "Team ID",
                        "type": "string",
                        "description": "REQUIRED for team actions. Team ID (e.g., '6' for India, '1' for Australia). Use get_teams to find IDs."
                    },
                    "team_slug": {
                        "title": "Team Slug",
                        "type": "string",
                        "description": "REQUIRED for team actions. Team slug (e.g., 'india', 'australia'). Use get_teams to find slugs."
                    },
                    "player_id": {
                        "title": "Player ID",
                        "type": "string",
                        "description": "REQUIRED for get_player_details. Player ID from search or team players."
                    },
                    "use_api": {
                        "title": "Use API",
                        "type": "boolean",
                        "description": "OPTIONAL for get_player_details. Use ESPN API instead of scraping (default: true).",
                        "default": true
                    },
                    "query": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "REQUIRED for search_players, ai_search. Search query string."
                    },
                    "limit": {
                        "title": "Search Limit",
                        "minimum": 1,
                        "maximum": 50,
                        "type": "integer",
                        "description": "OPTIONAL for search_players. Max results (1-50, default: 5).",
                        "default": 5
                    },
                    "tournament": {
                        "title": "Tournament Filter",
                        "type": "string",
                        "description": "OPTIONAL for ai_search. Tournament filter (e.g., 'menstest', 'menst20i', 'mensodi')."
                    },
                    "match_id": {
                        "title": "Match ID",
                        "type": "string",
                        "description": "REQUIRED for get_match_details. Match ID from live scores or series."
                    },
                    "match_slug": {
                        "title": "Match Slug",
                        "type": "string",
                        "description": "OPTIONAL for get_match_details. Full match slug for URL (e.g., 'team-a-vs-team-b-1st-match-1527674'). Improves reliability."
                    },
                    "series_id": {
                        "title": "Series ID",
                        "type": "string",
                        "description": "REQUIRED for series detail actions. Series ID."
                    },
                    "series_slug": {
                        "title": "Series Slug",
                        "type": "string",
                        "description": "OPTIONAL for series detail actions. Series slug for URL construction (e.g., 'ipl-2026-1510719')."
                    },
                    "status": {
                        "title": "Series Status",
                        "enum": [
                            "",
                            "all",
                            "current",
                            "upcoming",
                            "past"
                        ],
                        "type": "string",
                        "description": "OPTIONAL for get_series. Filter by series status."
                    },
                    "format": {
                        "title": "Cricket Format",
                        "enum": [
                            "",
                            "test",
                            "odi",
                            "t20",
                            "t20i"
                        ],
                        "type": "string",
                        "description": "OPTIONAL for get_live_scores, get_rankings. Filter by cricket format."
                    },
                    "ranking_type": {
                        "title": "Ranking Type",
                        "enum": [
                            "teams",
                            "batting",
                            "bowling",
                            "all-rounder"
                        ],
                        "type": "string",
                        "description": "REQUIRED for get_rankings. Type of ranking."
                    },
                    "stats_type": {
                        "title": "Stats Type",
                        "enum": [
                            "batting",
                            "bowling",
                            "team"
                        ],
                        "type": "string",
                        "description": "OPTIONAL for get_stats. Type of statistics.",
                        "default": "batting"
                    },
                    "stats_format": {
                        "title": "Stats Format",
                        "enum": [
                            "test",
                            "odi",
                            "t20"
                        ],
                        "type": "string",
                        "description": "OPTIONAL for get_stats. Cricket format for stats.",
                        "default": "test"
                    },
                    "category": {
                        "title": "Stats Category",
                        "type": "string",
                        "description": "OPTIONAL for get_stats. Specific category (e.g., 'most-runs', 'most-wickets')."
                    },
                    "story_id": {
                        "title": "Story ID",
                        "type": "string",
                        "description": "REQUIRED for get_story_details. Story ID or slug from news list."
                    },
                    "page": {
                        "title": "Page Number",
                        "minimum": 1,
                        "type": "integer",
                        "description": "OPTIONAL for get_news, get_team_fan_ratings. Page number (default: 1).",
                        "default": 1
                    },
                    "match_class": {
                        "title": "Match Class",
                        "enum": [
                            "",
                            "tests",
                            "odis",
                            "t20is",
                            "all"
                        ],
                        "type": "string",
                        "description": "OPTIONAL for get_team_fan_ratings. Filter by match type."
                    },
                    "ground_id": {
                        "title": "Ground ID",
                        "type": "string",
                        "description": "REQUIRED for get_ground_details. Ground object ID (e.g., '56544' for SCG)."
                    },
                    "country": {
                        "title": "Country Filter",
                        "type": "string",
                        "description": "OPTIONAL for get_grounds. Country ID to filter grounds (e.g., '6' for India, '2' for Australia)."
                    },
                    "format_slug": {
                        "title": "Format Slug",
                        "type": "string",
                        "description": "REQUIRED for get_format_records. Format slug (e.g., 'test-matches-1', 'one-day-internationals-2', 'twenty20-internationals-3')."
                    },
                    "category_slug": {
                        "title": "Category Slug",
                        "type": "string",
                        "description": "OPTIONAL for get_format_records. Record category slug (e.g., 'batting-records-3', 'bowling-records-4')."
                    },
                    "team_slug_id": {
                        "title": "Team Slug-ID",
                        "type": "string",
                        "description": "REQUIRED for get_team_records. Team slug-ID (e.g., 'india-6', 'australia-2'). Or use team_name instead."
                    },
                    "team_name": {
                        "title": "Team Name",
                        "type": "string",
                        "description": "OPTIONAL for get_team_records. Team name (e.g., 'india', 'australia'). Used if team_slug_id not provided."
                    },
                    "trophy_slug": {
                        "title": "Trophy Slug",
                        "type": "string",
                        "description": "REQUIRED for get_trophy_records. Trophy slug (e.g., 'indian-premier-league-117', 'world-cup-12', 'the-ashes-1')."
                    },
                    "ground_slug": {
                        "title": "Ground Slug",
                        "type": "string",
                        "description": "REQUIRED for get_ground_records. Ground slug for records."
                    },
                    "decade_slug": {
                        "title": "Decade Slug",
                        "type": "string",
                        "description": "REQUIRED for get_decade_records. Decade slug (e.g., '2020s-202', '2010s-201', '2000s-200')."
                    },
                    "statsguru_class": {
                        "title": "Cricket Format (Class)",
                        "enum": [
                            "test",
                            "odi",
                            "t20i",
                            "first_class",
                            "list_a",
                            "t20",
                            "women_test",
                            "women_odi",
                            "women_t20i",
                            "all_international",
                            "youth_test",
                            "youth_odi",
                            "youth_t20i",
                            "women_t20"
                        ],
                        "type": "string",
                        "description": "Cricket format for StatsGuru queries. Default: test.",
                        "default": "test"
                    },
                    "statsguru_type": {
                        "title": "Stats Type",
                        "enum": [
                            "batting",
                            "bowling",
                            "fielding",
                            "allround",
                            "team",
                            "fow",
                            "aggregate",
                            "official"
                        ],
                        "type": "string",
                        "description": "Type of statistics for statsguru_query. Default: batting.",
                        "default": "batting"
                    },
                    "statsguru_view": {
                        "title": "View Mode",
                        "enum": [
                            "overall",
                            "innings",
                            "match",
                            "series",
                            "ground",
                            "host",
                            "opposition",
                            "year",
                            "season"
                        ],
                        "type": "string",
                        "description": "How to group/display the results. Default: overall.",
                        "default": "overall"
                    },
                    "statsguru_team": {
                        "title": "Team Filter",
                        "type": "string",
                        "description": "Filter by team name (e.g., 'india', 'australia') or StatsGuru team ID."
                    },
                    "statsguru_opposition": {
                        "title": "Opposition Filter",
                        "type": "string",
                        "description": "Filter by opposition team name or ID."
                    },
                    "statsguru_host": {
                        "title": "Host Country Filter",
                        "type": "string",
                        "description": "Filter by host country name or ID."
                    },
                    "statsguru_ground": {
                        "title": "Ground Filter",
                        "type": "string",
                        "description": "Filter by ground ID (e.g., '131' for Adelaide Oval)."
                    },
                    "statsguru_season": {
                        "title": "Season Filter",
                        "type": "string",
                        "description": "Filter by season (e.g., '2023/24', '2024')."
                    },
                    "statsguru_orderby": {
                        "title": "Order By",
                        "type": "string",
                        "description": "Sort column (e.g., 'runs', 'batting_average', 'wickets', 'hundreds', 'bowling_average', 'dismissals')."
                    },
                    "statsguru_page": {
                        "title": "Page Number",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Page number for paginated results. Default: 1.",
                        "default": 1
                    },
                    "statsguru_home_or_away": {
                        "title": "Home or Away",
                        "enum": [
                            "",
                            "home",
                            "away",
                            "neutral"
                        ],
                        "type": "string",
                        "description": "Filter by home/away status."
                    },
                    "statsguru_result": {
                        "title": "Match Result",
                        "enum": [
                            "",
                            "won",
                            "lost",
                            "tied",
                            "drawn"
                        ],
                        "type": "string",
                        "description": "Filter by match result."
                    },
                    "statsguru_spanmin": {
                        "title": "Start Date",
                        "type": "string",
                        "description": "Start date filter (e.g., '01 Jan 2020')."
                    },
                    "statsguru_spanmax": {
                        "title": "End Date",
                        "type": "string",
                        "description": "End date filter (e.g., '31 Dec 2023')."
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```