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

# Query Research

> Query synthesized research documentation for an entity or topic.

Returns structured findings with source counts, platform coverage,
sentiment, and freshness metadata. Use this to answer questions about
what the crowd is saying about a brand, product, or topic.



## OpenAPI

````yaml /api/openapi.json post /agent/v1/context/query
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/context/query:
    post:
      tags:
        - context
      summary: Query Research
      description: |-
        Query synthesized research documentation for an entity or topic.

        Returns structured findings with source counts, platform coverage,
        sentiment, and freshness metadata. Use this to answer questions about
        what the crowd is saying about a brand, product, or topic.
      operationId: query_research_agent_v1_context_query_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/QueryResearchRequest'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    QueryResearchRequest:
      properties:
        entity_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Entity Name
          description: Entity name to query docs for
        topic:
          anyOf:
            - type: string
            - type: 'null'
          title: Topic
          description: Topic to search across all entities
        query:
          anyOf:
            - type: string
            - type: 'null'
          title: Query
          description: Natural language question
        include_content:
          type: boolean
          title: Include Content
          description: Include full document content
          default: false
      type: object
      title: QueryResearchRequest
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    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.