Cricbuzz API endpoint
Returns current and future series grouped by month, with series IDs, dates, and canonical URLs. Filter by the live route-backed category, the Live Streaming flag, or a local case-insensitive series-name substring. Live Streaming may validly return an empty result set when Cricbuzz has no matching entries at the time of the request.
/cricbuzz/seriescategory: optional directory category. Accepted values are all, international, domestic, league, and women. Cricbuzz displays league as T20 Leagues. If omitted, the endpoint uses all.live_stream: optional boolean; true follows Cricbuzz's Live Streaming filter route. The filter can validly return no series for the current upstream snapshot.q: optional case-insensitive substring search over series names, up to 100 characters. This is a local filter over the parsed series list.The response preserves Cricbuzz's month groups and gives each series its ID, name, start/end dates, and canonical detail URL. The directory changes as series are announced or completed. Use this endpoint to discover series IDs and category values instead of hard-coding them.
When live_stream=true has no current entries, months is empty,
total is 0, and empty_state is no_results. On upstream refresh failure,
the service may return the last good snapshot with stale: true.
| Field | Filled in, of 14 checked | Values in the sample |
|---|---|---|
| month | 14 | “FEBRUARY 2024” and 13 other values |
| series | 14 | median 2 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| category | string | No | all | Series category; defaults to all Allowed values: all, international, domestic, league, women. | all |
| live_stream | boolean | No | Restrict to Cricbuzz's Live Streaming page filter | false | |
| q | string | No | Optional local substring search over series names, up to 100 characters | ashes | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/series?category=all&live_stream=true&q=coffee" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"category": "all",
"live_stream": false,
"categories": [
"all",
"international",
"domestic",
"league",
"women"
],
"filters": [
{
"id": "liveStream",
"name": "Live Streaming"
}
],
"source_url": "https://www.cricbuzz.com/cricket-schedule/series/all",
"fetched_at": "2026-10-28T00:00:00Z",
"stale": false,
"months": [
{
"month": "OCTOBER 2026",
"series": [
{
"id": 12543,
"name": "India tour of New Zealand 2026",
"start_date": "2026-10-22T00:00:00Z",
"end_date": "2026-12-01T00:00:00Z",
"url": "https://www.cricbuzz.com/cricket-series/12543/india-tour-of-new-zealand-2026/matches"
}
]
}
],
"total": 1
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.seriesResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.SeriesResponse | No | ||||
| data.categories | array | No | ||||
| data.category | string | No | ||||
| data.empty_state | string | No | ||||
| data.fetched_at | string | No | ||||
| data.filters | array | No | ||||
| data.filters[].id | string | No | ||||
| data.filters[].name | string | No | ||||
| data.live_stream | boolean | No | ||||
| data.months | array | No | ||||
| data.months[].month | string | No | ||||
| data.months[].series | array | No | ||||
| data.months[].series[].end_date | string | No | ||||
| data.months[].series[].id | integer | No | ||||
| data.months[].series[].name | string | No | ||||
| data.months[].series[].start_date | string | No | ||||
| data.months[].series[].url | string | No | ||||
| data.q | string | No | ||||
| data.source_url | string | No | ||||
| data.stale | boolean | No | ||||
| data.total | integer | No | ||||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/series?category=all&live_stream=true&q=coffee" \
-H "x-api-key: $CRAWLORA_API_KEY"