# IDX Channel — Zapi reference

> Indonesian market news and live IDX market data — articles by channel, date and tag, plus stock quotes, indices and currency rates.

**Base URL:** `https://api.zpi.web.id`
**Auth:** Send `x-api-key: YOUR_KEY` header on every request. Get a free key at https://zpi.web.id/dashboard/keys.
**Response envelope:** `{ content, message, errors }`
**Rate limit:** 60 req/min on free tier.

**Related:**
- Detail page: https://zpi.web.id/api/finance/idxchannel
- Endpoint catalog: https://zpi.web.id/category/finance
- Concise index: https://zpi.web.id/llms.txt
- Full reference: https://zpi.web.id/llms-full.txt

---

## IDX Channel

**Category:** finance · **Slug:** `idxchannel`
**Detail page:** https://zpi.web.id/api/finance/idxchannel

Indonesian market news and live IDX market data — articles by channel, date and tag, plus stock quotes, indices and currency rates.

**Tags:** idxchannel, saham, idx, indonesia, market, news, finance

### Stock Table

Paged table of every listed stock, sortable by volume or change percent.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/stocks`
- **Cache TTL:** 60s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `page` | number | query | no | Page number, 10 rows per page. Default 1 |
| `sortBy` | enum(volume|changePercent) | query | no | Sort column. Omit for the upstream's default order |
| `sort` | enum(asc|desc) | query | no | Sort direction. Only applied together with sortBy |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/stocks?page=1&sortBy=volume&sort=desc" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/stocks?page=1&sortBy=volume&sort=desc", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/stocks?page=1&sortBy=volume&sort=desc",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "sort": null,
  "count": 10,
  "items": [
    {
      "code": "AADI",
      "open": 9725,
      "close": 9900,
      "change": 175,
      "volume": 10192200,
      "updatedAt": "2026-08-20T10:55:10.000Z",
      "changePercent": 1.8
    },
    {
      "code": "AALI",
      "open": 7750,
      "close": 8000,
      "change": 250,
      "volume": 2770700,
      "updatedAt": "2026-08-20T10:55:10.000Z",
      "changePercent": 3.23
    },
    {
      "code": "ABDA",
      "open": 3810,
      "close": 3810,
      "change": 0,
      "volume": 1000,
      "updatedAt": "2026-08-20T10:55:10.000Z",
      "changePercent": 0
    },
    {
      "code": "ABMM",
      "open": 2700,
      "close": 2720,
      "change": 30,
      "volume": 803300,
      "updatedAt": "2026-08-20T10:55:10.000Z",
      "changePercent": 1.12
    },
    {
      "code": "ACES",
      "open": 364,
      "close": 362,
      "change": 0,
      "volume": 18881500,
      "updatedAt": "2026-08-20T10:55:10.000Z",
      "changePercent": 0
    },
    {
      "code": "ACRO",
      "open": 62,
      "close": 63,
      "change": 1,
      "volume": 3282200,
      "updatedAt": "2026-08-20T10:55:10.000Z",
      "changePercent": 1.61
    },
    {
      "code": "ACST",
      "open": 85,
      "close": 85,
      "change": 0,
      "volume": 370600,
      "updatedAt": "2026-08-20T10:55:10.000Z",
      "changePercent": 0
    },
    {
      "code": "ADES",
      "open": 33000,
      "close": 33000,
      "change": 175,
      "volume": 3900,
      "updatedAt": "2026-08-20T10:55:10.000Z",
      "changePercent": 0.53
    }
  ],
  "total": 861,
  "sortBy": null,
  "dataset": "stocks",
  "hasMore": true,
  "nextPage": 2,
  "provider": "idxchannel"
}
```

---

### All Stocks

Every listed stock in one call, with last price, change and timestamp.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/stocks-all`
- **Cache TTL:** 60s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `search` | string | query | no | Filter by ticker code, case-insensitive substring |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/stocks-all?search=BBC" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/stocks-all?search=BBC", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/stocks-all?search=BBC",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 12,
  "items": [
    {
      "code": "BBCA",
      "close": 6400,
      "change": 100,
      "updatedAt": "2026-08-20T10:50:08.000Z",
      "changePercent": 1.59
    },
    {
      "code": "BBHI",
      "close": 905,
      "change": 0,
      "updatedAt": "2026-08-20T10:50:08.000Z",
      "changePercent": 0
    },
    {
      "code": "BBKP",
      "close": 56,
      "change": 1,
      "updatedAt": "2026-08-20T10:50:08.000Z",
      "changePercent": 1.82
    },
    {
      "code": "BBLD",
      "close": 685,
      "change": 5,
      "updatedAt": "2026-08-20T10:50:08.000Z",
      "changePercent": 0.72
    },
    {
      "code": "BBMD",
      "close": 1950,
      "change": 5,
      "updatedAt": "2026-08-20T10:50:08.000Z",
      "changePercent": 0.26
    },
    {
      "code": "BBNI",
      "close": 3590,
      "change": 30,
      "updatedAt": "2026-08-20T10:50:08.000Z",
      "changePercent": 0.84
    },
    {
      "code": "BBRI",
      "close": 3140,
      "change": 60,
      "updatedAt": "2026-08-20T10:50:08.000Z",
      "changePercent": 1.95
    },
    {
      "code": "BBRM",
      "close": 115,
      "change": 0,
      "updatedAt": "2026-08-20T10:50:08.000Z",
      "changePercent": 0
    }
  ],
  "search": "BB",
  "dataset": "stocks-all",
  "provider": "idxchannel"
}
```

---

### Stock Quote

