> ## 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 News Source Links

> [OpenAPI JSON Spec](/docs/output/v1_stocks_news_source-links_get.json)
Retrieve news and publicly accessible pages proving the reported event exists, without returning article bodies. Results are ordered by published_at DESC.
source_type: provider means the publisher's own page; substitute means another free page reporting the same event; none means no acceptable page was found, or an unprocessed story is outside the recent 72-hour window; pending means not checked yet or a retry is scheduled, including recent stories awaiting enqueue.
source_url, source_domain and source_title are empty for none and pending. source_published_at is omitted when unknown or no page is linked.
Update polling returns only settled provider, substitute and none links within [updated_after, updated_before), ordered by (updated_at ASC, story_id ASC). Pending links are excluded.
Each story normally enters the update stream once when its link is decided; changed link fields advance updated_at and make it appear again. Bookkeeping and joined news metadata do not advance it.
start_time/end_time and symbol/industry are optional intersections in window mode. Replay pagination.cursor with the same window and filters; limit may change. Offset is rejected in window mode.
Items carry RFC3339 UTC updated_at in window mode. has_more=false means the window is drained. This is current-state polling, not a snapshot or deletion feed; overlap windows and reconcile delayed writes. See docs/api/news-source-link-updates.md and docs/api/update-polling.md.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/stocks/news/source-links
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/source-links:
    get:
      tags:
        - Stock
      summary: Get News Source Links
      description: >-
        [OpenAPI JSON Spec](/docs/output/v1_stocks_news_source-links_get.json)

        Retrieve news and publicly accessible pages proving the reported event
        exists, without returning article bodies. Results are ordered by
        published_at DESC.

        source_type: provider means the publisher's own page; substitute means
        another free page reporting the same event; none means no acceptable
        page was found, or an unprocessed story is outside the recent 72-hour
        window; pending means not checked yet or a retry is scheduled, including
        recent stories awaiting enqueue.

        source_url, source_domain and source_title are empty for none and
        pending. source_published_at is omitted when unknown or no page is
        linked.

        Update polling returns only settled provider, substitute and none links
        within [updated_after, updated_before), ordered by (updated_at ASC,
        story_id ASC). Pending links are excluded.

        Each story normally enters the update stream once when its link is
        decided; changed link fields advance updated_at and make it appear
        again. Bookkeeping and joined news metadata do not advance it.

        start_time/end_time and symbol/industry are optional intersections in
        window mode. Replay pagination.cursor with the same window and filters;
        limit may change. Offset is rejected in window mode.

        Items carry RFC3339 UTC updated_at in window mode. has_more=false means
        the window is drained. This is current-state polling, not a snapshot or
        deletion feed; overlap windows and reconcile delayed writes. See
        docs/api/news-source-link-updates.md and docs/api/update-polling.md.
      parameters:
        - description: >-
            Canonical symbol (e.g. AAPL, BRK.B, 0700.HK); mutually exclusive
            with industry
          in: query
          name: symbol
          schema:
            type: string
        - description: Exact FMP industry filter; mutually exclusive with symbol
          in: query
          name: industry
          schema:
            type: string
        - description: >-
            Start publication time (Unix seconds); required without an update
            window
          in: query
          name: start_time
          schema:
            type: integer
            format: int64
        - description: >-
            End publication time (Unix seconds); required without an update
            window, greater than start_time when both are supplied
          in: query
          name: end_time
          schema:
            type: integer
            format: int64
        - description: Maximum results
          in: query
          name: limit
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 10
        - description: Inclusive update time (Unix seconds); requires updated_before
          in: query
          name: updated_after
          schema:
            type: integer
            format: int64
        - description: Exclusive update time (Unix seconds); greater than updated_after
          in: query
          name: updated_before
          schema:
            type: integer
            format: int64
        - description: Opaque pagination cursor; requires the same window and filters
          in: query
          name: cursor
          schema:
            type: string
      responses:
        '200':
          description: News source links
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.NewsSourceLink'
                        type: array
                      pagination:
                        $ref: '#/components/schemas/model.CursorPagination'
                    type: object
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      error:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      error:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '503':
          description: Service unavailable
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      error:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        metadata: {}
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.NewsSourceLink:
      properties:
        provider:
          type: string
        published_at:
          type: integer
        source_domain:
          type: string
        source_published_at:
          type: integer
        source_title:
          type: string
        source_type:
          type: string
        source_url:
          type: string
        story_id:
          type: string
        symbols:
          items:
            type: string
          type: array
        title:
          type: string
        updated_at:
          description: >-
            UpdatedAt is emitted only for update-window reads, preserving
            fractional seconds.
          type: string
      type: object
    model.CursorPagination:
      properties:
        cursor:
          type: string
        has_more:
          type: boolean
        indexed_through:
          type: integer
        limit:
          type: integer
      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.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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.