Docs menu

Cricinfo API endpoint

Cricinfo commentary API

Returns the latest ball-by-ball and editorial commentary embedded in a public Cricinfo match page. `url` may be a canonical full-scorecard or live-score URL.

GETapiKey3 credits/requestCricinfocricinfo.commentaryResponseDoc/cricinfo/commentary

Endpoint facts

Method: GET
API path: /cricinfo/commentary
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Cricinfo
Response schema: #/definitions/cricinfo.commentaryResponseDoc

Cricinfo API Try Cricinfo commentary API in Playground Cricinfo API documentation

How this endpoint behaves

Query parameters:

url (required): a canonical Cricinfo full-scorecard or live-score URL.
limit (optional): maximum entries from 1 to 100; defaults to 20.

Returns the latest ball-by-ball entries and editorial pre-commentary embedded in the public match page. Matches without commentary return an empty entries array when the upstream page publishes the commentary container.

Live monitoring

Monitored request: GET /cricinfo/commentary?limit=3&url=https%3A%2F%2Fwww.cricinfo.com%2Fseries%2Fduleep-trophy-2026-27-1546436%2Fcentral-zone-vs-east-zone-1st-semi-final-1546439%2Flive-cricket-score
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.71 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /cricinfo/commentary?limit=40&url=https%3A%2F%2Fwww.cricinfo.com%2Fseries%2Fduleep-trophy-2026-27-1546436%2Fcentral-zone-vs-east-zone-1st-semi-final-1546439%2Flive-cricket-score
Items in entries: 20
Fields filled in every checked item: 9
Fields empty in some or all items: 5

Field	Filled in, of 20 checked	Values in the sample
id	20
inning	20	4
over	20	36.02 to 39.03, median 37.05
ball	20	1 to 6, median 3
title	20	Dubey to Ishan (8), Jain to Shami (5), Jain to Gharami (3) and 2 more
text	1	“Sudip Kumar Gharami c Patidar b Jain 14 (16b 1x4 0x6) SR: 8…”
runs	8	1 to 4, median 1
batsman_runs	8	1 to 4, median 1
is_boundary	20	true in 3 of 20
is_wicket	20	true in 1 of 20
total_inning_runs	20	145 to 162, median 150
total_inning_wickets	20	5 to 6, median 6
timestamp	19	2026-09-01
dismissal	1	“Sudip Kumar Gharami c Patidar b Jain 14 (16b 1x4 0x6) SR: 8…”

Request parameters

