Docs menu

Cricbuzz API endpoint

Cricbuzz matches API

Returns Cricbuzz match cards grouped by source category and series, including teams, scores when available, venue, time, status, and the canonical live-score URL for detail endpoints. The homepage-only Live Now and Today controls are not included because their effects were not verified. Category filtering is local over the route-backed match groups.

GETapiKey2 credits/requestCricbuzzcricbuzz.matchesResponseDoc/cricbuzz/matches

Endpoint facts

Method: GET
API path: /cricbuzz/matches
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Cricbuzz
Response schema: #/definitions/cricbuzz.matchesResponseDoc

Cricbuzz Cricket Data API Try Cricbuzz matches API in Playground Cricbuzz API documentation

How this endpoint behaves

Query parameters:

status: live, recent, or upcoming. Defaults to live.
category: all, international, league, domestic, or women. Defaults to all.

The response contains match status, teams, current or final innings scores when available, venue, times, series grouping, and each match's canonical url. Use that URL as match_url in /api/v1/cricbuzz/scorecard. The category filter is applied locally to the complete upstream match-list payload. Match lists can change between requests. Homepage-only Live Now and Today controls are excluded because their effects were not verified.

Sampled response

Request, 29 Oct 2026: GET /cricbuzz/matches
Items in groups: 3
Fields filled in every checked item: 2

Field	Filled in, of 3 checked	Values in the sample
category	3	“international” and 2 other values
series	3	median 1 entry

Request parameters

Parameter	Type	Required	Default	Description	Example
status	string	No	live	Match-list status; defaults to live Allowed values: live, recent, upcoming.	live
category	string	No	all	Match category; defaults to all Allowed values: all, international, league, domestic, women.	international
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/matches?status=live&category=all" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "status": "recent",
    "category": "international",
    "categories": [
      {
        "value": "all",
        "label": "All"
      },
      {
        "value": "international",
        "label": "International"
      },
      {
        "value": "league",
        "label": "League"
      },
      {
        "value": "domestic",
        "label": "Domestic"
      },
      {
        "value": "women",
        "label": "Women"
      }
    ],
    "source_url": "https://www.cricbuzz.com/cricket-match/live-scores/recent-matches",
    "fetched_at": "2026-10-28T00:00:00Z",
    "groups": [],
    "total": 0
  }
}

Request schema

No body schema

Response schema

#/definitions/cricbuzz.matchesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	cricbuzz.MatchesResponse	No
data.categories	array	No
data.categories[].label	string	No
data.categories[].value	string	No
data.category	string	No
data.fetched_at	string	No
data.groups	array	No
data.groups[].category	string	No
data.groups[].series	array	No
data.groups[].series[].id	integer	No
data.groups[].series[].matches	array	No
data.groups[].series[].matches[].category	string	No
data.groups[].series[].matches[].current_batting_team_id	integer	No
data.groups[].series[].matches[].description	string	No
data.groups[].series[].matches[].end_time	string	No
data.groups[].series[].matches[].format	string	No
data.groups[].series[].matches[].hide_score_status	string	No
data.groups[].series[].matches[].id	integer	No
data.groups[].series[].matches[].is_time_announced	boolean	No
data.groups[].series[].matches[].score	cricbuzz.MatchScore	No
data.groups[].series[].matches[].score.team1	array	No
data.groups[].series[].matches[].score.team1[].id	integer	No
data.groups[].series[].matches[].score.team1[].overs	number	No
data.groups[].series[].matches[].score.team1[].runs	integer	No
data.groups[].series[].matches[].score.team1[].wickets	integer	No
data.groups[].series[].matches[].score.team2	array	No
data.groups[].series[].matches[].score.team2[].id	integer	No
data.groups[].series[].matches[].score.team2[].overs	number	No
data.groups[].series[].matches[].score.team2[].runs	integer	No
data.groups[].series[].matches[].score.team2[].wickets	integer	No
data.groups[].series[].matches[].series_id	integer	No
data.groups[].series[].matches[].series_name	string	No
data.groups[].series[].matches[].short_status	string	No
data.groups[].series[].matches[].start_time	string	No
data.groups[].series[].matches[].state	string	No
data.groups[].series[].matches[].state_title	string	No
data.groups[].series[].matches[].status	string	No
data.groups[].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.groups[].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.groups[].series[].matches[].url	string	No
data.groups[].series[].matches[].venue	cricbuzz.MatchVenue	No
data.groups[].series[].matches[].venue.city	string	No
data.groups[].series[].matches[].venue.country	string	No
data.groups[].series[].matches[].venue.ground	string	No
data.groups[].series[].matches[].venue.id	integer	No
data.groups[].series[].matches[].venue.latitude	string	No
data.groups[].series[].matches[].venue.longitude	string	No
data.groups[].series[].matches[].venue.timezone	string	No
data.groups[].series[].name	string	No
data.source_url	string	No
data.status	string	No
data.total	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/matches?status=live&category=all" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Cricbuzz endpoint docs Cricbuzz Cricket Data API Cricbuzz archive discovery API documentation Cricbuzz auction guide API documentation Get a Cricbuzz auction Live Blog API documentation Cricbuzz auction live tab API documentation Get Cricbuzz auction News cards API documentation Cricbuzz auction options API documentation

