News & Editorial Layer API (Production)

News & Editorial Layer API

Article source registry (publishers, agencies).

Returns the list of upstream sources Argaam aggregates from.
Useful when displaying article attribution.

get
https://api.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.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

ArticleDetails

object
* Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
languagestringread-only
titlestring
bodystring
shortURLstring
publishedOnstring
articleSourceNamestring
articleTypestringread-only
articleTypeNameArstring
articleTypeNameEnstring
marketTickerIDsstring
marketTickerChartIDsarray[string]read-only
companyTickerIDsstring
companyTickerChartIDsarray[string]read-only
customAMPCssstring
Example

Article

object
* Additional properties are NOT allowed.
articleIDinteger(int32)
languageIDinteger(int32)
languagestringread-only
titlestring
publishedOnstring
linkstringread-only
isLinkedboolean
linkedToURLstring
isPaidboolean
articleSourceNamestring
sourcestring
articleTypestringread-only
articleTypeNameArstring
articleTypeNameEnstring
marketTickerIDsstring
marketTickerChartIDsarray[string]read-only
companyTickerIDsstring
companyTickerChartIDsarray[string]read-only
bodystring
showDetailsboolean
iconURLstring
Example