Cricbuzz API endpoint
Returns every match in the current date window shown by Cricbuzz's Matches By Day page, grouped by date and series. Category and q filters run locally over that complete page payload. The date window is dynamic and can change with the upstream page.
/cricbuzz/scheduleQuery parameters:
category: all, international, league, domestic, or women. Defaults to all; league is labeled T20 Leagues in the UI.q: optional, case-insensitive substring search over series names, match descriptions, and team names; maximum 100 characters.Returns every match present in Cricbuzz's current Matches By Day page response, grouped by its displayed date and series. The page's date window changes over time; this endpoint does not claim to expose historical schedule pages or dates outside the current page. Category and text search are applied locally over the complete page payload.
| Field | Filled in, of 5 checked | Values in the sample |
|---|---|---|
| date | 5 | “FRI, OCT 30 2026” and 4 other values |
| series | 5 | median 8 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| category | string | No | all | Schedule category; defaults to all Allowed values: all, international, league, domestic, women. | all |
| q | string | No | Optional case-insensitive substring search over series, match descriptions, and team names, up to 100 characters | wellington | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/schedule?category=all&q=coffee" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"category": "all",
"categories": [
{
"value": "all",
"label": "All Matches"
},
{
"value": "international",
"label": "International"
},
{
"value": "league",
"label": "T20 Leagues"
},
{
"value": "domestic",
"label": "Domestic"
},
{
"value": "women",
"label": "Women"
}
],
"source_url": "https://www.cricbuzz.com/cricket-schedule/upcoming-series/all",
"fetched_at": "2026-10-28T00:00:00Z",
"days": [],
"total": 0
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.scheduleResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.ScheduleResponse | No | ||||
| data.categories | array | No | ||||
| data.categories[].label | string | No | ||||
| data.categories[].value | string | No | ||||
| data.category | string | No | ||||
| data.days | array | No | ||||
| data.days[].date | string | No | ||||
| data.days[].series | array | No | ||||
| data.days[].series[].category | string | No | ||||
| data.days[].series[].id | integer | No | ||||
| data.days[].series[].matches | array | No | ||||
| data.days[].series[].matches[].description | string | No | ||||
| data.days[].series[].matches[].end_time | string | No | ||||
| data.days[].series[].matches[].format | string | No | ||||
| data.days[].series[].matches[].id | integer | No | ||||
| data.days[].series[].matches[].series_id | integer | No | ||||
| data.days[].series[].matches[].series_name | string | No | ||||
| data.days[].series[].matches[].start_time | string | No | ||||
| data.days[].series[].matches[].team1 | cricbuzz.Team | No | Team record, 6 fields: country, id, image_id, name, profile_url, short_name. Described under Cricbuzz team statistics API. | |||
| data.days[].series[].matches[].team2 | cricbuzz.Team | No | Team record, 6 fields: country, id, image_id, name, profile_url, short_name. Described under Cricbuzz team statistics API. | |||
| data.days[].series[].matches[].url | string | No | ||||
| data.days[].series[].matches[].venue | cricbuzz.MatchVenue | No | MatchVenue record, 7 fields: city, country, ground, id, latitude, longitude, timezone. Described under Cricbuzz matches API. | |||
| data.days[].series[].name | string | No | ||||
| data.empty_state | string | No | ||||
| data.fetched_at | 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/schedule?category=all&q=coffee" \
-H "x-api-key: $CRAWLORA_API_KEY"