News & Editorial Layer API (Production)

News & Editorial Layer API

v1.1OAS 3.0

Argaam’s editorial feed: company and market news, full articles with AMP rendering, the market-pulse feed, earnings reports, calendar events, and article types and sources.

API Base URL
  • Server 1:https://api.argaam.com

    Argaam API Gateway (Production)

Security
ApiKeyAuth (apiKey)

An API key is a token that you provide when making API calls. Include the token in a header parameter called apikey.

Example: apikey: 123

ApiKeyAuthQuery (apiKey)

An API key is a token that you provide when making API calls. Include the token in a query parameter called apikey.

Example: ?apikey=123

Additional Information

Get calendar events for a company

Returns the calendar events for the company identified by stockSymbol.

get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/events

Query Parameters

typestring

Result type filter.

Example:[ "" ]

Path Parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example:2222

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/events
 
200 application/json

Get Argaam editorial articles related to a company.

Returns a list of Argaam-published articles about the company,
filtered by category.

Category values

Value Description
News Latest news items
Analysis In-depth analyst commentary
Report Formal research reports

Each article record contains a title (Arabic + English), publication
timestamp, and a direct URL to the article page on argaam.com.

get
https://api.argaam.com/api/v1.1/companies/{stockSymbol}/articles

Query Parameters

Path Parameters

stockSymbolstringrequired

Tadawul stock symbol of the company, e.g. 2222 (Saudi Aramco).

Example:2222

Response

200 application/json

Success

ApiV1Response

* Additional properties are NOT allowed.
successboolean
apiVersionstring | null
timestampstring(date-time)
requestIdstring | null
data
metaobject
* Additional properties are NOT allowed.
Show Child Parameters
rateLimitobject
* Additional properties are NOT allowed.
Show Child Parameters
get/api/v1.1/companies/{stockSymbol}/articles
 
200 application/json