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

Topic-scoped news feed One GET with the topicId path parameter returns the latest stories filed under a single editorial topic, so a topic page does not have to filter the general news index on the client.
Topic IDs from the topics list topicId is the id value returned by the news topics operation. The form is preloaded with 349 so a first request can be sent at once, and any other topic id from the list can be swapped in.
lastId cursor for further pages Leave lastId empty for the first page, then pass the id of the last story you received to load the next one. The topicId stays the same on every page request.
Headline, intro and context per story Each story in the source example carries hline, seoHeadline, intro and a short context label, which is enough to render a topic card without opening the article.
Premium gating hints The example stories include an entitlements object with name and type values, and a planId on the story, so an interface can label gated stories instead of treating every item as freely readable.
Topic page title and link The appIndex object returns a seoTitle string and a webURL string for the topic news page in the example, useful as a heading or reference link next to the story list.

Live API Demo

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

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-topic?key=<API_KEY>&topicId=349'
📢
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 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.

Related operations

Guides

View Subscription Plans →