List the latest cricket news stories for one topic by topic ID, with optional lastId paging
View all Cricket Live Scores, Scorecards & Stats API endpoints →Returns the latest cricket news stories filed under one editorial topic. The required numeric `topicId` path parameter (default 349) is the `id` value returned by the news topics operation. The optional numeric `lastId` query parameter is a paging cursor: leave it empty to load the first page, or pass the `id` of the last story returned by this same operation to load 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`, `storyType`, `source`, `imageId`, `pubTime` (a string of epoch-style digits whose unit is not documented), an empty `adsType` object, an `entitlements` object and a `coverImage` with `caption`, `id` and `source`. In the example the entitlements of the listed stories carry `name` and `type` values, sometimes a `teamId` array or a `seriesId`, and the stories also carry a `planId`, which suggests that some topic stories are premium-gated. Confirm the exact field set, the page size, the paging behaviour and the result for a topic 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-topic API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/news-list-by-topic?key=<API_KEY>&topicId=349'
Query Result
Use Cases
- Build a topic-specific story collection for readers who follow one editorial theme, using the topicId taken from the topics list as the only selector.
- Load additional topic items by saving the id of the last story on each page and sending it as lastId, while keeping the selected topicId fixed across the paging requests.
- Show a premium badge on topic stories whose entitlements object is non-empty, and keep ungated stories visible without that badge.
- Run a scheduled collector that stores story ids per topic and flags new ids, so a newsletter highlights fresh coverage of a long-running storyline.
- Count stories per storyType inside one topic to see whether a theme is mostly features, interviews or news reports before deciding which tab to feature.
Frequently asked questions
What does the news by topic operation return?
It returns the latest news stories for one topic. 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 topicId?
Use the id value returned by the news topics operation. The default 349 is the sample id supplied with the parameter notes, so check in your own topics response which topic it maps to before labelling it in your interface.
How do I load the next page of topic stories?
Leave lastId empty for the first page. For the next page, send the id of the last story in the previous response as lastId and keep the same topicId. The page size is not documented in the supplied evidence.
What happens if I omit lastId?
The parameter is optional. When it is empty the operation loads the first page of the topic, according to the parameter notes.
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 any entry that has no story key before you render or store articles.
Are all topic stories free to read?
Not necessarily. The source example shows stories with a non-empty entitlements object (name, type and sometimes teamId or seriesId) and a planId, which points to premium-labelled content. Verify against a live response how gated stories appear for your topic.
What is pubTime and in which unit?
In the source example pubTime is a string of digits that looks like an epoch value, but the unit is not documented. Compare a few values with known publication dates before converting them.
How is this different from the latest news or category operations?
This operation selects stories by topic id from the news topics list. The latest-news operation lists the general feed and the category operation selects by category id, so choose the one whose id source matches the filter you want.