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

# Get Analysis

> Fetch analysis by ID.

Returns complete analysis data including sentiment, themes, opinions, sources, and related topics.

**Authentication:**
- Optional (public analyses accessible to all)

**Access Control:**
- Current project/entity scope, legacy ownership, or explicit public access

**Path Parameters:**
- analysis_id: UUID of the analysis

**Response:**
- Complete analysis object with all fields



## OpenAPI

````yaml /api/openapi.json get /agent/v1/analysis/{analysis_id}
openapi: 3.1.0
info:
  title: CrowdListen Agent API
  description: >-
    Configure sources, collect and retain originals, run durable analysis, and
    read or revise cited insights. Humans and agents share authorized
    entity/project records, research jobs and evidence history.
  version: 1.0.0
servers:
  - url: https://agent.crowdlisten.com
    description: Production
  - url: http://localhost:8000
    description: Local development
security: []
paths:
  /agent/v1/analysis/{analysis_id}:
    get:
      tags:
        - analysis
      summary: Get Analysis
      description: >-
        Fetch analysis by ID.


        Returns complete analysis data including sentiment, themes, opinions,
        sources, and related topics.


        **Authentication:**

        - Optional (public analyses accessible to all)


        **Access Control:**

        - Current project/entity scope, legacy ownership, or explicit public
        access


        **Path Parameters:**

        - analysis_id: UUID of the analysis


        **Response:**

        - Complete analysis object with all fields
      operationId: get_analysis_agent_v1_analysis__analysis_id__get
      parameters:
        - name: analysis_id
          in: path
          required: true
          schema:
            type: string
            title: Analysis Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnalysisResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AnalysisResponse:
      properties:
        id:
          type: string
          title: Id
        user_id:
          type: string
          title: User Id
        project_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Project Id
        question:
          type: string
          title: Question
        takeaway:
          anyOf:
            - type: string
            - type: 'null'
          title: Takeaway
        sentiment:
          anyOf:
            - $ref: '#/components/schemas/SentimentData'
            - type: 'null'
        opinions:
          anyOf:
            - items:
                $ref: '#/components/schemas/OpinionData'
              type: array
            - type: 'null'
          title: Opinions
        themes:
          anyOf:
            - items:
                $ref: '#/components/schemas/ThemeData'
              type: array
            - type: 'null'
          title: Themes
        sources:
          anyOf:
            - items:
                $ref: '#/components/schemas/SourceData'
              type: array
            - type: 'null'
          title: Sources
        related_topics:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Related Topics
        tool_calls:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Tool Calls
        tag:
          anyOf:
            - type: string
            - type: 'null'
          title: Tag
        status:
          anyOf:
            - type: string
            - type: 'null'
          title: Status
        research_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Research Status
        entity_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Entity Id
        public:
          type: boolean
          title: Public
        total_comments:
          anyOf:
            - type: integer
            - type: 'null'
          title: Total Comments
        created_at:
          type: string
          format: date-time
          title: Created At
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated At
      additionalProperties: true
      type: object
      required:
        - id
        - user_id
        - question
        - public
        - created_at
      title: AnalysisResponse
      description: Complete analysis data
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    SentimentData:
      properties:
        positive:
          type: number
          maximum: 100
          minimum: 0
          title: Positive
        negative:
          type: number
          maximum: 100
          minimum: 0
          title: Negative
        neutral:
          type: number
          maximum: 100
          minimum: 0
          title: Neutral
      type: object
      required:
        - positive
        - negative
        - neutral
      title: SentimentData
      description: Sentiment distribution (must sum to 100)
    OpinionData:
      properties:
        opinion:
          anyOf:
            - type: string
            - type: 'null'
          title: Opinion
        text:
          anyOf:
            - type: string
            - type: 'null'
          title: Text
        quote:
          anyOf:
            - type: string
            - type: 'null'
          title: Quote
        verbatim:
          anyOf:
            - items:
                type: string
              type: array
            - type: 'null'
          title: Verbatim
        sentiment:
          anyOf:
            - type: string
            - type: 'null'
          title: Sentiment
        count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Count
        percentage:
          anyOf:
            - type: integer
            - type: 'null'
          title: Percentage
        contextDetails:
          anyOf:
            - type: string
            - type: 'null'
          title: Contextdetails
      additionalProperties: true
      type: object
      title: OpinionData
      description: Opinion with supporting quote(s)
    ThemeData:
      properties:
        theme:
          anyOf:
            - type: string
            - type: 'null'
          title: Theme
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
        count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Count
        percentage:
          anyOf:
            - type: integer
            - type: 'null'
          title: Percentage
        sentiment:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Sentiment
        insights:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Insights
      additionalProperties: true
      type: object
      title: ThemeData
      description: Discussion theme with optional details
    SourceData:
      properties:
        id:
          anyOf:
            - type: string
            - type: 'null'
          title: Id
        title:
          anyOf:
            - type: string
            - type: 'null'
          title: Title
        url:
          anyOf:
            - type: string
            - type: 'null'
          title: Url
        domain:
          anyOf:
            - type: string
            - type: 'null'
          title: Domain
        snippet:
          anyOf:
            - type: string
            - type: 'null'
          title: Snippet
        publishedDate:
          anyOf:
            - type: string
            - type: 'null'
          title: Publisheddate
        published_at:
          anyOf:
            - type: string
            - type: 'null'
          title: Published At
        score:
          anyOf:
            - type: number
            - type: 'null'
          title: Score
        isUploaded:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Isuploaded
      additionalProperties: true
      type: object
      title: SourceData
      description: Source metadata
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````

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