News & Editorial Layer API (Sandbox)
Articles by date range with optional filters.
Calendar-driven listing: combines arbitrary date range with
optional company / paging.
Example
GET /api/v1.1/news/articles/by-date?languageId=2&from=2024-01-01&to=2024-01-31&stockSymbol=2222&page=1&pageSize=50
get
https://api-sandbox.argaam.com/api/v1.1/news/articles/by-date
Query Parameters
languageIdinteger(int32)
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Example:2
fromstring
Start of the date range, inclusive. Format YYYY-MM-DD.
Default:
Example:2024-01-01
tostring
End of the date range, inclusive. Format YYYY-MM-DD.
Default:
Example:2024-03-31
stockSymbolstring
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Default:
Example:2222
pageinteger(int32)
1-based page number. Defaults to 1.
Default:0
Example:1
pageSizeinteger(int32)
Number of records per page. Defaults to the endpoint’s standard page size; large values are capped server-side.
Default:0
Example:20
Response
200
Response
200
Success
get/api/v1.1/news/articles/by-date
Authentication
Query Parameters
200
List earnings reports
Returns the earnings reports available on this layer.
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-sandbox.argaam.com/api/v1.1/news/earning-reports
Query Parameters
languageIdinteger(int32)
Response language: 1 = English, 2 = Arabic. Defaults to 1.
Example:2
fromstring
Start of the date range, inclusive. Format YYYY-MM-DD.
Default:
Example:2024-01-01
tostring
End of the date range, inclusive. Format YYYY-MM-DD.
Default:
Example:2024-03-31
stockSymbolstring
Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).
Default:
Example:2222
pageinteger(int32)
1-based page number. Defaults to 1.
Default:0
Example:1
pageSizeinteger(int32)
Number of records per page. Defaults to the endpoint’s standard page size; large values are capped server-side.
Default:0
Example:20
Response
200
Response
200
Success
get/api/v1.1/news/earning-reports
Authentication
Query Parameters
200
Available article type taxonomies.
Article types group editorial content into broad categories
(news, analysis, press release, etc.). Use to build filter UIs.
get
https://api-sandbox.argaam.com/api/v1.1/news/article-types
Response
200 application/json
Response
200 application/json
Success
* Additional properties are NOT allowed.
articleTypeIDinteger(int32)
nameArstring | null
nameEnstring | null
argaamIDinteger | null(int32)
usedInChartboolean
get/api/v1.1/news/article-types
Authentication
200 application/json
Article source registry (publishers, agencies).
Returns the list of upstream sources Argaam aggregates from.
Useful when displaying article attribution.
get
https://api-sandbox.argaam.com/api/v1.1/news/article-sources
Query Parameters
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:200
Example:20
Response
200 application/json
Response
200 application/json
Success
* Additional properties are NOT allowed.
articleSourceIDinteger(int32)
articleSourceNamestring | null
languageIDinteger(int32)
parentArticleSourceIDinteger | null(int32)
isActiveForStatisticboolean
get/api/v1.1/news/article-sources
Authentication
Query Parameters
200 application/json
Aggregated comment / view analytics for an entity.
Returns view + comment counts. Drives reader-engagement
dashboards and trending-content rankings.
Example
GET /api/v1.1/news/analytics/comments/1/12345
get
https://api-sandbox.argaam.com/api/v1.1/news/analytics/comments/{entityTypeId}/{recordId}
Path Parameters
entityTypeIdinteger(int32)required
Type of entity the comments belong to (article, company, …).
recordIdinteger(int32)required
Identifier of the record within the given entityTypeId.
Response
200
Response
200
Success
get/api/v1.1/news/analytics/comments/{entityTypeId}/{recordId}
Authentication
Path Parameters
200