Get Argaam editorial articles related to a company.
Returns a list of Argaam-published articles about the company,
filtered by category.
Category values
| Value | Description |
|---|---|
News |
Latest news items |
Analysis |
In-depth analyst commentary |
Report |
Formal research reports |
Each article record contains a title (Arabic + English), publication
timestamp, and a direct URL to the article page on argaam.com.
Query Parameters
Path Parameters
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Example:2222
Response
200 application/json
Response
Success
ApiV1Response
Show Child Parameters
Show Child Parameters
Authentication
Path Parameters
Query Parameters
Get the corporate event calendar for a market.
Returns upcoming and recently completed corporate events for all
companies in the specified market, including:
- Annual / Extraordinary General Meetings (AGM / EGM)
- Dividend announcements and payment dates
- Earnings releases and financial results
- Investor-day and conference dates
Events are returned in reverse-chronological order (newest first).
Tip: For a single company’s events use
GET /companies/{companyId}/events.
Path Parameters
Market ID (e.g. 1 for Saudi Tadawul).
Example:3
Response
200 application/json
Response
Success
ApiV1Response
Show Child Parameters
Show Child Parameters
Authentication
Path Parameters
List articles published in a date range, paged.
Returns the firehose of Argaam articles for the requested time
window. Use this endpoint for chronological feeds such as a
news sidebar or mobile timeline.
Example
GET /api/v1.1/news/articles?from=2024-01-01&to=2024-01-31&lang=en&page=1&pageSize=50
Tips
- Both dates accept ISO-8601 (
2024-01-31) or any
M:System.DateTime.Parse(System.String)-compatible format. - Defaults:
from = yesterday,to = now,lang = ar,
pageSize = 200(max).
Query Parameters
Start timestamp (inclusive). Defaults to yesterday.
Example:2024-01-01
End timestamp (inclusive). Defaults to now.
Example:2024-03-31
Article language. Allowed: ar, en. Default: ar. Defaults to ar.
Default:ar
Example:1
1-based page number. Default: 1. Defaults to 1.
Default:1
Example:1
Records per page. Max: 200. Default: 200. Defaults to 200.
Default:200
Example:20
Response
200 application/json
Response
Success
Authentication
Query Parameters
List popular articles
Returns the popular articles available on this layer.
Set lang to 1 for English or 2 for Arabic.
Query Parameters
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:ar
Example:1
Response
200 application/json
Response
Success
Authentication
Query Parameters
Get the market pulse feed
Returns the curated short-form market pulse feed: the headline items Argaam’s editorial desk considers market-moving right now, newest first.
Paginated: use page and pageSize. Bound the result with the from and to date parameters. Set lang to 1 for English or 2 for Arabic.
Query Parameters
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
Start of the date range, inclusive. Format YYYY-MM-DD.
Example:2024-01-01
End of the date range, inclusive. Format YYYY-MM-DD.
Example:2024-03-31
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:ar
Example:1
1-based page number. Defaults to 1.
Default:1
Example:1
Number of records per page. Defaults to the endpoint’s standard page size; large values are capped server-side.
Default:10
Example:20
Response
200 application/json
Response
Success