News & Editorial Layer API (Sandbox)

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

Success

get/api/v1.1/news/earning-reports
 
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

Success

* Additional properties are NOT allowed.
articleTypeIDinteger(int32)
nameArstring | null
nameEnstring | null
argaamIDinteger | null(int32)
usedInChartboolean
get/api/v1.1/news/article-types
 
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

Success

* Additional properties are NOT allowed.
articleSourceIDinteger(int32)
articleSourceNamestring | null
languageIDinteger(int32)
parentArticleSourceIDinteger | null(int32)
isActiveForStatisticboolean
get/api/v1.1/news/article-sources
 
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

Success

get/api/v1.1/news/analytics/comments/{entityTypeId}/{recordId}
 
200

ArticleAMP

object
* Additional properties are NOT allowed.
includeCSSboolean
ampReadyBodystringread-only
customAMPCssstringread-only
Example