Parameter	Type	Required	Description	Example
url	string	Yes	Canonical Cricinfo full-scorecard or live-score URL	https://www.cricinfo.com/series/ahmad-shah-abdali-4-day-tournament-2026-1551329/maiwand-champions-vs-mah-e-par-stars-1st-match-1551332/live-cricket-score
limit	integer	No	Maximum commentary entries returned, from 1 to 100	50
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/cricinfo/commentary?url=https%3A%2F%2Fwww.cricinfo.com%2Fseries%2Fahmad-shah-abdali-4-day-tournament-2026-1551329%2Fmaiwand-champions-vs-mah-e-par-stars-1st-match-1551332%2Flive-cricket-score&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.cricinfo.com/series/cup-2026-1/team-a-v-team-b-1-2/live-cricket-score",
    "match": {
      "id": "2",
      "title": "Final"
    },
    "count": 1,
    "entries": [
      {
        "id": "9",
        "inning": 1,
        "over": 4.2,
        "ball": 3,
        "title": "Bowler to Batter",
        "text": "Four runs",
        "runs": 4,
        "batsman_runs": 4,
        "is_boundary": true,
        "is_wicket": false
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/cricinfo.commentaryResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	cricinfo.CommentaryResponse	No
data.count	integer	No
data.entries	array	No
data.entries[].ball	integer	No
data.entries[].batsman_runs	integer	No
data.entries[].dismissal	string	No
data.entries[].id	string	No
data.entries[].inning	integer	No
data.entries[].is_boundary	boolean	No
data.entries[].is_wicket	boolean	No
data.entries[].over	number	No
data.entries[].runs	integer	No
data.entries[].text	string	No
data.entries[].timestamp	string	No
data.entries[].title	string	No
data.entries[].total_inning_runs	integer	No
data.entries[].total_inning_wickets	integer	No
data.fetched_at	string	No
data.match	cricinfo.MatchSummary	No		MatchSummary record, 20 fields: format, id, series, start_date, state, status, status_text, teams, title, url. Described under Cricinfo team profile API.
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/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/cricinfo/commentary?url=https%3A%2F%2Fwww.cricinfo.com%2Fseries%2Fahmad-shah-abdali-4-day-tournament-2026-1551329%2Fmaiwand-champions-vs-mah-e-par-stars-1st-match-1551332%2Flive-cricket-score&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Shared guides

Authentication Errors and retries Rate limits and credits Pricing Acceptable use

More Cricinfo endpoint docs Cricinfo API Cricinfo international calendar API documentation Cricinfo grounds API documentation Cricinfo live matches API documentation Get a Cricinfo match scorecard API documentation Cricinfo news API documentation Cricinfo photos API documentation

Open in Playground Back to group

Docs menu

Cricinfo API endpoint

Cricinfo commentary API

Returns the latest ball-by-ball and editorial commentary embedded in a public Cricinfo match page. `url` may be a canonical full-scorecard or live-score URL.

GETapiKey3 credits/requestCricinfocricinfo.commentaryResponseDoc/cricinfo/commentary

Endpoint facts

Method: GET
API path: /cricinfo/commentary
Auth: apiKey
Credits: 3 credits/request
Charged on: Successful 2xx responses only
Platform: Cricinfo
Response schema: #/definitions/cricinfo.commentaryResponseDoc

Cricinfo API Try Cricinfo commentary API in Playground Cricinfo API documentation

How this endpoint behaves

Query parameters:

url (required): a canonical Cricinfo full-scorecard or live-score URL.
limit (optional): maximum entries from 1 to 100; defaults to 20.

Live monitoring

Monitored request: GET /cricinfo/commentary?limit=3&url=https%3A%2F%2Fwww.cricinfo.com%2Fseries%2Fduleep-trophy-2026-27-1546436%2Fcentral-zone-vs-east-zone-1st-semi-final-1546439%2Flive-cricket-score
Checks passed, 7 days to 14 Oct 2026: 100%
Median response time: 2.71 s

Current status of every endpoint

Sampled response

Request, 14 Oct 2026: GET /cricinfo/commentary?limit=40&url=https%3A%2F%2Fwww.cricinfo.com%2Fseries%2Fduleep-trophy-2026-27-1546436%2Fcentral-zone-vs-east-zone-1st-semi-final-1546439%2Flive-cricket-score
Items in entries: 20
Fields filled in every checked item: 9
Fields empty in some or all items: 5

Field	Filled in, of 20 checked	Values in the sample
id	20
inning	20	4
over	20	36.02 to 39.03, median 37.05
ball	20	1 to 6, median 3
title	20	Dubey to Ishan (8), Jain to Shami (5), Jain to Gharami (3) and 2 more
text	1	“Sudip Kumar Gharami c Patidar b Jain 14 (16b 1x4 0x6) SR: 8…”
runs	8	1 to 4, median 1
batsman_runs	8	1 to 4, median 1
is_boundary	20	true in 3 of 20
is_wicket	20	true in 1 of 20
total_inning_runs	20	145 to 162, median 150
total_inning_wickets	20	5 to 6, median 6
timestamp	19	2026-09-01
dismissal	1	“Sudip Kumar Gharami c Patidar b Jain 14 (16b 1x4 0x6) SR: 8…”

Request parameters

Parameter	Type	Required	Description	Example
url	string	Yes	Canonical Cricinfo full-scorecard or live-score URL	https://www.cricinfo.com/series/ahmad-shah-abdali-4-day-tournament-2026-1551329/maiwand-champions-vs-mah-e-par-stars-1st-match-1551332/live-cricket-score
limit	integer	No	Maximum commentary entries returned, from 1 to 100	50
x-api-key (header)	string	Yes	API key required

cURL example

curl -X GET "https://api.crawlora.net/api/v1/cricinfo/commentary?url=https%3A%2F%2Fwww.cricinfo.com%2Fseries%2Fahmad-shah-abdali-4-day-tournament-2026-1551329%2Fmaiwand-champions-vs-mah-e-par-stars-1st-match-1551332%2Flive-cricket-score&limit=10" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "source_url": "https://www.cricinfo.com/series/cup-2026-1/team-a-v-team-b-1-2/live-cricket-score",
    "match": {
      "id": "2",
      "title": "Final"
    },
    "count": 1,
    "entries": [
      {
        "id": "9",
        "inning": 1,
        "over": 4.2,
        "ball": 3,
        "title": "Bowler to Batter",
        "text": "Four runs",
        "runs": 4,
        "batsman_runs": 4,
        "is_boundary": true,
        "is_wicket": false
      }
    ]
  }
}

Request schema

No body schema

Response schema

#/definitions/cricinfo.commentaryResponseDoc

Field	Type	Required	Example	Description
code	integer	No	200
data	cricinfo.CommentaryResponse	No
data.count	integer	No
data.entries	array	No
data.entries[].ball	integer	No
data.entries[].batsman_runs	integer	No
data.entries[].dismissal	string	No
data.entries[].id	string	No
data.entries[].inning	integer	No
data.entries[].is_boundary	boolean	No
data.entries[].is_wicket	boolean	No
data.entries[].over	number	No
data.entries[].runs	integer	No
data.entries[].text	string	No
data.entries[].timestamp	string	No
data.entries[].title	string	No
data.entries[].total_inning_runs	integer	No
data.entries[].total_inning_wickets	integer	No
data.fetched_at	string	No
data.match	cricinfo.MatchSummary	No		MatchSummary record, 20 fields: format, id, series, start_date, state, status, status_text, teams, title, url. Described under Cricinfo team profile API.
data.source_url	string	No
msg	string	No	OK

Failure responses

Status	Description	Schema
400	Bad Request	#/definitions/app.Response
404	Not Found	#/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/cricinfo/commentary?url=https%3A%2F%2Fwww.cricinfo.com%2Fseries%2Fahmad-shah-abdali-4-day-tournament-2026-1551329%2Fmaiwand-champions-vs-mah-e-par-stars-1st-match-1551332%2Flive-cricket-score&limit=10" \
  -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

Cricinfo commentary API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related

Cricinfo commentary API

Endpoint facts

How this endpoint behaves

Live monitoring

Sampled response

Request parameters

cURL example

Example JSON response

Failure responses

Code examples

Shared guides

Related