GET /api/v1.1/news/markets/1/sections/3?lang=1&orderBy=publish-date
Language id: 1 = ar, 2 = en. Defaults to 1.
Default:1
Example:2
Page number. Default: 1. Defaults to 1.
Default:1
Example:1
Records per page. Default: 30. Defaults to 30.
Default:30
Example:20
Optional free-text filter.
Optional sort key (e.g., publish-date, popularity).
Market ID (e.g., 1).
Example:3
Section ID.
Success
Variant of /markets/{marketId}/sections/{sectionId} that
returns the un-filtered superset.
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:1
Example:2
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:30
Example:20
Free-text search term.
Field name to sort the result set by.
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
News section identifier used to group articles (e.g. announcements, analysis).
Success
Returns articles that mention listed companies, with each
article including the symbols referenced inside the body.
Use for NLP / sentiment-tagging pipelines.
GET /api/v1.1/news/articles/with-symbols?lang=2&from=2024-01-01&to=2024-01-31&marketId=1
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:1
Example:1
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
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values. Defaults to 3.
Default:3
Example:3
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:30
Example:20
Success
Curated headline list designed for the Argaam home page or
any landing-page widget. Optionally filter by stock symbol.
GET /api/v1.1/news/home?sectionId=2&marketId=1&languageId=1&stockSymbol=2222
News section identifier used to group articles (e.g. announcements, analysis).
Example:26
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values. Defaults to 3.
Default:3
Example:3
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:1
Example:2
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Default:
Example:2222
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:30
Example:20
Success
Calendar-driven listing: combines arbitrary date range with
optional company / paging.
GET /api/v1.1/news/articles/by-date?languageId=2&from=2024-01-01&to=2024-01-31&stockSymbol=2222&page=1&pageSize=50
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Example:2
Start of the date range, inclusive. Format YYYY-MM-DD.
Default:
Example:2024-01-01
End of the date range, inclusive. Format YYYY-MM-DD.
Default:
Example:2024-03-31
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Default:
Example:2222
1-based page number. Defaults to 1.
Default:0
Example:1
Number of records per page. Defaults to the endpoint’s standard page size; large values are capped server-side.
Default:0
Example:20
Success