qnb.com APIqnb.com ↗
Access QNB financial results, share data, annual reports, investor presentations, and regulatory announcements via 9 structured endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/5341cdac-90c6-4b5a-9c93-5f78ae4cc9cd/get_quarterly_results_listing' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns a list of all available quarterly financial result documents with their titles, years, quarters, and PDF document URLs from the QNB investor relations page.
No input parameters required.
{
"type": "object",
"fields": {
"documents": "array of objects with title, url, year (string or null), and quarter (string or null)"
},
"sample": {
"data": {
"documents": [
{
"url": "https://qnb.com/sites/qnb/qnbqatar/document/en/FinancialResultsQ12026",
"year": "2026",
"title": "Financial Results for the Q1 2026",
"quarter": "Q1"
},
{
"url": "https://qnb.com/sites/qnb/qnbqatar/document/en/FinancialResultsQ42025",
"year": "2025",
"title": "Financial statements for the year ended 2025",
"quarter": null
}
]
},
"status": "success"
}
}About the qnb.com API
The QNB API covers 9 endpoints that expose Qatar National Bank's investor relations data, including quarterly and annual financial documents, structured income statement and balance sheet figures, share market metrics, and regulatory announcements. The get_financial_data endpoint lets you pull structured tables across income, balance sheet, key ratios, and segment breakdowns for both annual and quarterly periods, while get_share_information returns live trading metrics such as last price, volume, and market cap.
Financial Statements and Reports
Two document-listing endpoints cover QNB's published filings: get_quarterly_results_listing returns an array of objects each containing a title, url, year, and quarter for every available quarterly result PDF, while get_annual_reports_listing returns a similar array scoped to full-year reports. Both endpoints require no inputs and return direct PDF URLs alongside parsed year metadata. For structured numeric data, get_financial_data accepts optional period_type (annual or quarterly) and statement_type (income, balance, ratios, or segments) parameters and returns a table array where each row represents one period with metric values as keyed fields.
Aggregated Quarterly Analysis
get_12_quarter_summary goes further by aggregating quarterly income statement data and computing quarter-over-quarter percentage change fields alongside raw metric values. The response includes a note field that describes the data source context, and each object in the data array carries a period label, the metric values, and the derived QoQ% change fields — useful for quickly spotting trend inflections without post-processing.
Share Data, Calendar, and IR Documents
get_share_information returns a flat share_data object with key-value pairs covering trading metrics including last price, volume, and market cap. get_financial_calendar returns an events array where each event carries id, title, date, month, year, and an is_highlighted boolean that distinguishes featured events. For IR documents, get_investor_presentations and get_ir_call_transcripts each return arrays with title and url fields pointing to PDF downloads.
Regulatory Announcements
get_regulatory_announcements lists QSE disclosures and regulatory filings as an array of objects with title and url. These announcements cover material disclosures published to the Qatar Stock Exchange and provide a structured way to monitor compliance-related communications without manually checking the investor relations page.
- Build a QNB earnings tracker by polling
get_quarterly_results_listingto detect newly published quarterly result PDFs. - Construct a multi-period financial model using
get_financial_datawithstatement_type=balanceandstatement_type=incomeacross annual periods. - Generate automated QoQ trend reports using the percentage change fields returned by
get_12_quarter_summary. - Monitor upcoming dividend announcements and results dates by consuming
get_financial_calendarevents filtered byis_highlighted. - Aggregate QNB's QSE regulatory filings into a compliance dashboard using
get_regulatory_announcements. - Track intraday share performance metrics such as volume and market cap via
get_share_information. - Compile a document library of earnings call transcripts and investor presentations using
get_ir_call_transcriptsandget_investor_presentations.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does QNB have an official public developer API?+
What does `get_financial_data` return and how do I select a specific statement?+
get_financial_data accepts two optional parameters: period_type (annual or quarterly) and statement_type (income, balance, ratios, or segments). The response contains a table array where each element represents one period, with the period label and all available metric values as key-value pairs. If no parameters are supplied, the endpoint returns a default combination. The period_type and statement_type fields in the response confirm which combination was used.How are quarterly results different from the 12-quarter summary?+
get_quarterly_results_listing returns document metadata (title, URL, year, quarter) for PDF filings — it does not contain numeric financial figures. get_12_quarter_summary returns structured numeric data with pre-computed quarter-over-quarter percentage change fields, making it better suited for trend analysis without additional calculation.Does the API cover historical share price time series data?+
get_share_information returns a snapshot of current trading metrics such as last price, volume, and market cap, but does not expose historical OHLCV series or price history. You can fork this API on Parse and revise it to add an endpoint targeting QNB's historical price data.