Get cricket news stories for one series or tournament by series ID

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

Returns the news stories attached to a single cricket series, selected by the required numeric `seriesId` path parameter (default 3636). Take the seriesId from the `id` field returned by the series list or series archives operations. The operation accepts no other parameters, so the supplied evidence documents no paging cursor for it. No live probe was recorded, 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` (the series name in the example), `storyType` (for example News or Match Features), `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 number of stories returned and the behaviour for a series with no coverage against a live response before depending on them.

API Features

Series-scoped story feed One GET with the seriesId path parameter returns the news stories tied to a single tour, league or tournament, so a series page does not have to filter a general feed on the client.
Series IDs from the series lists seriesId is the id value returned by the series list or series archives operations. The form is preloaded with 3636 so you can send a first request at once and then swap in any other series id.
Edition-safe tournament lookup A numeric id points to one edition of a recurring tournament, so stories from different years of a similarly named event are not mixed the way a keyword search could mix them.
Series name in the context field In the supplied example the context field of each story carries the series name, which lets a client confirm that a story belongs to the requested tournament before it renders a card.
Story types inside one tournament The storyType field separates plain news from other formats such as match features in the example, so one series feed can be split into tabs or filter chips without extra calls.
Series page title and link The appIndex object returns a seoTitle string and a webURL string for the series news page in the example, useful as a heading or a reference link next to the story list.

Live API Demo

GET /api/project/cricbuzz-cricket/series-get-news

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/series-get-news?key=<API_KEY>&seriesId=3636'
📢
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 series news operation return?

It returns the news stories for one series. 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 seriesId?

Use the id field returned by the series list or series archives operations. The default value 3636 is the sample id supplied with the parameter notes, so check in your own series response which tournament it maps to before labelling it in your interface.

Can I page through older series stories?

The supplied evidence documents only the seriesId path parameter and no paging cursor. How many stories come back, and whether older ones are reachable, has to be confirmed against a live 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 any entry that has no story key when you build article cards.

How do I read the full article for a story?

Each story carries an integer id. Pass that id to the news detail operation to request the article body, because this operation returns only the headline, intro and cover image reference.

Does lastUpdatedTime tell me when the newest story was published?

Not reliably. In the example lastUpdatedTime is a larger number than every pubTime shown, so it looks like a page-level timestamp rather than a story date. The unit of both fields is undocumented, so verify them before using them for sorting or freshness checks.

Which response fields are verified?

None. There is no recorded probe for this operation, and the source example is cut off at 4,000 characters, so field names, types and the story count are unconfirmed until you inspect a live response.

What happens for a series with no news?

The evidence does not say. Treat a missing or empty storyList as a normal outcome, because coverage depends on the series, and show an empty state instead of treating it as an error.

Related operations

Guides

View Subscription Plans →