One stock's session: open, high, low, close, previous and change.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/quote`
- **Cache TTL:** 60s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `code` | string | query | yes | Ticker code, with or without case |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/quote?code=BBCA" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/quote?code=BBCA", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/quote?code=BBCA",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "low": 3090,
  "code": "BBRI",
  "high": 3140,
  "open": 3100,
  "close": 3140,
  "change": 60,
  "dataset": "quote",
  "previous": 3080,
  "provider": "idxchannel",
  "updatedAt": "2026-08-20T10:50:08.000Z",
  "changePercent": 1.95
}
```

---

### Ticker List

Every ticker code IDX Channel tracks.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/tickers`
- **Cache TTL:** 21600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `search` | string | query | no | Filter by code, case-insensitive substring |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/tickers?search=BB" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/tickers?search=BB", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/tickers?search=BB",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 12,
  "items": [
    "BBCA",
    "BBHI",
    "BBKP",
    "BBLD",
    "BBMD",
    "BBNI",
    "BBRI",
    "BBRM"
  ],
  "search": "BB",
  "dataset": "tickers",
  "provider": "idxchannel"
}
```

---

### Market Indices

Indonesian indices with last value, change and change percent.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/indices`
- **Cache TTL:** 60s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `code` | string | query | no | Filter to one index code |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/indices?code=IHSG" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/indices?code=IHSG", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/indices?code=IHSG",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "code": "IHSG",
  "count": 1,
  "items": [
    {
      "code": "IHSG",
      "close": 6501.59,
      "change": 107.46,
      "updatedAt": "2026-08-20T10:57:12.000Z",
      "changePercent": 1.68
    }
  ],
  "dataset": "indices",
  "provider": "idxchannel"
}
```

---

### Currency Rates

Foreign currency rates against the rupiah.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/currencies`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `currency` | string | query | no | Filter to one currency, by its three-letter name |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/currencies?currency=USD" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/currencies?currency=USD", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/currencies?currency=USD",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 1,
  "items": [
    {
      "code": "USDRP",
      "rate": 17746,
      "currency": "USD",
      "updatedAt": "2026-08-20T10:45:06.000Z"
    }
  ],
  "dataset": "currencies",
  "currency": "USD",
  "provider": "idxchannel"
}
```

---

### Market Snapshot

Indices and currency rates in a single call.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/market-snapshot`
- **Cache TTL:** 60s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `x` | string | query | no | Unused; this endpoint takes no input |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/market-snapshot?x=VALUE" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/market-snapshot?x=VALUE", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/market-snapshot?x=VALUE",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "dataset": "market-snapshot",
  "indices": [
    {
      "code": "IHSG",
      "close": 6501.59,
      "change": 107.46,
      "updatedAt": "2026-08-20T10:57:12.000Z",
      "changePercent": 1.68
    },
    {
      "code": "LQ45",
      "close": 638.74,
      "change": 11.27,
      "updatedAt": "2026-08-20T10:57:12.000Z",
      "changePercent": 1.8
    },
    {
      "code": "IDX30",
      "close": 356.26,
      "change": 5.32,
      "updatedAt": "2026-08-20T10:57:12.000Z",
      "changePercent": 1.52
    },
    {
      "code": "MNC36",
      "close": 275.97,
      "change": 4.62,
      "updatedAt": "2026-08-20T10:57:12.000Z",
      "changePercent": 1.7
    },
    {
      "code": "JII",
      "close": 390.27,
      "change": 9.35,
      "updatedAt": "2026-08-20T10:57:12.000Z",
      "changePercent": 2.45
    },
    {
      "code": "IDX80",
      "close": 96.11,
      "change": 1.89,
      "updatedAt": "2026-08-20T10:57:12.000Z",
      "changePercent": 2
    },
    {
      "code": "IDXHIDIV20",
      "close": 432.62,
      "change": 5.05,
      "updatedAt": "2026-08-20T10:57:12.000Z",
      "changePercent": 1.18
    },
    {
      "code": "IDXG30",
      "close": 121.26,
      "change": 1.36,
      "updatedAt": "2026-08-20T10:57:12.000Z",
      "changePercent": 1.13
    }
  ],
  "provider": "idxchannel",
  "currencies": [
    {
      "rate": 17746,
      "currency": "USD"
    },
    {
      "rate": 2262,
      "currency": "HKD"
    },
    {
      "rate": 12648,
      "currency": "AUD"
    },
    {
      "rate": 2640,
      "currency": "CNY"
    }
  ],
  "indexCount": 10,
  "currencyCount": 4
}
```

---

### Latest Articles

Newest articles, optionally scoped to one channel or media type.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/latest`
- **Cache TTL:** 120s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `channel` | enum(market-news|economics|banking|syariah|ecotainment|milenomic|inspirator|economia|news|technology) | query | no | Channel to scope to. Omit for all channels |
| `type` | enum(news|video|photo) | query | no | Media type. Omit for all types |
| `page` | number | query | no | Page number, 9 items per page. Default 1 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/latest?channel=market-news&type=news&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/latest?channel=market-news&type=news&page=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/latest?channel=market-news&type=news&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "type": null,
  "count": 9,
  "items": [
    {
      "id": "393077",
      "url": "https://www.idxchannel.com/banking/citi-indonesia-raup-laba-bersih-rp994-miliar-ditopang-pertumbuhan-kredit",
      "slug": "citi-indonesia-raup-laba-bersih-rp994-miliar-ditopang-pertumbuhan-kredit",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2022/04/26/Citi_Indonesia.jpg",
      "title": "Citi Indonesia Raup Laba Bersih Rp994 Miliar Ditopang Pertumbuhan Kredit",
      "source": "idxchannel.com",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2022/04/26/Citi_Indonesia.jpg",
      "publishedAt": "2026-08-20T09:35:00.000Z"
    },
    {
      "id": "393058",
      "url": "https://www.idxchannel.com/banking/bank-jatim-bjtm-perkuat-kerja-sama-dan-layanan-perbankan-di-dinas-pendidikan-se-jawa-timur",
      "slug": "bank-jatim-bjtm-perkuat-kerja-sama-dan-layanan-perbankan-di-dinas-pendidikan-se-jawa-timur",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2026/08/20/bank_jatim_bjtm.jpg",
      "title": "Bank Jatim (BJTM) Perkuat Kerja Sama dan Layanan Perbankan di Dinas Pendidikan se-Jawa Timur",
      "source": "idxchannel.com",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/20/bank_jatim_bjtm.jpg",
      "publishedAt": "2026-08-20T08:10:00.000Z"
    },
    {
      "id": "393043",
      "url": "https://www.idxchannel.com/banking/ibma-dibentuk-indonesia-dorong-penguatan-pasar-bullion-hingga-tingkat-global",
      "slug": "ibma-dibentuk-indonesia-dorong-penguatan-pasar-bullion-hingga-tingkat-global",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2026/08/20/1000193357.jpg",
      "title": "IBMA Dibentuk, Indonesia Dorong Penguatan Pasar Bullion hingga Tingkat Global",
      "source": "idxchannel.com",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/20/1000193357.jpg",
      "publishedAt": "2026-08-20T05:55:00.000Z"
    },
    {
      "id": "393038",
      "url": "https://www.idxchannel.com/banking/percepat-pendalaman-pasar-bulion-nasional-indonesia-kini-punya-indonesia-bullion-market-association",
      "slug": "percepat-pendalaman-pasar-bulion-nasional-indonesia-kini-punya-indonesia-bullion-market-association",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2026/08/20/1000193357.jpg",
      "title": "Percepat Pendalaman Pasar Bulion Nasional, Indonesia Kini Punya Indonesia Bullion Market Association",
      "source": "idxchannel.com",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/20/1000193357.jpg",
      "publishedAt": "2026-08-20T05:26:00.000Z"
    },
    {
      "id": "393016",
      "url": "https://www.idxchannel.com/banking/ibma-bidik-perkuat-ekosistem-bullion-siapkan-gold-expo-hingga-kaji-regulasi-pajak",
      "slug": "ibma-bidik-perkuat-ekosistem-bullion-siapkan-gold-expo-hingga-kaji-regulasi-pajak",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2026/08/20/1000193149.jpg",
      "title": "IBMA Bidik Perkuat Ekosistem Bullion, Siapkan Gold Expo hingga Kaji Regulasi Pajak",
      "source": "idxchannel.com",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/20/1000193149.jpg",
      "publishedAt": "2026-08-20T03:30:00.000Z"
    },
    {
      "id": "393014",
      "url": "https://www.idxchannel.com/banking/indonesian-bullion-market-association-ibma-resmi-diluncurkan-ekosistem-emas-masuk-babak-baru",
      "slug": "indonesian-bullion-market-association-ibma-resmi-diluncurkan-ekosistem-emas-masuk-babak-baru",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2026/08/20/1000193176.jpg",
      "title": "Indonesian Bullion Market Association (IBMA) Resmi Diluncurkan, Ekosistem Emas Masuk Babak Baru",
      "source": "idxchannel.com",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/20/1000193176.jpg",
      "publishedAt": "2026-08-20T03:14:00.000Z"
    },
    {
      "id": "392986",
      "url": "https://www.idxchannel.com/banking/bi-terbitkan-2-kebijakan-baru-dorong-ekspansi-kredit-ke-sektor-prioritas",
      "slug": "bi-terbitkan-2-kebijakan-baru-dorong-ekspansi-kredit-ke-sektor-prioritas",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2025/10/22/Rupiah_sindonews.JPG",
      "title": "BI Terbitkan 2 Kebijakan Baru Dorong Ekspansi Kredit ke Sektor Prioritas",
      "source": "idxchannel.com",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2025/10/22/Rupiah_sindonews.JPG",
      "publishedAt": "2026-08-20T00:00:00.000Z"
    },
    {
      "id": "392951",
      "url": "https://www.idxchannel.com/banking/bi-dorong-satu-himbara-jadi-kliring-bank-renminbi-di-indonesia",
      "slug": "bi-dorong-satu-himbara-jadi-kliring-bank-renminbi-di-indonesia",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2025/06/18/Fasilitas_Pegawai_Bank_Indonesia.jpg",
      "title": "BI Dorong Satu Himbara Jadi Kliring Bank Renminbi di Indonesia",
      "source": "idxchannel.com",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2025/06/18/Fasilitas_Pegawai_Bank_Indonesia.jpg",
      "publishedAt": "2026-08-19T14:12:00.000Z"
    }
  ],
  "channel": "banking",
  "dataset": "latest",
  "hasMore": true,
  "nextPage": 2,
  "provider": "idxchannel"
}
```

---

### Article Search

Search articles by keyword, channel and media type.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/search`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `q` | string | query | yes | Search keyword |
| `channel` | enum(market-news|economics|banking|syariah|ecotainment|milenomic|inspirator|economia|news|technology) | query | no | Channel to scope to. Omit for all channels |
| `type` | enum(news|video|photo) | query | no | Media type. Omit for all types |
| `page` | number | query | no | Page number, 9 items per page. Default 1 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/search?q=saham&channel=market-news&type=news&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/search?q=saham&channel=market-news&type=news&page=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/search?q=saham&channel=market-news&type=news&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "page": 1,
  "type": null,
  "count": 9,
  "items": [
    {
      "id": "393078",
      "url": "https://www.idxchannel.com/market-news/10-saham-top-gainer-perdagangan-kamis-20-agustus-2026-ada-kija-hingga-psab",
      "slug": "10-saham-top-gainer-perdagangan-kamis-20-agustus-2026-ada-kija-hingga-psab",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2026/02/16/Saham_naik_-_Freepik_16_Feb_26.jpg",
      "title": "10 Saham Top Gainer Perdagangan Kamis 20 Agustus 2026, Ada KIJA hingga PSAB",
      "source": "idxchannel.com",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/02/16/Saham_naik_-_Freepik_16_Feb_26.jpg",
      "publishedAt": "2026-08-20T09:36:00.000Z"
    },
    {
      "id": "393072",
      "url": "https://www.idxchannel.com/market-news/ihsg-ditutup-tembus-level-6500-saham-ammn-kija-terbang",
      "slug": "ihsg-ditutup-tembus-level-6500-saham-ammn-kija-terbang",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2025/11/07/ihsg_hijau.jpg",
      "title": "IHSG Ditutup Tembus Level 6.500, Saham AMMN-KIJA Terbang",
      "source": "idxchannel.com",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2025/11/07/ihsg_hijau.jpg",
      "publishedAt": "2026-08-20T09:18:00.000Z"
    },
    {
      "id": "393070",
      "url": "https://www.idxchannel.com/market-news/15-saham-dengan-penurunan-investor-terdalam-juli-2026-intip-deretan-emitennya",
      "slug": "15-saham-dengan-penurunan-investor-terdalam-juli-2026-intip-deretan-emitennya",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2026/01/31/saham_dok_freepik.jpg",
      "title": "15 Saham dengan Penurunan Investor Terdalam Juli 2026, Intip Deretan Emitennya",
      "source": "idxchannel.com",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/01/31/saham_dok_freepik.jpg",
      "publishedAt": "2026-08-20T09:12:00.000Z"
    },
    {
      "id": "393067",
      "url": "https://www.idxchannel.com/market-news/15-saham-dengan-peningkatan-investor-tertinggi-juli-2026-bnbr-hingga-vktr",
      "slug": "15-saham-dengan-peningkatan-investor-tertinggi-juli-2026-bnbr-hingga-vktr",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2026/03/12/Investor_misterius_-_Saham_-_Freepik_-_12_Mar_26.jpeg",
      "title": "15 Saham dengan Peningkatan Investor Tertinggi Juli 2026, BNBR hingga VKTR",
      "source": "idxchannel.com",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/03/12/Investor_misterius_-_Saham_-_Freepik_-_12_Mar_26.jpeg",
      "publishedAt": "2026-08-20T08:34:00.000Z"
    },
    {
      "id": "393036",
      "url": "https://www.idxchannel.com/market-news/ihsg-melonjak-147-persen-ke-6487-di-sesi-i-440-saham-kompak-menguat",
      "slug": "ihsg-melonjak-147-persen-ke-6487-di-sesi-i-440-saham-kompak-menguat",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2024/08/14/IHSG_hijau.JPG",
      "title": "IHSG Melonjak 1,47 Persen ke 6.487 di Sesi I, 440 Saham Kompak Menguat",
      "source": "idxchannel.com",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2024/08/14/IHSG_hijau.JPG",
      "publishedAt": "2026-08-20T05:20:00.000Z"
    },
    {
      "id": "393007",
      "url": "https://www.idxchannel.com/market-news/ihsg-diproyeksi-mixed-mdka-brms-jadi-sorotan-analis",
      "slug": "ihsg-diproyeksi-mixed-mdka-brms-jadi-sorotan-analis",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2025/12/01/Ciri-Ciri_Saham_Gorengan.jpeg",
      "title": "IHSG Diproyeksi Mixed, MDKA-BRMS Jadi Sorotan Analis",
      "source": "idxchannel.com",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2025/12/01/Ciri-Ciri_Saham_Gorengan.jpeg",
      "publishedAt": "2026-08-20T02:53:00.000Z"
    },
    {
      "id": "393004",
      "url": "https://www.idxchannel.com/market-news/ihsg-dibuka-rebound-ke-6447-sektor-barang-baku-melonjak-3-persen",
      "slug": "ihsg-dibuka-rebound-ke-6447-sektor-barang-baku-melonjak-3-persen",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2026/07/23/IHSG_6_430_Dhera.jpg",
      "title": "IHSG Dibuka Rebound ke 6.447, Sektor Barang Baku Melonjak 3 Persen",
      "source": "idxchannel.com",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/07/23/IHSG_6_430_Dhera.jpg",
      "publishedAt": "2026-08-20T02:31:00.000Z"
    },
    {
      "id": "392980",
      "url": "https://www.idxchannel.com/market-news/harga-saham-turun-hingga-57-persen-cbdk-berencana-buyback-rp250-miliar",
      "slug": "harga-saham-turun-hingga-57-persen-cbdk-berencana-buyback-rp250-miliar",
      "type": "news",
      "image": "https://img.idxchannel.com/media/800/images/idx/2022/05/23/tujuan_dan_dampak_buyback.jpeg",
      "title": "Harga Saham Turun hingga 57 Persen, CBDK Berencana Buyback Rp250 Miliar",
      "source": "idxchannel.com",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2022/05/23/tujuan_dan_dampak_buyback.jpeg",
      "publishedAt": "2026-08-19T23:00:00.000Z"
    }
  ],
  "query": "ihsg",
  "channel": null,
  "dataset": "search",
  "hasMore": true,
  "nextPage": 2,
  "provider": "idxchannel"
}
```

---

### Article Archive

Articles published on a given date, filterable by channel.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/archive`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `date` | string | query | no | Archive date as YYYY-MM-DD. Default today in Jakarta time |
| `channel` | enum(market-news|economics|banking|syariah|ecotainment|milenomic|inspirator|economia|news|technology) | query | no | Channel to scope to. Omit for all channels |
| `page` | number | query | no | Page number, 6 items per page. Default 1 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/archive?date=2026-08-20&channel=economics&page=1" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/archive?date=2026-08-20&channel=economics&page=1", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/archive?date=2026-08-20&channel=economics&page=1",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "date": "2026-08-19",
  "page": 1,
  "count": 6,
  "items": [
    {
      "url": "https://www.idxchannel.com/economics/ekonom-nilai-pengalihan-utang-whoosh-ke-kemenkeu-bukan-solusi-bebas-risiko-fiskal",
      "title": "Ekonom Nilai Pengalihan Utang Whoosh ke Kemenkeu Bukan Solusi Bebas Risiko Fiskal",
      "source": "idxchannel.com",
      "caption": "Ekonom Nilai Pengalihan Utang Whoosh ke Kemenkeu Bukan Solusi Bebas Risiko Fiskal. (Foto: iNews Media Group)",
      "category": "ECONOMICS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/03/23/Whoosh.jpeg",
      "publishedAt": "2026-08-19T16:00:00.000Z"
    },
    {
      "url": "https://www.idxchannel.com/economics/pemerintah-siapkan-pendataan-rumah-rusak-dan-lahan-huntap-bagi-korban-terdampak-gempa-ntt",
      "title": "Pemerintah Siapkan Pendataan Rumah Rusak dan Lahan Huntap bagi Korban Terdampak Gempa NTT",
      "source": "idxchannel.com",
      "caption": "Pemerintah Siapkan Pendataan Rumah Rusak dan Lahan Huntap bagi Korban Terdampak Gempa NTT. (Foto Istimewa)",
      "category": "ECONOMICS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/15/Gempa_Bumi_NTT-3.jpg",
      "publishedAt": "2026-08-19T15:30:00.000Z"
    },
    {
      "url": "https://www.idxchannel.com/economics/kementerian-pkp-dorong-pemanfaatan-aset-negara-untuk-perluasan-lahan-rumah-subsidi",
      "title": "Kementerian PKP Dorong Pemanfaatan Aset Negara untuk Perluasan Lahan Rumah Subsidi",
      "source": "idxchannel.com",
      "caption": "Kementerian PKP Dorong Pemanfaatan Aset Negara untuk Perluasan Lahan Rumah Subsidi. (Foto: iNews Media Group)",
      "category": "ECONOMICS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/05/maruarar_roh.jpg",
      "publishedAt": "2026-08-19T15:30:00.000Z"
    },
    {
      "url": "https://www.idxchannel.com/economics/harga-beli-listrik-pltp-masih-rendah-proyek-pengembangan-panas-bumi-tak-menarik-bagi-investor",
      "title": "Harga Beli Listrik PLTP Masih Rendah, Proyek Pengembangan Panas Bumi Tak Menarik bagi Investor",
      "source": "idxchannel.com",
      "caption": "Harga Beli Listrik PLTP Masih Rendah, Proyek Pengembangan Panas Bumi Tak Menarik bagi Investor. (Foto Istimewa)",
      "category": "ECONOMICS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2021/03/01/panas_bumi_idxchannel.jpg",
      "publishedAt": "2026-08-19T14:45:00.000Z"
    },
    {
      "url": "https://www.idxchannel.com/market-news/wall-street-dibuka-rebound-usai-aksi-jual-saham-teknologi-mereda",
      "title": "Wall Street Dibuka Rebound usai Aksi Jual Saham Teknologi Mereda",
      "source": "idxchannel.com",
      "caption": "Wall Street Dibuka Rebound usai Aksi Jual Saham Teknologi Mereda. (Foto Istimewa)",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2024/10/26/wall_street.jfif",
      "publishedAt": "2026-08-19T14:32:00.000Z"
    },
    {
      "url": "https://www.idxchannel.com/market-news/wton-gabung-kso-senilai-rp334-miliar-amankan-struktur-tanah-di-tol-cisumdawu",
      "title": "WTON Gabung KSO Senilai Rp334 Miliar, Amankan Struktur Tanah di Tol Cisumdawu",
      "source": "idxchannel.com",
      "caption": "WTON Gabung KSO Senilai Rp334 Miliar, Amankan Struktur Tanah di Tol Cisumdawu",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/19/WTON_Cisumdawu.jpeg",
      "publishedAt": "2026-08-19T14:15:00.000Z"
    }
  ],
  "channel": null,
  "dataset": "archive",
  "hasMore": true,
  "nextPage": 2,
  "provider": "idxchannel"
}
```

---

### Related Articles

Articles tagged with a ticker code or keyword.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/related`
- **Cache TTL:** 300s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `q` | string | query | yes | Ticker code or tag keyword |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/related?q=bbca" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/related?q=bbca", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/related?q=bbca",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 6,
  "items": [
    {
      "id": "393009",
      "url": "https://www.idxchannel.com/market-news/10-saham-dengan-dividen-yield-jumbo-dan-valuasi-menarik-bssr-hingga-bmri",
      "type": "news",
      "title": "10 Saham dengan Dividen Yield Jumbo dan Valuasi Menarik, BSSR hingga BMRI",
      "source": "idxchannel.com",
      "caption": "10 Saham dengan Dividen Yield Jumbo dan Valuasi Menarik, BSSR hingga BMRI. (Foto: iStock)",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/06/08/dividen_-_istock_-_8_June_26_-.jpg",
      "publishedAt": "2026-08-20T03:07:00.000Z"
    },
    {
      "id": "392901",
      "url": "https://www.idxchannel.com/market-news/bi-tahan-suku-bunga-di-level-575-persen-simak-gerak-saham-bank",
      "type": "news",
      "title": "BI Tahan Suku Bunga di Level 5,75 Persen, Simak Gerak Saham Bank",
      "source": "idxchannel.com",
      "caption": "BI Tahan Suku Bunga di Level 5,75 Persen, Simak Gerak Saham Bank. (Foto: Magnific)",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2025/10/20/gedung_bank_-_freepik_20_okt_25.jpg",
      "publishedAt": "2026-08-19T07:57:00.000Z"
    },
    {
      "id": "392661",
      "url": "https://www.idxchannel.com/banking/bi-hadirkan-kartu-kredit-indonesia-bank-mandiri-bmri-hingga-bsi-bris-siap-dukung",
      "type": "news",
      "title": "BI Hadirkan Kartu Kredit Indonesia, Bank Mandiri (BMRI) hingga BSI (BRIS) Siap Dukung",
      "source": "idxchannel.com",
      "caption": "Bank Indonesia (BI) bersama Asosiasi Sistem Pembayaran Indonesia (ASPI) resmi meluncurkan Kartu Kredit Indonesia (KKI) pada Senin (17/8/2026). (Foto: Dok. BI)",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/17/bank_indonesia.jpg",
      "publishedAt": "2026-08-17T03:45:00.000Z"
    },
    {
      "id": "392343",
      "url": "https://www.idxchannel.com/banking/penyaluran-kur-bri-bbri-capai-rp10381-triliun-hingga-akhir-juni-2026",
      "type": "news",
      "title": "Penyaluran KUR BRI (BBRI) Capai Rp103,81 Triliun hingga Akhir Juni 2026",
      "source": "idxchannel.com",
      "caption": "Penyaluran KUR BRI (BBRI) Capai Rp103,81 Triliun hingga Akhir Juni 2026 (FOTO:Dok BRI)",
      "category": "BANKING",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/08/13/1001213711.jpg",
      "publishedAt": "2026-08-13T09:36:00.000Z"
    },
    {
      "id": "391908",
      "url": "https://www.idxchannel.com/market-news/ihsg-sesi-i-parkir-di-zona-merah-turun-049-persen-ke-6378",
      "type": "news",
      "title": "IHSG Sesi I Parkir di Zona Merah, Turun 0,49 Persen ke 6.378",
      "source": "idxchannel.com",
      "caption": "Indeks Harga Saham Gabungan (IHSG) parkir di zona merah pada penutupan sesi I perdagangan Senin (10/8/2026). (Foto: iNews Media/Dhera Arizona)",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/07/23/ihsg_dhera.jpg",
      "publishedAt": "2026-08-10T05:10:00.000Z"
    },
    {
      "id": "391821",
      "url": "https://www.idxchannel.com/market-news/10-saham-paling-banyak-diborong-asing-sepekan-bbri-teratas",
      "type": "news",
      "title": "10 Saham Paling Banyak Diborong Asing Sepekan, BBRI Teratas",
      "source": "idxchannel.com",
      "caption": "10 Saham Paling Banyak Diborong Asing Sepekan, BBRI Teratas. (Foto: Magnific0",
      "category": "MARKET NEWS",
      "thumbnail": "https://img.idxchannel.com/media/439/images/idx/2026/06/03/Saham_naik_-_buy_-_magnific_-_freepi_Jun_26.jpeg",
      "publishedAt": "2026-08-09T04:53:00.000Z"
    }
  ],
  "query": "bbri",
  "dataset": "related",
  "provider": "idxchannel"
}
```

---

### Newsroom Feed

Newsroom RSS, the one listing that carries the numeric content id.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/feed`
- **Cache TTL:** 120s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `limit` | number | query | no | Maximum items to return. Default 10 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/feed?limit=10" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/feed?limit=10", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/feed?limit=10",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 5,
  "items": [
    {
      "id": "393087",
      "url": "https://www.idxchannel.com/ecotainment/atur-jadwal-liburan-lebih-leluasa-dengan-layanan-paylater",
      "image": "https://img.idxchannel.com/media/439/images/idx/2026/08/20/Liburan_Lebih_Leluasa_dengan_Layanan_Paylater.png",
      "title": "Atur Jadwal Liburan Lebih Leluasa dengan Layanan Paylater",
      "source": "idxchannel.com",
      "summary": "Atur Jadwal Liburan Lebih Leluasa dengan Layanan Paylater. (Foto: iNews Media Group)",
      "category": "ECOTAINMENT",
      "publishedAt": "2026-08-20T11:23:00.000Z"
    },
    {
      "id": "393086",
      "url": "https://www.idxchannel.com/news/1378-sekolah-terdampak-gempa-m77-di-ntt-pembelajaran-116328-murid-terganggu",
      "image": "https://img.idxchannel.com/media/439/images/idx/2026/08/20/Screen_Shot_2026-08-20_at_16_46_44.jpg",
      "title": "1.378 Sekolah Terdampak Gempa M7,7 di NTT, Pembelajaran 116.328 Murid Terganggu",
      "source": "idxchannel.com",
      "summary": "1.378 Sekolah Terdampak Gempa M7,7 di NTT, Pembelajaran 116.328 Murid Terganggu. (Foto: iNews Media Group)",
      "category": "News",
      "publishedAt": "2026-08-20T11:18:00.000Z"
    },
    {
      "id": "393085",
      "url": "https://www.idxchannel.com/market-news/yupi-tebar-dividen-interim-senilai-rp145-miliar-dibayar-september-2026",
      "image": "https://img.idxchannel.com/media/439/images/idx/2025/05/11/yuppy_yupi.jpg",
      "title": "YUPI Tebar Dividen Interim Senilai Rp145 Miliar, Dibayar September 2026",
      "source": "idxchannel.com",
      "summary": "PT Yupi Indo Jelly Gum Tbk (YUPI) mengumumkan pembagian dividen interim untuk tahun buku 2026 sebesar Rp145,36 miliar. (Foto: Ist)",
      "category": "MARKET NEWS",
      "publishedAt": "2026-08-20T11:06:00.000Z"
    },
    {
      "id": "393084",
      "url": "https://www.idxchannel.com/news/gempa-susulan-masih-guncang-ntt-pengungsi-tembus-92735-orang",
      "image": "https://img.idxchannel.com/media/439/images/idx/2026/08/20/pengungsi_gempa_NTT.png",
      "title": "Gempa Susulan Masih Guncang NTT, Pengungsi Tembus 92.735 Orang",
      "source": "idxchannel.com",
      "summary": "Gempa Susulan Masih Guncang NTT, Pengungsi Tembus 92.735 Orang. (Foto Tangkapan Layar)",
      "category": "News",
      "publishedAt": "2026-08-20T10:45:00.000Z"
    },
    {
      "id": "393082",
      "url": "https://www.idxchannel.com/economics/alih-status-status-guru-pppk-paruh-waktu-jadi-penuh-waktu-butuh-anggaran-rp31-triliun",
      "image": "https://img.idxchannel.com/media/439/images/idx/2026/06/03/purbaya_anggie.jpeg",
      "title": "Alih Status Status Guru PPPK Paruh Waktu Jadi Penuh Waktu Butuh Anggaran Rp31 Triliun",
      "source": "idxchannel.com",
      "summary": "Alih Status Status Guru PPPK Paruh Waktu Jadi Penuh Waktu Butuh Anggaran Rp31 Triliun. (Foto iNews Media Group)",
      "category": "ECONOMICS",
      "publishedAt": "2026-08-20T10:20:00.000Z"
    }
  ],
  "dataset": "feed",
  "provider": "idxchannel"
}
```

---

### Channel Feed

Per-channel syndication feed with a wider image rendition.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/syndication`
- **Cache TTL:** 120s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `channel` | enum(market-news|economics|banking|syariah|ecotainment|milenomic|inspirator|economia|news|technology|idxtainment|the-founder|video|foto|idxc-live) | query | yes | Syndication channel |
| `limit` | number | query | no | Maximum items to return. Default 10 |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/syndication?channel=market-news&limit=10" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/syndication?channel=market-news&limit=10", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/syndication?channel=market-news&limit=10",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "count": 5,
  "items": [
    {
      "url": "https://www.idxchannel.com/video-1/easy-ksei-hadir-kini-ikut-rups-bisa-secara-online",
      "image": "https://img.idxchannel.com/media/439/images/idx/2022/06/21/easy_case.jpg",
      "title": "EASY KSEI HADIR, KINI IKUT RUPS BISA SECARA ONLINE",
      "source": "idxchannel.com",
      "summary": "EASY KSEI HADIR, KINI IKUT RUPS BISA SECARA ONLINE.(SUMBER: IDX CHANNEL)",
      "category": "VIDEO",
      "publishedAt": "2022-06-21T07:28:00.000Z"
    },
    {
      "url": "https://www.idxchannel.com/video-1/mendag-pergi-sidak-kepasar",
      "image": "https://img.idxchannel.com/media/439/images/idx/2022/06/20/maxresdefault.jpg",
      "title": "MENDAG PERGI SIDAK KEPASAR",
      "source": "idxchannel.com",
      "summary": "MENDAG PERGI SIDAK KEPASAR, (SUMBER: IDX CHANNEL)",
      "category": "VIDEO",
      "publishedAt": "2022-06-16T11:34:00.000Z"
    },
    {
      "url": "https://www.idxchannel.com/video-1/melirik-potensi-bisnis-harum-energy-di-2022",
      "image": "https://img.idxchannel.com/media/439/images/idx/2022/04/25/MELIRIK_POTENSI_BISNIS_HARUM_ENERGY_DI_2022.JPG",
      "title": "MELIRIK POTENSI BISNIS HARUM ENERGY DI 2022",
      "source": "idxchannel.com",
      "summary": "MELIRIK POTENSI BISNIS HARUM ENERGY DI 2022 (SUMBER-IDX CHANNEL)",
      "category": "VIDEO",
      "publishedAt": "2022-04-25T04:49:00.000Z"
    },
    {
      "url": "https://www.idxchannel.com/video-1/naik-lima-kali-lipat-kasus-covid-19-naik-menjadi-5454-kasus",
      "image": "https://img.idxchannel.com/media/439/images/idx/Multimedia/2022/01/21/WhatsApp_Image_2022-01-21_at_16_50_07.jpeg",
      "title": "Naik Lima Kali Lipat, Kasus Covid-19 Naik Menjadi 5.454 Kasus",
      "source": "idxchannel.com",
      "summary": "Naik Lima Kali Lipat, Kasus Covid-19 Naik Menjadi 5.454 Kasus",
      "category": "VIDEO",
      "publishedAt": "2022-01-21T15:32:00.000Z"
    },
    {
      "url": "https://www.idxchannel.com/video-1/waspada-pinjol-ilegal-simak-perbedaan-pinjol-legal-dan-ilegal",
      "image": "https://img.idxchannel.com/media/439/images/idx/Multimedia/2022/01/20/WhatsApp_Image_2022-01-20_at_13_10_49__1_.jpeg",
      "title": "Waspada Pinjol Ilegal! Simak Perbedaan Pinjol Legal dan Ilegal",
      "source": "idxchannel.com",
      "summary": "Waspada Pinjol Ilegal! Simak Perbedaan Pinjol Legal dan Ilegal",
      "category": "VIDEO",
      "publishedAt": "2022-01-20T08:32:00.000Z"
    }
  ],
  "channel": "video",
  "dataset": "syndication",
  "provider": "idxchannel"
}
```

---

### Article Detail

One article with body text, tags and editorial credits.

- **Method:** `GET`
- **Endpoint:** `https://api.zpi.web.id/v1/finance:idxchannel/detail`
- **Cache TTL:** 3600s

