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

# Get Citations List

> Aggregates team-specific citation metrics and rankings for AI model queries across domains.



## OpenAPI

````yaml GET /api/v1/sources/citations_list
openapi: 3.1.0
info:
  title: OpenAPI Plant Store
  description: >-
    A sample API that uses a plant store as an example to demonstrate features
    in the OpenAPI specification
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: http://api.quno.ai
security:
  - bearerAuth: []
paths:
  /api/v1/sources/citations_list:
    get:
      description: >-
        Aggregates team-specific citation metrics and rankings for AI model
        queries across domains.
      parameters:
        - name: team_id
          in: query
          description: Team ID
          required: true
          schema:
            type: string
            format: uuid
        - name: start_date
          in: query
          description: Start date for data calculation (defaults to 7 days ago)
          required: false
          schema:
            type: string
            format: date
        - name: end_date
          in: query
          description: End date for data calculation (defaults to current date)
          required: false
          schema:
            type: string
            format: date
        - name: model
          in: query
          description: Model type
          required: false
          schema:
            type: string
            default: chatgpt
        - name: country
          in: query
          description: Country code
          required: false
          schema:
            type: string
            default: US
        - name: question_type
          in: query
          description: Type of question
          required: false
          schema:
            type: string
            default: unbranded
      responses:
        '200':
          description: Successful response with citations list data
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CitationsListResponse'
        '400':
          description: Bad request - invalid parameters
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    CitationsListResponse:
      type: object
      required:
        - citations
        - prompt_rankings
        - ownership
      properties:
        citations:
          type: array
          items:
            $ref: '#/components/schemas/CitationItem'
        prompt_rankings:
          type: object
          additionalProperties:
            type: object
            additionalProperties:
              type: integer
        ownership:
          $ref: '#/components/schemas/OwnershipData'
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
    CitationItem:
      type: object
      required:
        - domain
        - count
        - position
        - urls
      properties:
        domain:
          type: string
          description: Domain name
        count:
          type: integer
          description: Number of citations
        position:
          type: number
          format: float
          description: Position ranking
        urls:
          type: array
          items:
            $ref: '#/components/schemas/SuburlItem'
    OwnershipData:
      type: object
      required:
        - owned
        - earned
      properties:
        owned:
          type: integer
          description: Number of owned citations
        earned:
          type: integer
          description: Number of earned citations
    SuburlItem:
      type: object
      required:
        - url
        - count
        - domain
        - prompts
        - lastCited
        - suburl_id
      properties:
        url:
          type: string
          description: The URL being analyzed
        count:
          type: integer
          description: Number of citations
        domain:
          type: string
          description: Domain name
        prompts:
          type: array
          items:
            type: string
          description: List of prompts
        lastCited:
          type: string
          format: date
          description: Last citation date
        sentiment:
          type: string
          description: Sentiment analysis result
        suburl_id:
          type: string
          description: Unique identifier for the suburl
        channelType:
          type: string
          description: Type of channel
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````