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
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/cricbuzz-cricket/news-list-by-category API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/news-list-by-category?key=<API_KEY>&categoryId=5'
Query Result
Use Cases
- Power a section page for one news category, such as a features or analysis tab, by sending the categoryId taken from the categories feed and rendering the returned headlines and intros.
- Build a category-specific digest email or newsletter block that lists the newest stories of a chosen section, and verify how lastId behaves before you walk beyond the first response.
- Add a load-more button to a news app by feeding the id of the last visible story back as lastId until the response stops returning new stories.
- Monitor one category for fresh headlines on a schedule and compare story ids with your stored list to detect newly published items for an editorial alert.
- Cache story ids and cover image ids from one category and pass them to the article detail and image operations to prefetch the content behind a landing page.
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.