**Parameters:**

| Name | Type | Location | Required | Description |
|------|------|----------|----------|-------------|
| `url` | string | query | yes | Full article URL |

**cURL:**
```bash
curl "https://api.zpi.web.id/v1/finance:idxchannel/detail?url=https%3A%2F%2Fwww.idxchannel.com%2Fmarket-news%2Fbbca-kucurkan-dividen-interim-rp307-triliun-kuartal-iii-2026" \
  -H "x-api-key: YOUR_API_KEY"
```

**JavaScript / TypeScript:**
```javascript
const res = await fetch("https://api.zpi.web.id/v1/finance:idxchannel/detail?url=https%3A%2F%2Fwww.idxchannel.com%2Fmarket-news%2Fbbca-kucurkan-dividen-interim-rp307-triliun-kuartal-iii-2026", {
  headers: { "x-api-key": process.env.ZAPI_KEY }
});
const data = await res.json();
```

**Python:**
```python
import requests
r = requests.get("https://api.zpi.web.id/v1/finance:idxchannel/detail?url=https%3A%2F%2Fwww.idxchannel.com%2Fmarket-news%2Fbbca-kucurkan-dividen-interim-rp307-triliun-kuartal-iii-2026",
  headers={"x-api-key": "YOUR_API_KEY"})
data = r.json()
```

