News & Editorial Layer API (Production)
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.
get
https://api.argaam.com/api/v1.1/news/market-pulse
Query Parameters
marketIdinteger(int32)
Numeric market identifier (e.g. 1 = Tadawul / Saudi main market). Use GET /api/v1.1/markets to list valid values.
Default:3
Example:3
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
langstring
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:ar
Example:1
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:10
Example:20
Response
200 application/json
Response
200 application/json
Success
* Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
titlestring | null
bodystring | null
sourcestring | null
isLinkedboolean
linkedToURLstring | null
isLockedboolean
displayTimestring(date-time)
get/api/v1.1/news/market-pulse
Authentication
Query Parameters
200 application/json
Get a article by articleId
Returns the article identified by articleId.
Set lang to 1 for English or 2 for Arabic.
get
https://api.argaam.com/api/v1.1/news/articles/{articleId}
Query Parameters
langstring
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:ar
Example:1
styledboolean
When true, returns values pre-formatted for display (thousands separators, currency suffixes) instead of raw numbers. Defaults to True.
Default:true
Example:true
Path Parameters
articleIdinteger(int32)required
Identifier of the news article.
Response
200 application/json
Response
200 application/json
Success
ArticleDetails
* Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
languagestring | nullread-only
titlestring | null
bodystring | null
shortURLstring | null
publishedOnstring | null
articleSourceNamestring | null
articleTypestring | nullread-only
articleTypeNameArstring | null
articleTypeNameEnstring | null
marketTickerIDsstring | null
marketTickerChartIDsarray | null[string]read-only
companyTickerIDsstring | null
companyTickerChartIDsarray | null[string]read-only
customAMPCssstring | null
get/api/v1.1/news/articles/{articleId}
Authentication
Path Parameters
Query Parameters
200 application/json
Article body in AMP-compliant HTML.
AMP (Accelerated Mobile Pages) variant for high-performance
mobile rendering and SEO ranking.
Example
GET /api/v1.1/news/articles/12345/amp?lang=en
get
https://api.argaam.com/api/v1.1/news/articles/{articleId}/amp
Query Parameters
langstring
Article language. Default: ar. Defaults to ar.
Default:ar
Example:1
Path Parameters
articleIdinteger(int32)required
Numeric article identifier.
Response
200 application/json
Response
200 application/json
Success
ArticleAMP
* Additional properties are NOT allowed.
includeCSSboolean
ampReadyBodystring | nullread-only
customAMPCssstring | nullread-only
get/api/v1.1/news/articles/{articleId}/amp
Authentication
Path Parameters
Query Parameters
200 application/json
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.argaam.com/api/v1.1/news/articles/by-id/{articleId}
Query Parameters
languageIdinteger(int32)
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Default:1
Example:2
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.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