# Cricket Live API
> Live professional cricket across the world's major competitions — the IPL, the T20 and ODI World Cups, the Big Bash League, the County Championship, the Sheffield Shield, the Ranji Trophy and more — sourced from the same official scoring feed the broadcasters use. Pull the live scoreboard for any league (teams, innings scores like 161/5, overs, target and result), then the full match scorecard: every batter with runs, balls, fours, sixes, strike rate and how they were dismissed, plus every bowler with overs, maidens, runs conceded, wickets and economy. Read the up-to-date league table (played, won, points, net run rate, qualification) and the latest cricket news. Real-time during play, no key needed upstream. Ideal for cricket betting and fantasy apps, live scorecards, sports media and tournament dashboards.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/cricketlive-api/..."
```

## Pricing
- **Free** (Free) — 4,000 calls/Mo, 2 req/s
- **Starter** ($12/Mo) — 80,000 calls/Mo, 8 req/s
- **Pro** ($34/Mo) — 400,000 calls/Mo, 25 req/s
- **Elite** ($119/Mo) — 2,000,000 calls/Mo, 60 req/s

## Endpoints

### Cricket

#### `GET /v1/match` — Full scorecard for a match

**Parameters:**
- `league` (query, optional, string) — League alias or numeric id Example: `ipl`
- `event` (query, required, string) — Match (event) id from /v1/scoreboard Example: `1535465`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cricketlive-api/v1/match?league=ipl&event=1535465"
```

**Response:**
```json
{
    "data": {
        "match": {
            "id": "1535465",
            "date": "2026-05-31T14:00Z",
            "name": "Royal Challengers Bengaluru v Gujarat Titans",
            "teams": [
                {
                    "id": "335970",
                    "logo": "https://a.espncdn.com/i/teamlogos/cricket/500/335970.png",
                    "name": "Royal Challengers Bengaluru",
                    "score": "161/5 (18/20 ov, target 156)",
                    "winner": false,
                    "innings": [
                        {
                            "runs": null,
                            "overs": 20,
                            "wickets": 0
                        },
                        {
                            "runs": null,
                            "overs": 18,
                            "wickets": 5
                        }
                    ],
                    "home_away": "home",
                    "abbreviation": "RCB"
                },
                {
                    "id": "1298769",
                    "logo": "https://a.espncdn.com/i/teamlogos/cricket/500/1298769.png",
                    "name": "Gujarat Titans",
                    "score": "155/8",
                    "winner": false,
                    "innings": [
                        {
                            "runs": null,
                            "overs": 20,
                            "wickets": 8
                        },
                   
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/news` — Latest cricket news for a league

