---
title: "News Articles"
method: GET
path: "/v2/news/"
tags: ["News & Filings"]
---

# News Articles

`GET /v2/news/`

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>

## Query parameters

- `sector` string
- `sub_sector` string
- `commodity_type` 'Bauxite' | 'Coal' | 'Copper' | 'Gold' | 'Iron' | 'Nickel' | 'Non-Metallic Mineral' | 'Sand, Stone, Gravel' | 'Tin'
- `start` string
- `end` string
- `limit` integer
- `offset` integer
- `tags` string
- `extension` 'idx' | 'mining'
- `keyword` string
- `symbols` string

## Response `200`

Paginated list of news articles.

- NewsArticleList
  - `results` NewsArticleListItem[], required
    - `title` string, required — Article headline.
    - `body` string — Article body text (IDX only).
    - `source` string, required — Source URL.
    - `timestamp` string, required — Article publication timestamp.
    - `sector` string — Sector slug (IDX only).
    - `sub_sector` string[] — Subsector slugs (IDX only).
    - `tags` string[] — Tag slugs (IDX only).
    - `symbols` string[] — Related IDX symbols (IDX only).
    - `thumbnail` string, nullable — Thumbnail image URL (IDX only).
    - `dimension` unknown
    - `commodity_type` string[] — Commodity types (mining only).
  - `pagination` NewsArticleListPagination, required
    - `total_count` integer, required — Total number of matching results.
    - `showing` integer, required — Number of results in this page.
    - `limit` integer, required — Maximum results per page.
    - `offset` integer, required — Number of results skipped.
    - `has_next` boolean, required — Whether a next page exists.
    - `has_previous` boolean, required — Whether a previous page exists.
    - `next_offset` integer, nullable, required — Offset for the next page, or null.
    - `previous_offset` integer, nullable, required — Offset for the previous page, or null.

## Other responses

- `400` — Invalid parameters.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.dev/sectors/apis/sectors-api.md) · [All operations](https://skmtc.dev/sectors/apis/sectors-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sectors/sectors-api/revisions/49e492f19d77/schema)