languageIdinteger(int32)
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:1
Example:2
Article details by id and language id (legacy lookup).
Convenience overload that takes numeric languageId (1 = Arabic,
2 = English) instead of the lang string code. Provided for
backwards compatibility with v1.0 clients.
Example
GET /api/v1.1/news/articles/by-id/12345?languageId=2
get
https://api-sandbox.argaam.com/api/v1.1/news/articles/by-id/{articleId}
Query Parameters
Path Parameters
articleIdinteger(int32)required
Identifier of the news article.
Response
200
Response
200
Success
get/api/v1.1/news/articles/by-id/{articleId}
Authentication
Path Parameters
Query Parameters
200
Articles tagged to a specific company section.
Sections are the editorial categories Argaam maintains per
company (e.g., disclosures, analyst estimates, financial reports).
Example
GET /api/v1.1/news/companies/2222/sections/26?lang=1&page=1&pageSize=10
get
https://api-sandbox.argaam.com/api/v1.1/news/companies/{symbol}/sections/{sectionId}
Query Parameters
languageIdinteger(int32)
Numeric language id: 1 = ar, 2 = en. Defaults to 1.
Default:1
Example:2
pageinteger(int32)
Page number. Default: 1. Defaults to 1.
Default:1
Example:1
pageSizeinteger(int32)
Records per page. Default: 10. Defaults to 10.
Default:10
Example:20
Path Parameters
symbolstringrequired
Stock symbol (e.g., 2222).
sectionIdinteger(int32)required
Editorial section ID.
Response
200
Response
200
Success
get/api/v1.1/news/companies/{symbol}/sections/{sectionId}
Authentication
Path Parameters
Query Parameters
200
Articles tagged to a specific market section.
Example
GET /api/v1.1/news/markets/1/sections/3?lang=1&orderBy=publish-date
get
https://api-sandbox.argaam.com/api/v1.1/news/markets/{marketId}/sections/{sectionId}
Query Parameters
languageIdinteger(int32)
Language id: 1 = ar, 2 = en. Defaults to 1.
Default:1
Example:2
pageinteger(int32)
Page number. Default: 1. Defaults to 1.
Default:1
Example:1
pageSizeinteger(int32)
Records per page. Default: 30. Defaults to 30.
Default:30
Example:20
searchTextstring
Optional free-text filter.
orderBystring
Optional sort key (e.g., publish-date, popularity).
Path Parameters
marketIdinteger(int32)required
Market ID (e.g., 1).
Example:3
sectionIdinteger(int32)required
Section ID.
Response
200
Response
200
Success
get/api/v1.1/news/markets/{marketId}/sections/{sectionId}
Authentication
Path Parameters
Query Parameters
200
All articles for a market section (no section pre-filter).
Variant of /markets/{marketId}/sections/{sectionId} that
returns the un-filtered superset.
get
https://api-sandbox.argaam.com/api/v1.1/news/markets/{marketId}/sections/{sectionId}/all
Query Parameters
languageIdinteger(int32)
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:1
Example:2
pageinteger(int32)
1-based page number. Defaults to 1.
Default:1
Example:1
pageSizeinteger(int32)
Number of records per page. Defaults to the endpoint’s standard page size; large values are capped server-side.
Default:30
Example:20
searchTextstring
Free-text search term.
orderBystring
Field name to sort the result set by.
Path Parameters
marketIdinteger(int32)required
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Example:3
sectionIdinteger(int32)required
News section identifier used to group articles (e.g. announcements, analysis).
Response
200
Response
200
Success
get/api/v1.1/news/markets/{marketId}/sections/{sectionId}/all
Authentication
Path Parameters
Query Parameters
200
Articles enriched with stock-symbol references for the period.
Returns articles that mention listed companies, with each
article including the symbols referenced inside the body.
Use for NLP / sentiment-tagging pipelines.
Example
GET /api/v1.1/news/articles/with-symbols?lang=2&from=2024-01-01&to=2024-01-31&marketId=1
get
https://api-sandbox.argaam.com/api/v1.1/news/articles/with-symbols
Query Parameters
langinteger(int32)
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:1
Example:1
fromstring
Start of the date range, inclusive. Format YYYY-MM-DD.
Example:2024-01-01
tostring
End of the date range, inclusive. Format YYYY-MM-DD.
Example:2024-03-31
marketIdinteger(int32)
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
pageinteger(int32)
1-based page number. Defaults to 1.
Default:1
Example:1
pageSizeinteger(int32)
Number of records per page. Defaults to the endpoint’s standard page size; large values are capped server-side.
Default:30
Example:20
Response
200
Response
200
Success
get/api/v1.1/news/articles/with-symbols
Authentication
Query Parameters
200