**Example response:**
```json
{
  "url": "https://www.idxchannel.com/market-news/bbca-kucurkan-dividen-interim-rp307-triliun-kuartal-iii-2026",
  "tags": [
    "BBCA",
    "Dividen Interim",
    "BCA",
    "dividen bbca"
  ],
  "image": "https://img.idxchannel.com/media/700/images/idx/2024/07/26/BBCA_-_BCA_gedung_-_freepik.jpg",
  "title": "BBCA Kucurkan Dividen Interim Rp3,07 Triliun Kuartal III-2026",
  "author": "Anggie Ariesta",
  "source": "idxchannel.com",
  "content": "IDXChannel – PT Bank Central Asia Tbk (BBCA) menggelontorkan dana sebesar Rp3,07 triliun untuk pembagian dividen interim kuartal III-2026. Aksi korporasi ini merupakan bagian dari rencana perseroan untuk membagikan dividen interim sebanyak tiga kali secara berkala pada tahun buku 2026.\n\nPembagian kali ini menjadi termin kedua, setelah dividen interim kuartal II-2026 direalisasikan pada 26 Juni 2026. Kebijakan tersebut mengacu pada keputusan Rapat Umum Pemegang Saham Tahunan (RUPST) pada 12 Maret 2026 yang mengizinkan Direksi dan Dewan Komisaris membagikan dividen per kuartal sesuai kondisi keuangan perseroan.\n\nPresiden Direktur BCA Hendra Lembong mengatakan, besaran nilai dividen interim tersebut telah memperhitungkan ketahanan modal, kecukupan likuiditas, ekspansi entitas anak, serta kualitas aset bank yang tetap terjaga.\n\n“Kami bersyukur dapat kembali menjalankan komitmen untuk membagikan dividen interim lebih dari satu kali pada tahun buku 2026. Nilai dividen interim yang lebih tinggi dari kuartal sebelumnya merupakan cerminan kinerja solid Perseroan pada semester I 2026. Terobosan ini diharapkan dapat menjadi hadiah bagi investor, bertepatan dengan bulan Kemerdekaan Republik Indonesia,” ujar Hendra dalam keterangan resmi, Rabu (19/8/2026).",
  "dataset": "article",
  "editors": [
    {
      "url": "https://www.idxchannel.com/author/anggie-ariesta",
      "name": "Anggie Ariesta",
      "role": "Reporter"
    },
    {
      "url": "https://www.idxchannel.com/author/dhera-arizona-pratiwi-editor",
      "name": "Dhera Arizona Pratiwi",
      "role": "Editor"
    }
  ],
  "summary": "PT Bank Central Asia Tbk (BBCA) menggelontorkan dana sebesar Rp3,07 triliun untuk pembagian dividen interim kuartal III-2026.",
  "category": "Market news",
  "provider": "idxchannel",
  "updatedAt": "2026-08-19T21:04:00.000Z",
  "wordCount": 169,
  "publishedAt": "2026-08-19T21:04:00.000Z"
}
```

---


_Generated: 2026-08-20T18:33:15.465Z_