# Cricbuzz Match Scraper (`parseforge/cricbuzz-scraper`) Actor

Scrapes match listings from any Cricbuzz URL, including live scores, recent matches, upcoming fixtures, and series pages. Returns each match as a flat row.

- **URL**: https://apify.com/parseforge/cricbuzz-scraper.md
- **Developed by:** [ParseForge](https://apify.com/parseforge) (community)
- **Categories:** Sports
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $3.62 / 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.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

[![ParseForge](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner.jpg)](https://apify.com/parseforge?fpr=vmoqkp)

### Cricbuzz Match Scraper

**Scrape Cricbuzz match listings from any URL, up to a million per run.** Get live scores, recent matches, upcoming fixtures, and series pages in one flat dataset. No login or API key. Export to CSV, JSON, Excel, or XML.

Cricbuzz has no official public API for match listings, and building your own scraper means handling dynamic pages, rate limits, and schema changes. This Actor reads any Cricbuzz page you point it at, from the homepage to live scores, recent matches, or series pages, and returns each match as a clean, flat row. It is the fastest way to get cricket match data into your spreadsheet or database.

| Who uses it | What they scrape Cricbuzz for |
|---|---|
| Sports data analysts | Building historical datasets of cricket matches for trend analysis |
| Fantasy cricket app developers | Feeding live match data into their apps for player performance tracking |
| Sports journalists | Monitoring upcoming fixtures and recent results for coverage planning |
| Betting market researchers | Tracking match outcomes and team performance over time |
| Cricket enthusiasts | Archiving match data for personal projects or blogs |

### What it does

This Actor collects match listings from any Cricbuzz URL and returns each match as a flat row with its teams, scores, status, and other details.

- 🔗 **Any Cricbuzz URL:** paste a homepage, live scores, recent matches, or series page link and get the matches listed there.
- 📊 **Flat dataset:** each match is one row with teams, scores, status, and other details, ready for CSV, JSON, Excel, or XML export.
- ⚡ **Fast and scalable:** scrape up to 1,000,000 items per run for paid users, with a 10-item preview for free users.
- 🛡️ **No login or API key:** works on public Cricbuzz pages without authentication or rate-limit headaches.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

### What you can do with Cricbuzz data

**📈 Build a cricket match database.**

A data analyst scrapes recent and upcoming matches from Cricbuzz series pages to create a historical dataset for trend analysis and reporting.

**📱 Power a fantasy cricket app.**

A developer runs the Actor on live score pages to feed real-time match data into their app for player performance tracking.

**📰 Plan sports coverage.**

A journalist scrapes upcoming fixtures from Cricbuzz to decide which matches to cover and assign reporters.

**📊 Monitor team performance.**

A betting market researcher collects match outcomes over a season to analyze team form and inform odds models.

### Why choose this scraper

| | What you get |
|---|---|
| **No official API** | Cricbuzz does not offer a public API for match listings, so this Actor is the direct way to get the data. |
| **Any page type** | Works on homepages, live scores, recent matches, series pages, and more. |
| **Clean output** | Each match is a flat row with consistent fields, no nested JSON to parse. |
| **Scalable** | Paid users can scrape up to a million items per run. |

### How it compares

This Actor focuses on match listings from any Cricbuzz URL, while competitors offer additional data like scorecards or player profiles.

| Feature | ParseForge | Cricbuzz Live Match Scores Scraper | Cricbuzz Scraper | CricBuzz Scraper |
|---|---|---|---|---|
| Scrape any Cricbuzz URL | Yes | Not listed | Yes | Not listed |
| Live match scores | Yes | Yes | Yes | Yes |
| Upcoming matches | Yes | Yes | Yes | Yes |
| Recent matches | Yes | Yes | Yes | Not listed |
| Series schedules | Yes | Not listed | Yes | Yes |
| Full scorecards | Not listed | Not listed | Yes | Not listed |
| Player profiles | Not listed | Not listed | Yes | Not listed |

### Configure the run

Drive the Actor from any Cricbuzz URL and set a maximum number of items to scrape. The Actor reads the page you provide and returns each match listing as a row. The Input tab lists every parameter.

A first run with the defaults:

```json
{
 "startUrl": "https://www.cricbuzz.com",
 "maxItems": 10
}
```

A larger pull:

```json
{
 "startUrl": "https://www.cricbuzz.com",
 "maxItems": 200
}
```

### Pricing

Pay-per-result: **$0.004 per result** collected. You pay only for the results written to your dataset.

| Results collected | Approximate cost |
|---|---|
| 100 results | $0.40 |
| 1,000 results | $4.00 |
| 10,000 results | $40.00 |

New Apify accounts start with $5 in free credit.

### Free users

Free-plan runs return up to 10 results as a preview. [Upgrade your Apify plan](https://console.apify.com/sign-up?fpr=vmoqkp) to collect up to 1,000,000 results per run.

### Run it

1. [Create a free Apify account with $5 in credit](https://console.apify.com/sign-up?fpr=vmoqkp).
2. Open the [Cricbuzz Match Scraper](https://apify.com/parseforge/cricbuzz-scraper?fpr=vmoqkp).
3. Set your inputs and any filters, then click **Start**.
4. Export the results as CSV, Excel, JSON, or XML from the **Dataset** tab.

Run it programmatically through the [Apify API](https://docs.apify.com/api/v2) (`run-sync-get-dataset-items`) or the [ApifyClient](https://docs.apify.com/api/client/js) for JavaScript and Python.

### Use with AI agents (MCP)

Give an AI agent live access to Cricbuzz through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/cricbuzz-scraper"
```

Then prompt it in plain language to run the scraper and read back the results.

### Troubleshooting

**Why am I getting no results?**

Make sure the startUrl points to a Cricbuzz page that lists matches. Some pages, like player profiles or news articles, do not contain match listings. Also check that maxItems is set to at least 1.

**Why am I only getting 10 items?**

Free users are limited to 10 items as a preview. To scrape more, upgrade to a paid plan and set maxItems to a higher number.

**The Actor is timing out or failing.**

Cricbuzz may be blocking requests or the page is slow. Try again later, or reduce maxItems. If the problem persists, contact support.

**The data looks incomplete or missing fields.**

Cricbuzz pages vary in structure. The Actor extracts common fields, but some pages may have less data. Try a different URL that lists matches more completely.

**Can I scrape multiple URLs in one run?**

Currently, the Actor accepts one startUrl per run. To scrape multiple pages, run the Actor multiple times or use a different tool that supports URL lists.

### FAQ

| Question | Answer |
|---|---|
| What pages can I scrape with this Actor? | You can scrape any Cricbuzz page that lists matches, including the homepage, live scores, recent matches, upcoming matches, and series pages. paste the URL into the startUrl input. |
| Do I need a Cricbuzz account or API key? | No. The Actor reads public Cricbuzz pages without authentication, so no account or API key is required. |
| How many matches can I scrape in one run? | Free users are limited to 10 items as a preview. Paid users can set maxItems up to 1,000,000 per run. |
| What format is the output data in? | The Actor returns each match as a flat row in a dataset. You can export the dataset to CSV, JSON, Excel, or XML from the Apify platform. |
| Does this Actor get live ball-by-ball commentary? | No, this Actor focuses on match listings such as teams, scores, and status. For detailed ball-by-ball data, you would need a different scraper or API. |
| Can I scrape player profiles or scorecards? | This Actor is designed for match listings. If you need player profiles or full scorecards, consider a dedicated Cricbuzz scraper that supports those pages. |
| How often should I run this Actor? | It depends on your use case. For live scores, you might run it every few minutes. For historical data, a daily or weekly run may be enough. |
| Is it legal to scrape Cricbuzz? | You should review Cricbuzz's terms of service and comply with applicable laws. The Actor only accesses publicly available pages. |
| Can I filter matches by format or team? | The Actor does not have built-in filters beyond the URL and maxItems. To filter, you can scrape a specific series or page that already shows the matches you want. |
| What if the page structure changes? | The Actor is maintained to adapt to Cricbuzz's current layout. If you notice issues, contact support or check for updates. |

### Related actors

Browse the full [ParseForge collection](https://apify.com/parseforge?fpr=vmoqkp) for more scrapers.

🆘 **Need help?** Email parseforge@protonmail.com with your run ID, your input, and what you expected.

⚠️ **Disclaimer.** This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Cricbuzz. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.

# Actor input Schema

## `startUrl` (type: `string`):

URL of the Cricbuzz page to scrape match listings from. Supports homepage, live scores, recent matches, series pages, etc.

## `maxItems` (type: `integer`):

Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000

## Actor input object example

```json
{
  "startUrl": "https://www.cricbuzz.com",
  "maxItems": 10
}
```

# Actor output Schema

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

Complete dataset of all scraped records.

# 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 = {
    "startUrl": "https://www.cricbuzz.com",
    "maxItems": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("parseforge/cricbuzz-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 = {
    "startUrl": "https://www.cricbuzz.com",
    "maxItems": 10,
}

# Run the Actor and wait for it to finish
run = client.actor("parseforge/cricbuzz-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "startUrl": "https://www.cricbuzz.com",
  "maxItems": 10
}' |
apify call parseforge/cricbuzz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/cricbuzz-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/OLaEu6hXvDXFIYqkl/builds/MOJqfUeWah3ZQYtaB/openapi.json
