Cricbuzz API endpoint
Returns the complete team directory for one Cricbuzz category, with group labels, team IDs, short names, country labels, image IDs, and canonical team profile URLs. The optional q value performs a case-insensitive substring match on team names within the returned category.
/cricbuzz/teamscategory: optional directory category. Accepted values are international, domestic, league, and women. If omitted, the endpoint uses international.q: optional case-insensitive substring match over team names in that category. Maximum length is 100 characters.The response groups teams according to the live directory. The International
category currently contains Test Teams and Associate Teams; other
categories use the group labels shown by Cricbuzz. Each team includes the
upstream team ID and its canonical profile URL, so callers do not have to
guess URL slugs. Team membership changes over time; use this endpoint as the
discovery source rather than hard-coding IDs or names. The service caches each
category for 30 minutes; if a refresh fails, it serves the last good directory
with stale: true and the original fetched_at timestamp.
| Field | Filled in, of 2 checked | Values in the sample |
|---|---|---|
| name | 2 | “Test Teams” and 1 other value |
| teams | 2 | median 12 entries |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| category | string | No | international | Team directory category; defaults to international Allowed values: international, domestic, league, women. | international |
| q | string | No | Optional local substring search over team names, up to 100 characters | india | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/teams?category=international&q=coffee" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"category": "international",
"source_url": "https://www.cricbuzz.com/cricket-team",
"fetched_at": "2026-10-28T00:00:00Z",
"stale": false,
"groups": [
{
"name": "Test Teams",
"teams": [
{
"id": 2,
"name": "India",
"short_name": "IND",
"country": "India",
"image_id": 776162,
"profile_url": "https://www.cricbuzz.com/cricket-team/india/2"
}
]
},
{
"name": "Associate Teams",
"teams": [
{
"id": 72,
"name": "Nepal",
"short_name": "NEP",
"image_id": 776331,
"profile_url": "https://www.cricbuzz.com/cricket-team/nepal/72"
}
]
}
],
"total": 2
}
}Request schema
No body schema
Response schema
#/definitions/cricbuzz.teamsResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | cricbuzz.TeamsResponse | No | ||||
| data.category | string | No | ||||
| data.fetched_at | string | No | ||||
| data.groups | array | No | ||||
| data.groups[].name | string | No | ||||
| data.groups[].teams | array | No | Team record, 6 fields: country, id, image_id, name, profile_url, short_name. Described under Cricbuzz team statistics API. | |||
| 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/teams?category=international&q=coffee" \
-H "x-api-key: $CRAWLORA_API_KEY"