QNB APIqnb.com ↗
Access QNB financial results, share data, annual reports, investor presentations, and regulatory announcements via 9 structured endpoints.
What is the QNB 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.
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'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace qnb-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.qnb_investor_relations_api import QNB, PeriodType, StatementType
qnb = QNB(api_key="YOUR_API_KEY")
# List quarterly financial results
for result in qnb.quarterlyresults.list():
print(result.title, result.year, result.quarter)
# Get current share information
share = qnb.shareinfos.get()
print(share.symbol, share.last, share.market_cap)
# Query financial data with enum parameters
stmt = qnb.financialstatements.query(
period_type=PeriodType.QUARTERLY,
statement_type=StatementType.INCOME
)
print(stmt.period_type, stmt.statement_type)
# Get quarterly summary with QoQ changes
summary = qnb.financialstatements.quarterly_summary()
print(summary.period_type, summary.statement_type)
# List annual reports
for report in qnb.annualreports.list():
print(report.title, report.year, report.url)
# List investor presentations
for pres in qnb.presentations.list():
print(pres.title, pres.url)
Returns all available quarterly financial result documents from QNB investor relations. Each document includes title, PDF URL, extracted year, and quarter identifier. Documents are ordered as they appear on the page (newest first).
No input parameters required.
{
"type": "object",
"fields": {
"documents": "array of objects with title (string), url (string), 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 API
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.
The QNB API is a managed, monitored endpoint for qnb.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when qnb.com 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 qnb.com 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 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 | 100 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.