Get text highlights (fours, sixes, wickets) for one innings of a match

View all Cricket Live Scores, Scorecards & Stats API endpoints →

Returns highlights commentary for one innings of a match: the fours, sixes and wickets passages of the text commentary. The request takes matchId in the URL path, a required iid (the innings number, for example 1) and an optional htype filter. htype accepts 0 for all entries, 2 for fours, 4 for sixes, 6 for fours and sixes together, and 8 for wickets. When htype is omitted the catalog describes the result as fours, sixes and wickets, and odd htype values behave like the even value just below them. No response fields are documented for this operation: the source example is an empty JSON object and no live probe was run, so field names and item shape are unverified. Inspect a real response for your own matchId before modelling it, and treat the result as written commentary rather than video clips, because no media or playback fields are documented. The Hundred format has its own highlights operation; this one is the standard route.

API Features

Standard-format highlights route A dedicated highlights route for the standard match path, so a regular match page can request its key passages without using the separate Hundred highlights operation.
Innings chosen with iid The required iid parameter selects the innings (the catalog example is 1), which lets a client request each innings of the same matchId separately and keep the two lists apart.
Event filter through htype The optional htype parameter takes 0, 2, 4, 6 or 8 to ask for all entries, fours, sixes, fours and sixes, or wickets, so one request shape covers boundary and dismissal views.
Mixed default when htype is left out Leaving htype unset returns the catalog default of fours, sixes and wickets together, which is a ready-made key-moments list without choosing a filter.
Odd htype values round down The catalog notes that odd htype values behave like the even value below them, so a value such as 5 is treated like 4; stay with the five documented values to keep results predictable.
Written passages, not clips The operation is described as highlights commentary, and no video, image or playback fields are documented, so it fits text recaps rather than a clip player.

Live API Demo

GET /api/project/cricbuzz-cricket/match-details-get-highlights

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-highlights?key=<API_KEY>&matchId=41881&iid=1'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

Which parameters are required?

matchId (URL path) and iid (query) are required. htype is optional. The defaults are matchId 41881 and iid 1.

What do the htype values mean?

0 returns all entries, 2 fours, 4 sixes, 6 fours and sixes together, and 8 wickets. The catalog lists only these five values and says odd values behave like the even value below them.

What do I get if I leave htype out?

The catalog describes the default as fours, sixes and wickets. That is a mixed key-moments view, which is different from 0 (all entries).

Where do I get matchId and what is iid?

Take matchId from the match list, schedule, series, team or venue match endpoints. iid is the innings id with catalog example 1; the catalog gives no further rule for which innings numbers exist, so check the match before requesting a later innings.

What fields does the response contain?

None are documented. The source example is an empty JSON object and no live probe was run, so field names and item shape are unverified. Inspect a real response for your matchId before building a parser.

Does it return video clips?

No media fields are documented. The operation is described as highlights commentary, so plan for written passages and do not promise clips, playback or redistribution of video.

Can I use it for The Hundred?

The Hundred has its own highlights operation. Use that one for Hundred fixtures and keep this standard route for other matches so the two requests are not mixed.

Can the result be empty?

Yes. The only source example is an empty object, and coverage depends on the match and innings, so handle an empty or sparse response without treating it as a request error.

Related operations

Guides

View Subscription Plans →