---
title: "List articles published in a date range, paged."
url: "https://developer.argaam.com/apis/news-editorial-layer-api-sandbox-v1/versions/56dc3378-a7ea-4bb0-a38f-84e9d50d974b/operations/getNewsArticles"
---

> Full API specification: https://developer.argaam.com/apis/news-editorial-layer-api-sandbox-v1/versions/56dc3378-a7ea-4bb0-a38f-84e9d50d974b.md

# List articles published in a date range, paged.

`GET` `/api/v1.1/news/articles`

Operation ID: `getNewsArticles`

Returns the firehose of Argaam articles for the requested time window. Use this endpoint for **chronological feeds** such as a news sidebar or mobile timeline. ### Example ``` GET /api/v1.1/news/articles?from=2024-01-01&to=2024-01-31&lang=en&page=1&pageSize=50 ``` ### Tips - Both dates accept ISO-8601 (`2024-01-31`) or any M:System.DateTime.Parse(System.String)-compatible format. - Defaults: `from = yesterday`, `to = now`, `lang = ar`, `pageSize = 200` (max).

## Query parameters

- `from` (string, optional) - Start timestamp (inclusive). Defaults to yesterday.
- `to` (string, optional) - End timestamp (inclusive). Defaults to now.
- `lang` (string, optional) - Article language. Allowed: `ar`, `en`. Default: `ar`. Defaults to `ar`.
- `page` (integer, int32, optional) - 1-based page number. Default: `1`. Defaults to `1`.
- `pageSize` (integer, int32, optional) - Records per page. Max: `200`. Default: `200`. Defaults to `200`.

## Responses

- `200` - Success

## OpenAPI definition

````yaml
openapi: 3.0.1
info:
  title: News & Editorial Layer API
  version: v1.1
servers:
  - url: https://api-sandbox.argaam.com
    description: Argaam API Gateway (Sandbox)
paths:
  /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

        window. Use this endpoint for **chronological feeds** such as a\r

        news sidebar or mobile timeline.\r

        \            \r

        ### Example\r

        ```\r

        GET
        /api/v1.1/news/articles?from=2024-01-01&to=2024-01-31&lang=en&page=1&pa\
        geSize=50\r

        ```\r

        \            \r

        ### Tips\r

        - Both dates accept ISO-8601 (`2024-01-31`) or any\r

        \  M:System.DateTime.Parse(System.String)-compatible format.\r

        - Defaults: `from = yesterday`, `to = now`, `lang = ar`,\r

        \  `pageSize = 200` (max)."
      operationId: getNewsArticles
security:
  - ApiKeyAuth: []
components:
  schemas:
    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
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
````