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

# Browse equity research reports

> [OpenAPI JSON Spec](/docs/output/v1_stocks_research_get.json)
Report headers (metadata, report-level summary, key points),
newest publication first. `symbol`/`entity` filter on the
REPORT-level coverage arrays — "reports discussing X
anywhere" (broader than the search endpoint's per-unit
filter). Unit summaries are not included; fetch them via
/research/units or /research/report.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/stocks/research
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/research:
    get:
      tags:
        - Stock
      summary: Browse equity research reports
      description: |-
        [OpenAPI JSON Spec](/docs/output/v1_stocks_research_get.json)
        Report headers (metadata, report-level summary, key points),
        newest publication first. `symbol`/`entity` filter on the
        REPORT-level coverage arrays — "reports discussing X
        anywhere" (broader than the search endpoint's per-unit
        filter). Unit summaries are not included; fetch them via
        /research/units or /research/report.
      parameters:
        - description: Reports whose coverage includes this symbol
          in: query
          name: symbol
          schema:
            type: string
        - description: Reports whose coverage includes this entity name
          in: query
          name: entity
          schema:
            type: string
        - description: Report scope
          in: query
          name: scope
          schema:
            type: string
            enum:
              - company
              - industry
              - macro
        - description: Report sector (closed set)
          in: query
          name: sector
          schema:
            type: string
            enum:
              - semiconductors
              - software
              - internet
              - hardware
              - financials
              - industrials
              - autos
              - aerospace_space
              - healthcare
              - consumer
              - energy
              - materials
              - real_assets
              - multi
              - none
              - other
        - description: Report region (closed set)
          in: query
          name: region
          schema:
            type: string
            enum:
              - us
              - americas_ex_us
              - europe
              - emea_other
              - japan
              - greater_china
              - apac_other
              - global
        - description: published_at range start, unix seconds
          in: query
          name: start_time
          schema:
            type: integer
        - description: published_at range end, unix seconds
          in: query
          name: end_time
          schema:
            type: integer
        - description: Max results (default 20, max 100)
          in: query
          name: limit
          schema:
            type: integer
        - description: Offset (default 0)
          in: query
          name: offset
          schema:
            type: integer
      responses:
        '200':
          description: Report headers, newest first
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        items:
                          $ref: '#/components/schemas/model.ResearchReport'
                        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'
        metadata: {}
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    model.ResearchReport:
      properties:
        analysts:
          items:
            type: string
          type: array
        doc_id:
          example: 92e1b8986fde4a73
          type: string
        entities:
          items:
            type: string
          type: array
        file_url:
          type: string
        key_points:
          items:
            type: string
          type: array
        page_count:
          example: 9
          type: integer
        published_at:
          example: '2026-03-19T00:44:00Z'
          type: string
        publisher:
          example: Goldman Sachs
          type: string
        region:
          example: us
          type: string
        scope:
          example: company
          type: string
        sector:
          example: semiconductors
          type: string
        summary:
          type: string
        symbols:
          items:
            type: string
          type: array
        title:
          example: 'Micron Technology (MU): Very strong quarter'
          type: string
        units:
          description: >-
            Units is populated only by the detail endpoint (/research/report);
            the

            list endpoint leaves it nil so omitempty drops the key entirely.
          items:
            $ref: '#/components/schemas/model.ResearchUnit'
          type: array
      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.ResearchUnit:
      properties:
        doc_id:
          example: 92e1b8986fde4a73
          type: string
        file_url:
          example: >-
            https://storage.googleapis.com/arrays-public-assets/equity-research/0b0ac4fa.pdf#page=11
          type: string
        heading:
          example: Sizing the Consumer Agent Opportunity
          type: string
        idx:
          example: 3
          type: integer
        kind:
          example: section
          type: string
        page_from:
          example: 11
          type: integer
        page_to:
          example: 13
          type: integer
        published_at:
          example: '2026-05-06T00:33:00Z'
          type: string
        publisher:
          example: Goldman Sachs
          type: string
        region:
          example: us
          type: string
        scope:
          example: industry
          type: string
        score:
          example: 14.2
          type: number
        sector:
          example: semiconductors
          type: string
        summary:
          type: string
        symbols:
          items:
            type: string
          type: array
        title:
          example: Decoding the Agentic Economy
          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

````