List the latest cricket news stories in one category

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

Returns the latest news stories for a single news category, selected by the required numeric `categoryId` path parameter (default 5). Take the categoryId from the `id` field returned by the news categories operation. The optional numeric `lastId` query parameter pages through the list: leave it empty to load the first page, or send the `id` of the last story returned by this same operation to request the next page. No live probe was recorded for this operation, so the response description comes from a supplied source example that is truncated at 4,000 characters and unverified. In that example the body is an object with an `appIndex` object (`seoTitle`, `webURL`), a `lastUpdatedTime` string and a `storyList` array. Each `storyList` entry is either a `story` object or an `ad` object with `layout`, `name` and `position`, so a client has to skip the ad slots. A story shows `id` (integer), `hline`, `seoHeadline`, `intro`, `context` (a tournament or series label in the example), `storyType`, `source`, `imageId`, `pubTime` (a string of epoch-style digits whose unit is not documented), empty `adsType` and `entitlements` objects and a `coverImage` with `caption`, `id` and `source`. Confirm the exact field set, the page size and the behaviour for a category with no stories against a live response before depending on them.

API Features

Category-filtered headline feed One GET with the categoryId path parameter returns the latest stories for a single news category, so a section page does not have to filter a general feed by tag on the client.
Category IDs from the categories feed categoryId is the id value returned by the news categories operation. The form is preloaded with 5 so you can send a first request immediately and then swap in any other category id.
Story-id cursor for the next page The optional lastId parameter takes the id of the last story you received. Leave it empty for the first page, then pass that id to continue down the same category list.
Editorial labels on every story In the source example each story carries hline, seoHeadline, intro, context and storyType, enough to render a headline, a one-line teaser and a tournament or series label without a second request.
Native ad entries to filter out The example storyList mixes story objects with ad objects that hold layout, name and position. Detect the ad key and skip those entries when you build a clean article list.
Story id hand-off to article detail The integer id of each story is the same value that the news detail operation expects as newsId, so a list screen can open the full article with a single follow-up call.

Live API Demo

GET /api/project/cricbuzz-cricket/news-list-by-category

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/news-list-by-category?key=<API_KEY>&categoryId=5'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

What does the news by category operation return?

It returns the latest news stories for one category. No probe was recorded, so the shape comes from a truncated, unverified source example: an appIndex object, a lastUpdatedTime string and a storyList array whose entries are story objects or ad placeholders.

Where do I get a valid categoryId?

Use the id field returned by the news categories operation. The default value 5 is the sample id supplied with the parameter notes, so confirm in your own categories response which section it maps to before labelling it in your interface.

How do I load the next page of stories?

Call the operation once with lastId empty. For the next page, send the id of the last story in the previous storyList as lastId. The page size is not documented in the supplied evidence, so read the length from your own response.

Why do some storyList entries have no story fields?

In the source example, some entries are ad objects with layout, name and position instead of a story object. Skip them when you build an article list. A probe has not confirmed whether ad entries appear in every response.

Is lastId required?

No. Only categoryId is required. lastId is optional and is only used for paging after the first request.

Does the list include the full article text?

No. The example story objects hold a headline, an intro, a context label, a story type, a source and cover image references. To read the body of a story, pass its id as newsId to the news detail operation.

Which response fields are verified?

None of them have been confirmed by a live probe for this operation. The fields named here, such as hline, intro, context, storyType, pubTime and coverImage, come from a source example truncated at 4,000 characters, so check them against your own response.

What happens with an empty or unknown category?

Coverage depends on the category, so an unknown categoryId or a category with no stories may return an empty or sparse body. The supplied evidence does not show that case, so handle it defensively.

Related operations

Guides

View Subscription Plans →