**Parameters:**
- `league` (query, optional, string) — League alias or numeric id Example: `ipl`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cricketlive-api/v1/news?league=ipl"
```

**Response:**
```json
{
    "data": {
        "count": 50,
        "articles": [
            {
                "link": "https://www.espn.com/cricket/story/_/id/48992933/ind-vs-afg-high-quality-saleem-impresses-six-extreme-heat-unhelpful-pitch",
                "image": "https://a.espncdn.com/i/cricket/cricinfo/1539963_900x506.jpg",
                "headline": "'High-quality' Saleem impresses with six-for despite extreme heat and unhelpful pitch",
                "published": "2026-06-07T19:38:47Z",
                "description": "Afghanistan quick bagged 6 for 140 and garnered praise from both his head coach Richard Pybus and Washington Sundar"
            },
            {
                "link": "https://www.espn.com/cricket/story/_/id/48992662/eng-vs-nz-1st-test-england-enjoy-ugly-win-new-zealand-die-wondering",
                "image": "https://a.espncdn.com/i/cricket/cricinfo/1539749_900x506.jpg",
                "headline": "England enjoy ugly win as New Zealand die wondering",
                "published": "2026-06-07T18:05:28Z",
                "description": "Lord's Test blighted by the pitch but tourists should regret passive approach to run-scoring"
            },
            {
                "link": "http://www.espn.com/cricket/series/8052/report/1513356/day/1/surrey-vs-hampshire-31st-match-8052",
                "image": "https://a.espncdn.com/i/cricket/cricinfo/1540064_365x205.jpg",
                "headline": "Dan Lawrence double-hundred puts Surrey in charge",
                "publi
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/scoreboard` — Matches for a league

**Parameters:**
- `league` (query, optional, string) — ipl | world-cup | big-bash | county-championship | sheffield-shield | … or numeric id Example: `ipl`
- `dates` (query, optional, string) — Optional YYYYMMDD or range

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cricketlive-api/v1/scoreboard?league=ipl"
```

**Response:**
```json
{
    "data": {
        "count": 1,
        "league": "Indian Premier League",
        "matches": [
            {
                "id": "1535465",
                "date": "2026-05-31T14:00Z",
                "name": "Royal Challengers Bengaluru v Gujarat Titans",
                "teams": [
                    {
                        "id": "335970",
                        "name": "Royal Challengers Bengaluru",
                        "score": "161/5 (18/20 ov, target 156)",
                        "winner": false,
                        "innings": [
                            {
                                "runs": 1,
                                "overs": 20,
                                "wickets": 0
                            },
                            {
                                "runs": 2,
                                "overs": 18,
                                "wickets": 5
                            }
                        ],
                        "home_away": "home",
                        "abbreviation": "RCB"
                    },
                    {
                        "id": "1298769",
                        "name": "Gujarat Titans",
                        "score": "155/8",
                        "winner": false,
                        "innings": [
                            {
                                "runs": 1,
                                "overs": 20,
                                "wickets": 8
                 
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/standings` — League table

**Parameters:**
- `league` (query, optional, string) — League alias or numeric id Example: `ipl`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cricketlive-api/v1/standings?league=ipl"
```

**Response:**
```json
{
    "data": {
        "groups": [
            {
                "name": "Table",
                "table": [
                    {
                        "won": 9,
                        "lost": 5,
                        "rank": 1,
                        "team": "Royal Challengers Bengaluru",
                        "played": 14,
                        "points": 18,
                        "team_id": "335970",
                        "runs_for": "2642/254.2",
                        "no_result": 0,
                        "qualified": true,
                        "net_run_rate": "0.783",
                        "runs_against": "2619/272.4"
                    },
                    {
                        "won": 9,
                        "lost": 5,
                        "rank": 2,
                        "team": "Gujarat Titans",
                        "played": 14,
                        "points": 18,
                        "team_id": "1298769",
                        "runs_for": "2558/270.4",
                        "no_result": 0,
                        "qualified": true,
                        "net_run_rate": "0.695",
                        "runs_against": "2434/278.0"
                    },
                    {
                        "won": 9,
                        "lost": 5,
                        "rank": 3,
                        "team": "Sunrisers Hyderabad",
                        "played": 14,
                        "points": 18,
         
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/leagues` — Supported league aliases and ids

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cricketlive-api/v1/leagues"
```

**Response:**
```json
{
    "data": {
        "count": 16,
        "leagues": [
            {
                "id": "8048",
                "alias": "ipl"
            },
            {
                "id": "8039",
                "alias": "world-cup"
            },
            {
                "id": "8040",
                "alias": "t20-world-cup-qualifier"
            },
            {
                "id": "8044",
                "alias": "big-bash"
            },
            {
                "id": "8044",
                "alias": "bbl"
            },
            {
                "id": "8037",
                "alias": "champions-trophy"
            },
            {
                "id": "8038",
                "alias": "world-cup-qualifier"
            },
            {
                "id": "8052",
                "alias": "county-championship"
            },
            {
                "id": "8052",
                "alias": "county"
            },
            {
                "id": "8043",
                "alias": "sheffield-shield"
            },
            {
                "id": "8050",
                "alias": "ranji-trophy"
            },
            {
                "id": "8053",
                "alias": "t20-blast"
            },
            {
                "id": "8041",
                "alias": "supersport"
            },
            {
                "id": "8074",
                "alias": "intercontinental-cup"
            },
            {
                "id": "8049",
       
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/meta` — Service description & endpoints

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/cricketlive-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "service": "cricketlive-api",
        "endpoints": {
            "GET /v1/meta": "This document.",
            "GET /v1/news": "Cricket news (league=).",
            "GET /v1/match": "Full scorecard for a match (league=, event=id from scoreboard).",
            "GET /v1/leagues": "Supported league aliases and ids.",
            "GET /v1/standings": "League table (league=).",
            "GET /v1/scoreboard": "Matches for a league (league=ipl|world-cup|big-bash|… or numeric id, dates=)."
        },
        "description": "Live professional cricket across many competitions (IPL, T20/ODI World Cup, Big Bash, County Championship, Sheffield Shield, Ranji Trophy and more): the live scoreboard, the full match scorecard with per-innings batting and bowling and dismissals, the league table and news. Real live data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T01:20:03.527Z",
        "request_id": "17c9b51c-14b2-45f9-b8d6-4f45a4cd0af1"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/cricketlive-api
OpenAPI spec: https://www.oanor.com/api/cricketlive-api/openapi.json