Co APIidx.co.id ↗
Access IDX stock listings, daily trading summaries, company profiles, financial reports, IPO data, indices, and corporate announcements via a single API.
What is the Co API?
The IDX API covers 13 endpoints that expose data from the Indonesia Stock Exchange (idx.co.id), including full stock listings with listing-board filters, daily trading summaries with OHLC and volume, IHSG and 30+ sector indices, detailed company profiles with directors and shareholders, financial report attachments, IPO records, and corporate announcements. The get_company_profile endpoint alone returns dividends, commissioners, subsidiaries, and major shareholder percentages for any listed ticker.
curl -X GET 'https://api.parse.bot/scraper/3344e652-0a91-4a3c-96f6-d64b4d7f7369/get_stock_list?board=Utama' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the complete list of stocks listed on IDX. Returns stock codes, names, listing dates, share counts, and listing boards. Supports filtering by listing board. Returns all results in a single response.
| Param | Type | Description |
|---|---|---|
| board | string | Filter by listing board. |
{
"type": "object",
"fields": {
"data": "array of stock objects with Code, Name, ListingDate, Shares, ListingBoard",
"recordsTotal": "integer total number of matching stocks"
},
"sample": {
"data": {
"data": [
{
"Code": "AALI",
"Name": "Astra Agro Lestari Tbk.",
"Shares": 1924688333,
"ListingDate": "1997-12-09T00:00:00",
"ListingBoard": "Utama"
}
],
"draw": 0,
"recordsTotal": 957,
"recordsFiltered": 957
},
"status": "success"
}
}About the Co API
Stock and Market Data
The get_stock_list endpoint returns every IDX-listed security with fields including Code, Name, ListingDate, Shares, and ListingBoard. It accepts an optional board parameter to narrow results to a specific listing board. For price action, get_stock_summary delivers daily Close, High, Low, Volume, Value, Frequency, and Change for all active tickers and supports offset-based pagination via start and limit. Market-wide index data — including IHSG (COMPOSITE) and all sector indices — comes from get_market_index_summary, which returns IndexCode, PrevVal, LastVal, ChgVal, and ChgPct for 30+ indices in one request.
Company Profiles and Filings
get_company_profiles_list pages through all listed companies with sector, sub-sector, industry classification, and listing date fields. Drilling into a single ticker with get_company_profile adds structured arrays for Direktur (directors), Komisaris (commissioners with an Independen flag), PemegangSaham (shareholders with Jumlah and Persentase), AnakPerusahaan (subsidiaries with ownership percentage and location), and Dividen (historical cash dividends per share with cum and payment dates). Financial and annual report filings are accessible through get_financial_reports, which accepts stock_code, year, period, report_type, and a date_from/date_to range; each result includes an Attachments array with file metadata.
Corporate Events, Announcements, and IPOs
get_company_calendar returns RUPS (shareholder meetings), dividend events, and other corporate actions for a given month or day using a date parameter in YYYYMMDD format. get_company_announcements supports free-text query search (e.g. dividen, RUPS) and filtering by kode_emiten; each result wraps a pengumuman object alongside PDF attachment URLs. IPO and relisting activity is available through get_ipo_information, returning KodeEmiten, NamaEmiten, TanggalPencatatan, and SahamIPOValue ordered by most recent listing date. Right issue (HMETD) records are available via get_right_issues by year and month, including the subscription ratio parsed as rasioLama and rasioBaru, and execution price hargaPelaksanaan in IDR.
Additional Endpoints
get_trading_summary provides aggregate Volume, Value, and Frequency broken down by instrument type — Saham, ETF, Waran, DIRE, and Structured Warrant — for the most recent trading day. get_earnings_this_week identifies companies that submitted financial reports in the current week, falling back to the most recent submission date if none exist. get_ikhtisar_pasar returns IDX homepage content including banners and popup announcements.
The Co API is a managed, monitored endpoint for idx.co.id — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when idx.co.id changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official idx.co.id API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build an IDX stock screener filtering by listing board, sector, and daily price change using
get_stock_listandget_stock_summary. - Track IHSG and sector index movements throughout the trading day using
get_market_index_summary. - Aggregate shareholder structure and board composition data for listed companies using
get_company_profile. - Monitor corporate announcements and filter by keyword or ticker for event-driven trading signals using
get_company_announcements. - Pull annual report and financial statement attachment URLs for a given ticker and year using
get_financial_reports. - List recent IPOs and relistings with their board classification and share value using
get_ipo_information. - Identify right issue activity for a specific month, including subscription ratios and execution prices, using
get_right_issues.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does IDX (idx.co.id) have an official developer API?+
What does `get_company_profile` return beyond basic company info?+
stock_code, it returns arrays for directors (Direktur), commissioners (Komisaris with an Independen flag), major shareholders (PemegangSaham) with share counts and percentages, subsidiaries (AnakPerusahaan) with business lines and ownership stakes, and historical cash dividends (Dividen) with cum dates and payment dates.How does pagination work across these endpoints?+
get_stock_summary, get_company_profiles_list, get_financial_reports, get_company_announcements, and get_ipo_information — use offset-based pagination via start (starting index) and limit (page size) parameters. get_right_issues uses a 1-based page parameter alongside month and year. The recordsTotal or ResultCount field in each response indicates the total number of matching records.Does the API expose real-time intraday tick or order book data?+
get_stock_summary and index values via get_market_index_summary, but intraday tick data, bid/ask spreads, and order book depth are not included. You can fork this API on Parse and revise it to add an endpoint targeting intraday data if IDX exposes it.Are historical daily price series available for individual stocks?+
get_stock_summary returns the most recent trading day's data for all listed stocks, and there is no endpoint for retrieving a time series of historical OHLCV data per ticker. You can fork this API on Parse and revise it to add a historical prices endpoint.