{
  "openapi": "3.0.1",
  "info": {
    "title": "ESPN Cricinfo Scraper",
    "description": "Unofficial Cricinfo API for live cricket scores, statsguru api match schedules, scorecards, ball-by-ball updates, player stats, team rankings, and cricket news. Fast JSON endpoints with simple documentation. More details visit here https://rapidapi.com/matepapava123/api/espncricinfo-api",
    "version": "1.0",
    "x-build-id": "Gnt0G5dK0rHeJBIaH"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fingolfin~espn-cricinfo-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fingolfin-espn-cricinfo-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~espn-cricinfo-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fingolfin-espn-cricinfo-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~espn-cricinfo-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fingolfin-espn-cricinfo-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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}