news
Retrieve market-wide or symbol-specific headlines from Stockbit to support sentiment analysis and source discovery. Filter by keyword or date, and paginate with a cursor.
Instructions
News posts, market-wide or for one symbol.
There is no separate news endpoint: news IS the stream with category=STREAM_CATEGORY_NEWS, and the Stockbit symbol page's News tab is exactly this call with a symbol. So news routes to the per-symbol stream when given a symbol and to the market-wide one when not, and fixes the category — pass stream a category instead if you want anything else.
This is community- and media-written Indonesian text, not market data. Use it for sentiment and as a pointer to a source; never quote a price, a ratio or an earnings figure from a post.
Headlines are Indonesian-language and mostly link out to the publisher; the link, image and publisher fields are not named by this projection, so read raw for them.
from_date/to_date are YYYY-MM-DD and calendar-checked.
Paging is a CURSOR, not an offset: there is no page number or offset. Take nextCursor from the result and send it as last_stream_id to get the rows AFTER the ones you have seen; calling again without it returns the same rows. nextCursor is null when the page is empty or its last row carried no id, which means the walk cannot be continued rather than that it has ended.
An empty items with a non-null source is a genuine zero — a quiet symbol or a narrow keyword — and not a reason to retry.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows. Omitted = Stockbit's own page size. | |
| symbol | No | IDX ticker, e.g. BBRI. Omit for market-wide news. | |
| keyword | No | Full-text search over headlines and body. | |
| to_date | No | YYYY-MM-DD, inclusive | |
| from_date | No | YYYY-MM-DD, inclusive | |
| last_stream_id | No | Cursor: the `nextCursor` from the previous page. |