# Cricbuzz — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Get real-time cricket scores, detailed match scorecards, ball-by-ball commentary, and player profiles all in one place. Stay updated with live match summaries, series information, and the latest cricket news.

**Category:** Sports | **Website:** [cricbuzz.com/](https://cricbuzz.com/) | **Docs:** [parse.bot/marketplace/9f236e1f-d41d-492c-8e22-ebc7faafd25f/cricbuzz-com-api](https://parse.bot/marketplace/9f236e1f-d41d-492c-8e22-ebc7faafd25f/cricbuzz-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-cricbuzz-com-api-9f236e1f/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_live_scores

Retrieve all live and upcoming cricket match scores including match IDs, team names, series info, venue, and current status. Returns structured match data extracted from Cricbuzz's live scores page. Matches in Preview, Toss, and In Progress states are included.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cricbuzz-com-api-9f236e1f/get_live_scores \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_match_commentary

Retrieve ball-by-ball commentary for a specific match, including pre-match analysis and live updates. Results are sorted by timestamp descending. Each entry may have a headline (for editorial items) or text (for ball-by-ball), plus optional over number and timestamp.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | The numeric match ID from Cricbuzz (e.g. '153726'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cricbuzz-com-api-9f236e1f/get_match_commentary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<string>"}'
```

### get_match_scorecard

Retrieve the full scorecard for a specific match by match ID, including batting and bowling details per innings. Returns innings data with batting arrays (batsman name, runs, balls, fours, sixes, strike rate, dismissal), bowling arrays, fall of wickets, and partnerships. Preview matches return an empty innings array.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | The numeric match ID from Cricbuzz (e.g. '153726'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cricbuzz-com-api-9f236e1f/get_match_scorecard \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<string>"}'
```

### get_match_summary

Retrieve a high-level summary and status of a match including match format, teams, toss, result, venue, and series context. The match_details object contains the full structured match metadata from Cricbuzz. summary_text provides the human-readable match result or status.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `match_id` | string | Yes | The numeric match ID from Cricbuzz (e.g. '153726'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cricbuzz-com-api-9f236e1f/get_match_summary \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"match_id":"<string>"}'
```

### get_news_list

Retrieve the latest cricket news article headlines and URLs from Cricbuzz's news page. Returns up to ~10 recent articles with their full headline text and canonical URL.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cricbuzz-com-api-9f236e1f/get_news_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_player_profile

Retrieve detailed profile and career statistics for a cricket player by their Cricbuzz player ID. Returns personal information (born, role, batting style, teams), batting career summary across formats (Test, ODI, T20, IPL), and bowling career summary. Stats are returned as arrays of rows where the first row contains format headers.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `name_slug` | string | No | The URL-friendly name slug of the player (e.g. 'rahmanullah-gurbaz'). Used to construct the profile URL. Defaults to 'player' which works for any valid player_id. |
| `player_id` | string | Yes | The numeric Cricbuzz player ID (e.g. '13213'). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cricbuzz-com-api-9f236e1f/get_player_profile \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name_slug":"<string>","player_id":"<string>"}'
```

### get_series_list

Retrieve a list of ongoing and upcoming cricket series and their associated matches, including series IDs, names, match schedules, teams, and venues. Each entry represents a match within a series, grouped by seriesId and seriesName.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-cricbuzz-com-api-9f236e1f/get_series_list \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```