Sign in

v1

latestOpenAPI 3.0.32026-07-2664108290.0 KB
News & Filings

News Articles

Returns paginated news articles from either the IDX (Indonesian Stock Exchange) or mining news sources. Use the extension parameter to choose the data source — each extension has its own set of valid filter parameters.

<Warning>Mixing IDX and mining parameters will return a 400 error. E.g. passing sector with extension=mining is invalid.</Warning>

<Accordion title="IDX Extension Parameters (extension=idx)"> - **sector**: Comma-separated sector slugs (kebab-case). Get values from the [Subsectors](./helper-list/subsectors) endpoint. - **sub_sector**: Comma-separated subsector slugs (kebab-case). E.g. `banks`, `insurance`, `retailing`. Get valid values from the [Subsectors](./helper-list/subsectors) endpoint. - **tags**: Comma-separated tag slugs. Get values from the [News Tags](./helper-list/tags) endpoint. - **symbols**: Comma-separated IDX symbols. E.g. `BBCA,BBRI,BMRI`. - **keyword**: Case-insensitive substring match on article title. </Accordion> <Accordion title="Mining Extension Parameters (extension=mining)"> - **keyword**: Case-insensitive substring match on article title. - **commodity_type**: Filter by commodity. E.g. `Coal`, `Nickel`, `Gold`. </Accordion>

<Note>Date filters: both start and end are independent and optional — omit either side to leave that bound unconstrained. Future end dates return 400.</Note>

<Info>Costs 1 API credit.</Info>

get/v2/news/

Query parameters

sectorstring

IDX only. Comma-separated sector slugs (kebab-case).

sub_sectorstring

IDX only. Comma-separated subsector slugs (kebab-case).

commodity_type'Bauxite' | 'Coal' | 'Copper' | 'Gold' | 'Iron' | 'Nickel' | 'Non-Metallic Mineral' | 'Sand, Stone, Gravel' | 'Tin'

Mining only. Filter by commodity type. E.g. Coal, Nickel.

startstring

Start date in YYYY-MM-DD format. Optional; if omitted, no lower bound is applied. Filters on timestamp.

endstring

End date in YYYY-MM-DD format. Optional; if omitted, no upper bound is applied. Future dates return 400.

limitinteger

Items per page. Max 30.

offsetinteger

Items to skip for pagination.

tagsstring

IDX only. Comma-separated tag slugs. Get valid values from the News Tags endpoint.

extension'idx' | 'mining'

Data source. Default idx.

keywordstring

Case-insensitive substring match on article title. Works for both IDX and mining.

symbolsstring

IDX only. Comma-separated IDX symbols. E.g. BBCA,BBRI.

Response

Paginated list of news articles.