SEsectors
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](https://docs.sectors.app/api-references/v2/indonesia/helper-list/subsectors) endpoint. - **sub_sector**: Comma-separated subsector slugs (kebab-case). E.g. `banks`, `insurance`, `retailing`. Get valid values from the [Subsectors](https://docs.sectors.app/api-references/v2/indonesia/helper-list/subsectors) endpoint. - **tags**: Comma-separated tag slugs. Get values from the [News Tags](https://docs.sectors.app/api-references/v2/indonesia/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/

Request

  • Base URL
    https://api.sectors.app
  • URL
    https://api.sectors.app/v2/news/
  • Auth
    API key in header Authorization

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.

Changes

No recorded changes to this operation across all 2 revisions of this API.