--- title: "News & Editorial Layer API" url: "https://developer.argaam.com/apis/news-editorial-layer-api-sandbox-v1/versions/56dc3378-a7ea-4bb0-a38f-84e9d50d974b" --- # News & Editorial Layer API OpenAPI specification document. ````json {"openapi":"3.0.1","info":{"title":"News & Editorial Layer API","description":"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.","contact":{"name":"Argaam IT","url":"https://www.argaam.com","email":"developer@argaam.com"},"version":"v1.1"},"paths":{"/api/v1.1/companies/{stockSymbol}/events":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"type","in":"query","schema":{"type":"string"},"example":"","description":"Result type filter."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get calendar events for a company","description":"Returns the calendar events for the company identified by `stockSymbol`.","operationId":"getCompaniesByStockSymbolEvents"}},"/api/v1.1/companies/{stockSymbol}/articles":{"get":{"tags":["Companies"],"parameters":[{"name":"stockSymbol","in":"path","required":true,"schema":{"type":"string"},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"category","in":"query","schema":{"$ref":"#/components/schemas/ArgaamPlus.Core.API.Controllers.V10.CompanyArticleCategory"},"example":"News","description":"Category filter."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get Argaam editorial articles related to a company.","description":"Returns a list of Argaam-published articles about the company,\r\nfiltered by category.\r\n \r\n**Category values**\r\n| Value | Description |\r\n|---|---|\r\n| `News` | Latest news items |\r\n| `Analysis` | In-depth analyst commentary |\r\n| `Report` | Formal research reports |\r\n \r\nEach article record contains a title (Arabic + English), publication\r\ntimestamp, and a direct URL to the article page on argaam.com.","operationId":"getCompaniesByStockSymbolArticles"}},"/api/v1.1/markets/{marketId}/events":{"get":{"tags":["Markets"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Market ID (e.g. `1` for Saudi Tadawul).","example":3}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiV1Response"}}}}},"summary":"Get the corporate event calendar for a market.","description":"Returns upcoming and recently completed corporate events for all\r\ncompanies in the specified market, including:\r\n \r\n- Annual / Extraordinary General Meetings (AGM / EGM)\r\n- Dividend announcements and payment dates\r\n- Earnings releases and financial results\r\n- Investor-day and conference dates\r\n \r\nEvents are returned in reverse-chronological order (newest first).\r\n \r\n**Tip:** For a single company's events use\r\n`GET /companies/{companyId}/events`.","operationId":"getMarketsByMarketIdEvents"}},"/api/v1.1/news/articles":{"get":{"tags":["News"],"parameters":[{"name":"from","in":"query","description":"Start timestamp (inclusive). Defaults to yesterday.","schema":{"type":"string"},"example":"2024-01-01"},{"name":"to","in":"query","description":"End timestamp (inclusive). Defaults to now.","schema":{"type":"string"},"example":"2024-03-31"},{"name":"lang","in":"query","description":"Article language. Allowed: `ar`, `en`. Default: `ar`. Defaults to `ar`.","schema":{"type":"string","default":"ar"},"example":1},{"name":"page","in":"query","description":"1-based page number. Default: `1`. Defaults to `1`.","schema":{"type":"integer","format":"int32","default":1},"example":1},{"name":"pageSize","in":"query","description":"Records per page. Max: `200`. Default: `200`. Defaults to `200`.","schema":{"type":"integer","format":"int32","default":200},"example":20}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Article"}}}}}},"summary":"List articles published in a date range, paged.","description":"Returns the firehose of Argaam articles for the requested time\r\nwindow. Use this endpoint for **chronological feeds** such as a\r\nnews sidebar or mobile timeline.\r\n \r\n### Example\r\n```\r\nGET /api/v1.1/news/articles?from=2024-01-01&to=2024-01-31&lang=en&page=1&pageSize=50\r\n```\r\n \r\n### Tips\r\n- Both dates accept ISO-8601 (`2024-01-31`) or any\r\n M:System.DateTime.Parse(System.String)-compatible format.\r\n- Defaults: `from = yesterday`, `to = now`, `lang = ar`,\r\n `pageSize = 200` (max).","operationId":"getNewsArticles"}},"/api/v1.1/news/articles/popular":{"get":{"tags":["News"],"parameters":[{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values."},{"name":"lang","in":"query","schema":{"type":"string","default":"ar"},"example":1,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MostPopularArticle"}}}}}},"summary":"List popular articles","description":"Returns the popular articles available on this layer.\n\nSet `lang` to `1` for English or `2` for Arabic.","operationId":"getNewsArticlesPopular"}},"/api/v1.1/news/market-pulse":{"get":{"tags":["News"],"parameters":[{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values."},{"name":"from","in":"query","schema":{"type":"string"},"example":"2024-01-01","description":"Start of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"to","in":"query","schema":{"type":"string"},"example":"2024-03-31","description":"End of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"lang","in":"query","schema":{"type":"string","default":"ar"},"example":1,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":10},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/MarketPulses"}}}}}},"summary":"Get the market pulse feed","description":"Returns the curated short-form market pulse feed: the headline items Argaam's editorial desk considers market-moving right now, newest first.\n\nPaginated: use `page` and `pageSize`. Bound the result with the `from` and `to` date parameters. Set `lang` to `1` for English or `2` for Arabic.","operationId":"getNewsMarketPulse"}},"/api/v1.1/news/articles/{articleId}":{"get":{"tags":["News"],"parameters":[{"name":"articleId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Identifier of the news article."},{"name":"lang","in":"query","schema":{"type":"string","default":"ar"},"example":1,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"styled","in":"query","schema":{"type":"boolean","default":true},"example":true,"description":"When `true`, returns values pre-formatted for display (thousands separators, currency suffixes) instead of raw numbers. Defaults to `True`."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleDetails"}}}}},"summary":"Get a article by articleId","description":"Returns the article identified by `articleId`.\n\nSet `lang` to `1` for English or `2` for Arabic.","operationId":"getNewsArticlesByArticleId"}},"/api/v1.1/news/articles/{articleId}/amp":{"get":{"tags":["News"],"parameters":[{"name":"articleId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric article identifier."},{"name":"lang","in":"query","description":"Article language. Default: `ar`. Defaults to `ar`.","schema":{"type":"string","default":"ar"},"example":1}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleAMP"}}}}},"summary":"Article body in AMP-compliant HTML.","description":"AMP (Accelerated Mobile Pages) variant for high-performance\r\nmobile rendering and SEO ranking.\r\n \r\n### Example\r\n```\r\nGET /api/v1.1/news/articles/12345/amp?lang=en\r\n```","operationId":"getNewsArticlesByArticleIdAmp"}},"/api/v1.1/news/articles/by-id/{articleId}":{"get":{"tags":["News"],"parameters":[{"name":"articleId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Identifier of the news article."},{"name":"languageId","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":2,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."}],"responses":{"200":{"description":"Success"}},"summary":"Article details by id and language id (legacy lookup).","description":"Convenience overload that takes numeric `languageId` (1 = Arabic,\r\n2 = English) instead of the `lang` string code. Provided for\r\nbackwards compatibility with v1.0 clients.\r\n \r\n### Example\r\n```\r\nGET /api/v1.1/news/articles/by-id/12345?languageId=2\r\n```","operationId":"getNewsArticlesByIdByArticleId"}},"/api/v1.1/news/companies/{symbol}/sections/{sectionId}":{"get":{"tags":["News"],"parameters":[{"name":"symbol","in":"path","required":true,"schema":{"type":"string"},"description":"Stock symbol (e.g., `2222`)."},{"name":"sectionId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Editorial section ID."},{"name":"languageId","in":"query","description":"Numeric language id: `1` = ar, `2` = en. Defaults to `1`.","schema":{"type":"integer","format":"int32","default":1},"example":2},{"name":"page","in":"query","description":"Page number. Default: `1`. Defaults to `1`.","schema":{"type":"integer","format":"int32","default":1},"example":1},{"name":"pageSize","in":"query","description":"Records per page. Default: `10`. Defaults to `10`.","schema":{"type":"integer","format":"int32","default":10},"example":20}],"responses":{"200":{"description":"Success"}},"summary":"Articles tagged to a specific company section.","description":"Sections are the editorial categories Argaam maintains per\r\ncompany (e.g., disclosures, analyst estimates, financial reports).\r\n \r\n### Example\r\n```\r\nGET /api/v1.1/news/companies/2222/sections/26?lang=1&page=1&pageSize=10\r\n```","operationId":"getNewsCompaniesBySymbolSectionsBySectionId"}},"/api/v1.1/news/markets/{marketId}/sections/{sectionId}":{"get":{"tags":["News"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Market ID (e.g., `1`).","example":3},{"name":"sectionId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Section ID."},{"name":"languageId","in":"query","description":"Language id: `1` = ar, `2` = en. Defaults to `1`.","schema":{"type":"integer","format":"int32","default":1},"example":2},{"name":"page","in":"query","description":"Page number. Default: `1`. Defaults to `1`.","schema":{"type":"integer","format":"int32","default":1},"example":1},{"name":"pageSize","in":"query","description":"Records per page. Default: `30`. Defaults to `30`.","schema":{"type":"integer","format":"int32","default":30},"example":20},{"name":"searchText","in":"query","description":"Optional free-text filter.","schema":{"type":"string"}},{"name":"orderBy","in":"query","description":"Optional sort key (e.g., `publish-date`, `popularity`).","schema":{"type":"string"}}],"responses":{"200":{"description":"Success"}},"summary":"Articles tagged to a specific market section.","description":"### Example\r\n```\r\nGET /api/v1.1/news/markets/1/sections/3?lang=1&orderBy=publish-date\r\n```","operationId":"getNewsMarketsByMarketIdSectionsBySectionId"}},"/api/v1.1/news/markets/{marketId}/sections/{sectionId}/all":{"get":{"tags":["News"],"parameters":[{"name":"marketId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values.","example":3},{"name":"sectionId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"News section identifier used to group articles (e.g. announcements, analysis)."},{"name":"languageId","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":2,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":30},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."},{"name":"searchText","in":"query","schema":{"type":"string"},"description":"Free-text search term."},{"name":"orderBy","in":"query","schema":{"type":"string"},"description":"Field name to sort the result set by."}],"responses":{"200":{"description":"Success"}},"summary":"All articles for a market section (no section pre-filter).","description":"Variant of `/markets/{marketId}/sections/{sectionId}` that\r\nreturns the un-filtered superset.","operationId":"getNewsMarketsByMarketIdSectionsBySectionIdAll"}},"/api/v1.1/news/articles/with-symbols":{"get":{"tags":["News"],"parameters":[{"name":"lang","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"from","in":"query","schema":{"type":"string"},"example":"2024-01-01","description":"Start of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"to","in":"query","schema":{"type":"string"},"example":"2024-03-31","description":"End of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values. Defaults to `3`."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":30},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."}],"responses":{"200":{"description":"Success"}},"summary":"Articles enriched with stock-symbol references for the period.","description":"Returns articles that mention listed companies, with each\r\narticle including the symbols referenced inside the body.\r\nUse for **NLP / sentiment-tagging pipelines**.\r\n \r\n### Example\r\n```\r\nGET /api/v1.1/news/articles/with-symbols?lang=2&from=2024-01-01&to=2024-01-31&marketId=1\r\n```","operationId":"getNewsArticlesWithSymbols"}},"/api/v1.1/news/home":{"get":{"tags":["News"],"parameters":[{"name":"sectionId","in":"query","schema":{"type":"integer","format":"int32"},"example":26,"description":"News section identifier used to group articles (e.g. announcements, analysis)."},{"name":"marketId","in":"query","schema":{"type":"integer","format":"int32","default":3},"example":3,"description":"Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values. Defaults to `3`."},{"name":"languageId","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":2,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"stockSymbol","in":"query","schema":{"type":"string","default":""},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":30},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."}],"responses":{"200":{"description":"Success"}},"summary":"Home-page main news feed.","description":"Curated headline list designed for the Argaam home page or\r\nany landing-page widget. Optionally filter by stock symbol.\r\n \r\n### Example\r\n```\r\nGET /api/v1.1/news/home?sectionId=2&marketId=1&languageId=1&stockSymbol=2222\r\n```","operationId":"getNewsHome"}},"/api/v1.1/news/articles/by-date":{"get":{"tags":["News"],"parameters":[{"name":"languageId","in":"query","schema":{"type":"integer","format":"int32"},"example":2,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"from","in":"query","schema":{"type":"string","default":""},"example":"2024-01-01","description":"Start of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"to","in":"query","schema":{"type":"string","default":""},"example":"2024-03-31","description":"End of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"stockSymbol","in":"query","schema":{"type":"string","default":""},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":0},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":0},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."}],"responses":{"200":{"description":"Success"}},"summary":"Articles by date range with optional filters.","description":"Calendar-driven listing: combines arbitrary date range with\r\noptional company / paging.\r\n \r\n### Example\r\n```\r\nGET /api/v1.1/news/articles/by-date?languageId=2&from=2024-01-01&to=2024-01-31&stockSymbol=2222&page=1&pageSize=50\r\n```","operationId":"getNewsArticlesByDate"}},"/api/v1.1/news/earning-reports":{"get":{"tags":["News"],"parameters":[{"name":"languageId","in":"query","schema":{"type":"integer","format":"int32"},"example":2,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"from","in":"query","schema":{"type":"string","default":""},"example":"2024-01-01","description":"Start of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"to","in":"query","schema":{"type":"string","default":""},"example":"2024-03-31","description":"End of the date range, inclusive. Format `YYYY-MM-DD`."},{"name":"stockSymbol","in":"query","schema":{"type":"string","default":""},"example":"2222","description":"Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco)."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":0},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":0},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."}],"responses":{"200":{"description":"Success"}},"summary":"List earnings reports","description":"Returns the earnings reports available on this layer.\n\nPaginated: use `page` and `pageSize`. Bound the result with the `from` and `to` date parameters. Set `lang` to `1` for English or `2` for Arabic.","operationId":"getNewsEarningReports"}},"/api/v1.1/news/article-types":{"get":{"tags":["News"],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ArticleType"}}}}}},"summary":"Available article type taxonomies.","description":"Article types group editorial content into broad categories\r\n(news, analysis, press release, etc.). Use to build filter UIs.","operationId":"getNewsArticleTypes","parameters":[]}},"/api/v1.1/news/article-sources":{"get":{"tags":["News"],"parameters":[{"name":"lang","in":"query","schema":{"type":"string","default":"ar"},"example":1,"description":"Response language: `1` = English, `2` = Arabic. Defaults to `1`."},{"name":"page","in":"query","schema":{"type":"integer","format":"int32","default":1},"example":1,"description":"1-based page number. Defaults to `1`."},{"name":"pageSize","in":"query","schema":{"type":"integer","format":"int32","default":200},"example":20,"description":"Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side."}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/ArticleSource"}}}}}},"summary":"Article source registry (publishers, agencies).","description":"Returns the list of upstream sources Argaam aggregates from.\r\nUseful when displaying article attribution.","operationId":"getNewsArticleSources"}},"/api/v1.1/news/analytics/comments/{entityTypeId}/{recordId}":{"get":{"tags":["News"],"parameters":[{"name":"entityTypeId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Type of entity the comments belong to (article, company, ...)."},{"name":"recordId","in":"path","required":true,"schema":{"type":"integer","format":"int32"},"description":"Identifier of the record within the given `entityTypeId`."}],"responses":{"200":{"description":"Success"}},"summary":"Aggregated comment / view analytics for an entity.","description":"Returns view + comment counts. Drives reader-engagement\r\ndashboards and trending-content rankings.\r\n \r\n### Example\r\n```\r\nGET /api/v1.1/news/analytics/comments/1/12345\r\n```","operationId":"getNewsAnalyticsCommentsByEntityTypeIdByRecordId"}}},"components":{"schemas":{"ArticleAMP":{"type":"object","properties":{"includeCSS":{"type":"boolean"},"ampReadyBody":{"type":"string","nullable":true,"readOnly":true},"customAMPCss":{"type":"string","nullable":true,"readOnly":true}},"additionalProperties":false},"ArticleDetails":{"type":"object","properties":{"articleID":{"type":"integer","format":"int32"},"languageID":{"type":"integer","format":"int32"},"language":{"type":"string","nullable":true,"readOnly":true},"title":{"type":"string","nullable":true},"body":{"type":"string","nullable":true},"shortURL":{"type":"string","nullable":true},"publishedOn":{"type":"string","nullable":true},"articleSourceName":{"type":"string","nullable":true},"articleType":{"type":"string","nullable":true,"readOnly":true},"articleTypeNameAr":{"type":"string","nullable":true},"articleTypeNameEn":{"type":"string","nullable":true},"marketTickerIDs":{"type":"string","nullable":true},"marketTickerChartIDs":{"type":"array","items":{"type":"string"},"nullable":true,"readOnly":true},"companyTickerIDs":{"type":"string","nullable":true},"companyTickerChartIDs":{"type":"array","items":{"type":"string"},"nullable":true,"readOnly":true},"customAMPCss":{"type":"string","nullable":true}},"additionalProperties":false},"Article":{"type":"object","properties":{"articleID":{"type":"integer","format":"int32"},"languageID":{"type":"integer","format":"int32"},"language":{"type":"string","nullable":true,"readOnly":true},"title":{"type":"string","nullable":true},"publishedOn":{"type":"string","nullable":true},"link":{"type":"string","nullable":true,"readOnly":true},"isLinked":{"type":"boolean"},"linkedToURL":{"type":"string","nullable":true},"isPaid":{"type":"boolean"},"articleSourceName":{"type":"string","nullable":true},"source":{"type":"string","nullable":true},"articleType":{"type":"string","nullable":true,"readOnly":true},"articleTypeNameAr":{"type":"string","nullable":true},"articleTypeNameEn":{"type":"string","nullable":true},"marketTickerIDs":{"type":"string","nullable":true},"marketTickerChartIDs":{"type":"array","items":{"type":"string"},"nullable":true,"readOnly":true},"companyTickerIDs":{"type":"string","nullable":true},"companyTickerChartIDs":{"type":"array","items":{"type":"string"},"nullable":true,"readOnly":true},"body":{"type":"string","nullable":true},"showDetails":{"type":"boolean"},"iconURL":{"type":"string","nullable":true}},"additionalProperties":false},"MarketPulses":{"type":"object","properties":{"articleID":{"type":"integer","format":"int32"},"languageID":{"type":"integer","format":"int32"},"title":{"type":"string","nullable":true},"body":{"type":"string","nullable":true},"source":{"type":"string","nullable":true},"isLinked":{"type":"boolean"},"linkedToURL":{"type":"string","nullable":true},"isLocked":{"type":"boolean"},"displayTime":{"type":"string","format":"date-time"}},"additionalProperties":false},"MostPopularArticle":{"type":"object","properties":{"articleID":{"type":"integer","format":"int32"},"languageID":{"type":"integer","format":"int32"},"language":{"type":"string","nullable":true,"readOnly":true},"title":{"type":"string","nullable":true},"link":{"type":"string","nullable":true,"readOnly":true},"isLinked":{"type":"boolean"},"linkedToURL":{"type":"string","nullable":true}},"additionalProperties":false},"ApiV1Meta":{"type":"object","properties":{"page":{"type":"integer","format":"int32"},"pageSize":{"type":"integer","format":"int32"},"totalRecords":{"type":"integer","format":"int32"},"totalPages":{"type":"integer","format":"int32","readOnly":true},"hasNextPage":{"type":"boolean","readOnly":true},"hasPreviousPage":{"type":"boolean","readOnly":true}},"additionalProperties":false},"ApiV1RateLimit":{"type":"object","properties":{"limit":{"type":"integer","format":"int32"},"remaining":{"type":"integer","format":"int32"},"reset":{"type":"string","format":"date-time"}},"additionalProperties":false},"ApiV1Response":{"type":"object","properties":{"success":{"type":"boolean"},"apiVersion":{"type":"string","nullable":true},"timestamp":{"type":"string","format":"date-time"},"requestId":{"type":"string","nullable":true},"data":{"nullable":true},"meta":{"$ref":"#/components/schemas/ApiV1Meta"},"rateLimit":{"$ref":"#/components/schemas/ApiV1RateLimit"}},"additionalProperties":false},"ArticleSource":{"type":"object","properties":{"articleSourceID":{"type":"integer","format":"int32"},"articleSourceName":{"type":"string","nullable":true},"languageID":{"type":"integer","format":"int32"},"parentArticleSourceID":{"type":"integer","format":"int32","nullable":true},"isActiveForStatistic":{"type":"boolean"}},"additionalProperties":false},"ArticleType":{"type":"object","properties":{"articleTypeID":{"type":"integer","format":"int32"},"nameAr":{"type":"string","nullable":true},"nameEn":{"type":"string","nullable":true},"argaamID":{"type":"integer","format":"int32","nullable":true},"usedInChart":{"type":"boolean"}},"additionalProperties":false}},"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apikey"},"ApiKeyAuthQuery":{"type":"apiKey","in":"query","name":"apikey"}}},"security":[{"ApiKeyAuth":[]}],"servers":[{"url":"https://api-sandbox.argaam.com","description":"Argaam API Gateway (Sandbox)"}]} ````