> ## Documentation Index
> Fetch the complete documentation index at: https://docs.arrays.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Stock News

> [OpenAPI JSON Spec](/docs/output/v1_stocks_news_get.json)
Retrieve stock news articles within a specified time range, optionally filtered by symbol.

Use cases:
- Stock-specific news tracking and aggregation
- News sentiment analysis per ticker
- Media applications and financial news feeds

Data & semantics:
- start_time: Start time (Unix timestamp in seconds, required)
- end_time: End time (Unix timestamp in seconds, required)
- symbol: Stock symbol filter (optional, e.g., AAPL, TSLA)
- limit: Maximum number of results (optional, 1–500, default: 10)



## OpenAPI

````yaml /api-reference/openapi.json get /v1/stocks/news
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Welcome to Arrays!


    Arrays is a unified financial data layer for both financial institutions and
    retail users, delivering comprehensive market data across crypto and equity
    markets. Our datasets cover fundamentals, ETFs, options, crypto, and more.


    Visit [arrays.org](https://arrays.org) to request an API key and start your
    free trial. You can explore our full API offerings in the documentation
    below.


    For any questions regarding APIs or pricing, please contact
    support@arrays.org.
  title: Arrays API
  version: '1.0'
servers:
  - url: https://data-tools.prd.arrays.org/api
security: []
paths:
  /v1/stocks/news:
    get:
      tags:
        - Stock
      summary: Get Stock News
      description: >-
        [OpenAPI JSON Spec](/docs/output/v1_stocks_news_get.json)

        Retrieve stock news articles within a specified time range, optionally
        filtered by symbol.


        Use cases:

        - Stock-specific news tracking and aggregation

        - News sentiment analysis per ticker

        - Media applications and financial news feeds


        Data & semantics:

        - start_time: Start time (Unix timestamp in seconds, required)

        - end_time: End time (Unix timestamp in seconds, required)

        - symbol: Stock symbol filter (optional, e.g., AAPL, TSLA)

        - limit: Maximum number of results (optional, 1–500, default: 10)
      parameters:
        - description: Stock symbol filter (optional)
          example: AAPL
          in: query
          name: symbol
          schema:
            type: string
        - description: Start time (Unix timestamp in seconds)
          example: 1704067200
          in: query
          name: start_time
          required: true
          schema:
            type: integer
            format: int64
        - description: End time (Unix timestamp in seconds)
          example: 1735689600
          in: query
          name: end_time
          required: true
          schema:
            type: integer
            format: int64
        - description: 'Maximum number of results (1–500, default: 10)'
          in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 10
      responses:
        '200':
          description: List of stock news articles
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.NewsArticle'
                        type: array
                    type: object
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.NewsArticle:
      properties:
        article_id:
          type: string
        article_url:
          type: string
        author:
          type: string
        description:
          type: string
        keywords:
          items:
            type: string
          type: array
        published_at:
          type: integer
        publisher:
          $ref: '#/components/schemas/model.NewsPublisher'
        tickers:
          description: >-
            Tickers uses "tickers" (not "symbols") to mirror the upstream

            Polygon/Massive /v2/reference/news field name, and to stay
            consistent with

            the sibling market-news model (model.TickerInfo.ticker). The
            canonical

            "symbol" convention IS honored on the request side via

            GetStockNewsRequest.Symbol.
          items:
            type: string
          type: array
        title:
          type: string
      type: object
    model.APIError:
      properties:
        code:
          example: RESOURCE_NOT_FOUND
          type: string
        details:
          items:
            $ref: '#/components/schemas/model.APIErrorDetail'
          type: array
        docs_url:
          type: string
        examples:
          items:
            type: string
          type: array
        hint:
          type: string
        message:
          example: The requested resource was not found.
          type: string
        suggestions:
          items:
            type: string
          type: array
      type: object
    model.NewsPublisher:
      properties:
        favicon_url:
          type: string
        homepage_url:
          type: string
        logo_url:
          type: string
        name:
          type: string
      type: object
    model.APIErrorDetail:
      properties:
        field:
          type: string
        got:
          type: string
        reason:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: 'API Key authentication. Example: "your-api-key-here"'
      in: header
      name: X-API-Key
      type: apiKey

````