---
title: "Home-page main news feed."
url: "https://developer.argaam.com/apis/news-editorial-layer-api-sandbox-v1/versions/56dc3378-a7ea-4bb0-a38f-84e9d50d974b/operations/getNewsHome"
---

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

# Home-page main news feed.

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

Operation ID: `getNewsHome`

Curated headline list designed for the Argaam home page or any landing-page widget. Optionally filter by stock symbol. ### Example ``` GET /api/v1.1/news/home?sectionId=2&marketId=1&languageId=1&stockSymbol=2222 ```

## Query parameters

- `sectionId` (integer, int32, optional) - News section identifier used to group articles (e.g. announcements, analysis).
- `marketId` (integer, int32, optional) - Numeric market identifier (e.g. `1` = Tadawul / Saudi main market). Use `GET /api/v1.1/markets` to list valid values. Defaults to `3`.
- `languageId` (integer, int32, optional) - Response language: `1` = English, `2` = Arabic. Defaults to `1`.
- `stockSymbol` (string, optional) - Tadawul stock symbol of the company, e.g. `2222` (Saudi Aramco).
- `page` (integer, int32, optional) - 1-based page number. Defaults to `1`.
- `pageSize` (integer, int32, optional) - Number of records per page. Defaults to the endpoint's standard page size; large values are capped server-side.

## 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/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

        any landing-page widget. Optionally filter by stock symbol.\r

        \            \r

        ### Example\r

        ```\r

        GET
        /api/v1.1/news/home?sectionId=2&marketId=1&languageId=1&stockSymbol=2222\
        \r

        ```"
      operationId: getNewsHome
security:
  - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: apikey
````