Open in Playground Back to group

Docs menu

Cricbuzz API endpoint

Cricbuzz matches API

GETapiKey2 credits/requestCricbuzzcricbuzz.matchesResponseDoc/cricbuzz/matches

Endpoint facts

Method: GET
API path: /cricbuzz/matches
Auth: apiKey
Credits: 2 credits/request
Charged on: Successful 2xx responses only
Platform: Cricbuzz
Response schema: #/definitions/cricbuzz.matchesResponseDoc

Cricbuzz Cricket Data API Try Cricbuzz matches API in Playground Cricbuzz API documentation

How this endpoint behaves

Query parameters:

status: live, recent, or upcoming. Defaults to live.
category: all, international, league, domestic, or women. Defaults to all.

Sampled response

Request, 29 Oct 2026: GET /cricbuzz/matches
Items in groups: 3
Fields filled in every checked item: 2

Field	Filled in, of 3 checked	Values in the sample
category	3	“international” and 2 other values
series	3	median 1 entry

Request parameters

Parameter	Type	Required	Default	Description	Example
status	string	No	live	Match-list status; defaults to live Allowed values: live, recent, upcoming.	live
category	string	No	all	Match category; defaults to all Allowed values: all, international, league, domestic, women.	international
x-api-key (header)	string	Yes		API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/matches?status=live&category=all" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "status": "recent",
    "category": "international",
    "categories": [
      {
        "value": "all",
        "label": "All"
      },
      {
        "value": "international",
        "label": "International"
      },
      {
        "value": "league",
        "label": "League"
      },
      {
        "value": "domestic",
        "label": "Domestic"
      },
      {
        "value": "women",
        "label": "Women"
      }
    ],
    "source_url": "https://www.cricbuzz.com/cricket-match/live-scores/recent-matches",
    "fetched_at": "2026-10-28T00:00:00Z",
    "groups": [],
    "total": 0
  }
}

Request schema

No body schema

Response schema

#/definitions/cricbuzz.matchesResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	cricbuzz.MatchesResponse	No
data.categories	array	No
data.categories[].label	string	No
data.categories[].value	string	No
data.category	string	No
data.fetched_at	string	No
data.groups	array	No
data.groups[].category	string	No
data.groups[].series	array	No
data.groups[].series[].id	integer	No
data.groups[].series[].matches	array	No
data.groups[].series[].matches[].category	string	No
data.groups[].series[].matches[].current_batting_team_id	integer	No
data.groups[].series[].matches[].description	string	No
data.groups[].series[].matches[].end_time	string	No
data.groups[].series[].matches[].format	string	No
data.groups[].series[].matches[].hide_score_status	string	No
data.groups[].series[].matches[].id	integer	No
data.groups[].series[].matches[].is_time_announced	boolean	No
data.groups[].series[].matches[].score	cricbuzz.MatchScore	No
data.groups[].series[].matches[].score.team1	array	No
data.groups[].series[].matches[].score.team1[].id	integer	No
data.groups[].series[].matches[].score.team1[].overs	number	No
data.groups[].series[].matches[].score.team1[].runs	integer	No
data.groups[].series[].matches[].score.team1[].wickets	integer	No
data.groups[].series[].matches[].score.team2	array	No
data.groups[].series[].matches[].score.team2[].id	integer	No
data.groups[].series[].matches[].score.team2[].overs	number	No
data.groups[].series[].matches[].score.team2[].runs	integer	No
data.groups[].series[].matches[].score.team2[].wickets	integer	No
data.groups[].series[].matches[].series_id	integer	No
data.groups[].series[].matches[].series_name	string	No
data.groups[].series[].matches[].short_status	string	No
data.groups[].series[].matches[].start_time	string	No
data.groups[].series[].matches[].state	string	No
data.groups[].series[].matches[].state_title	string	No
data.groups[].series[].matches[].status	string	No
data.groups[].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.groups[].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.groups[].series[].matches[].url	string	No
data.groups[].series[].matches[].venue	cricbuzz.MatchVenue	No
data.groups[].series[].matches[].venue.city	string	No
data.groups[].series[].matches[].venue.country	string	No
data.groups[].series[].matches[].venue.ground	string	No
data.groups[].series[].matches[].venue.id	integer	No
data.groups[].series[].matches[].venue.latitude	string	No
data.groups[].series[].matches[].venue.longitude	string	No
data.groups[].series[].matches[].venue.timezone	string	No
data.groups[].series[].name	string	No
data.source_url	string	No
data.status	string	No
data.total	integer	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
429	Too Many Requests	#/definitions/app.Response
503	Service Unavailable	#/definitions/app.Response

Code examples

Use environment variables for secrets and keep Crawlora API keys server-side.

curl -X GET "https://api.crawlora.net/api/v1/cricbuzz/matches?status=live&category=all" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

Open in Playground Back to group

Cricbuzz matches API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Cricbuzz matches API

Endpoint facts

How this endpoint behaves

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related