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

# Consultar datos del informe de Looker Studio

> Devuelve filas de informe de un sitio web y una programación de recopilación. filters.schedule_id admite default o un UUID personalizado; omitirlo selecciona la predeterminada. El antiguo token manual se acepta como alias de default. La selección afecta a todas las métricas y dimensiones y forma parte de la clave de caché. Las programaciones archivadas conservan el historial. Los informes por respuesta se limitan antes de cargar su texto; restringe los filtros si superas el límite de filas.



## OpenAPI

````yaml es/api-reference/openapi.json post /api/v1/looker-studio/data
openapi: 3.1.0
info:
  title: API de AthenaHQ
  description: >-
    La API de AthenaHQ ofrece acceso programático para gestionar tus sitios web
    y consultas para optimizar el contenido con IA.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Servidor de producción
security:
  - apiKey: []
tags:
  - name: Basics
    description: Operaciones principales de la API para gestionar sitios web y consultas
  - name: Metrics
    description: Endpoints de métricas y análisis para monitorizar la visibilidad en IA
  - name: Billing
    description: Endpoints de facturación y créditos para gestionar el uso
  - name: Team Management
    description: Endpoints para gestionar miembros del equipo e invitaciones
  - name: Groups
    description: Endpoints para gestionar grupos de sitios web
  - name: Content
    description: >-
      Endpoints para acceder a los datos del centro de contenidos: pestañas, URL
      monitorizadas y desglose de consultas por URL.
  - name: Pitch Workspace
    description: >-
      Endpoints para acceder a los informes del espacio de propuestas:
      ejecuciones de propuestas con alcance de organización, con competidores,
      consultas, atributos y métricas agregadas.
  - name: Knowledge Base
    description: >-
      Endpoints para leer la base de conocimientos de la marca: datos aprobados
      sobre la marca y los pilares que los organizan.
paths:
  /api/v1/looker-studio/data:
    post:
      tags:
        - Analytics
      summary: Consultar datos del informe de Looker Studio
      description: >-
        Devuelve filas de informe de un sitio web y una programación de
        recopilación. filters.schedule_id admite default o un UUID
        personalizado; omitirlo selecciona la predeterminada. El antiguo token
        manual se acepta como alias de default. La selección afecta a todas las
        métricas y dimensiones y forma parte de la clave de caché. Las
        programaciones archivadas conservan el historial. Los informes por
        respuesta se limitan antes de cargar su texto; restringe los filtros si
        superas el límite de filas.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - website_id
                - dimensions
                - metrics
                - filters
                - looker_studio_filters
              properties:
                website_id:
                  type: string
                  format: uuid
                dimensions:
                  type: array
                  items:
                    type: string
                    enum:
                      - date
                      - model
                      - company_name
                      - is_self
                      - location
                      - topic_name
                      - prompt
                      - response
                metrics:
                  type: array
                  items:
                    type: string
                    enum:
                      - citation_rate
                      - mention_rate
                      - share_of_voice
                      - position
                      - mentions
                      - citations
                      - total_responses
                filters:
                  allOf:
                    - $ref: '#/components/schemas/ApiFilters'
                    - type: object
                      required:
                        - end_date
                      properties:
                        prompt_tags:
                          type: array
                          items:
                            oneOf:
                              - type: string
                                format: uuid
                              - type: string
                                enum:
                                  - type:discovery
                                  - type:high_intent
                        prompt_tags_operator:
                          type: string
                          enum:
                            - is_any_of
                            - has_all_of
                looker_studio_filters:
                  type: array
                  items:
                    type: array
                    items:
                      type: object
                      required:
                        - fieldName
                        - operator
                        - type
                        - value
                      properties:
                        fieldName:
                          type: string
                          enum:
                            - date
                            - model
                            - company_name
                            - is_self
                            - location
                            - topic_name
                            - prompt
                            - response
                            - citation_rate
                            - mention_rate
                            - share_of_voice
                            - position
                            - mentions
                            - citations
                            - total_responses
                        operator:
                          type: string
                          enum:
                            - EQUALS
                            - CONTAINS
                            - REGEXP_PARTIAL_MATCH
                            - REGEXP_EXACT_MATCH
                            - IN_LIST
                            - IS_NULL
                            - BETWEEN
                            - NUMERIC_GREATER_THAN
                            - NUMERIC_GREATER_THAN_OR_EQUAL
                            - NUMERIC_LESS_THAN
                            - NUMERIC_LESS_THAN_OR_EQUAL
                        type:
                          type: string
                          enum:
                            - INCLUDE
                            - EXCLUDE
                        value:
                          type: array
                          items:
                            type: string
      responses:
        '200':
          description: Filas del informe
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        date:
                          type: string
                        model:
                          type: string
                        company_name:
                          type: string
                        is_self:
                          type: boolean
                        location:
                          type: string
                        topic_name:
                          type: string
                        prompt:
                          type: string
                        response:
                          type: string
                        citation_rate:
                          type: number
                        mention_rate:
                          type: number
                        share_of_voice:
                          type: number
                        position:
                          type: number
                        mentions:
                          type: number
                        citations:
                          type: number
                        total_responses:
                          type: number
        '400':
          description: >-
            Solicitud no válida o se ha superado el límite de filas del informe
            de respuestas
        '401':
          description: Se requiere autenticación
        '403':
          description: Acceso denegado al recurso de sitio web o filtro
        '404':
          description: Sitio web no encontrado
components:
  schemas:
    ApiFilters:
      type: object
      description: >-
        Filtros para consultar respuestas y métricas. Pasa los filtros de
        ubicación en el cuerpo JSON como `filters.location_ids`.
      required:
        - start_date
      properties:
        schedule_id:
          $ref: '#/components/schemas/PromptScheduleSelection'
        start_date:
          type: string
          format: date-time
          description: Fecha de inicio del filtro (UTC)
          example: '2024-01-01T00:00:00.000Z'
        end_date:
          type: string
          format: date-time
          description: Fecha de fin del filtro (UTC)
          example: '2024-12-31T23:59:59.999Z'
        models:
          type: array
          description: Filtrar por modelos de IA
          items:
            type: string
            enum:
              - chatgpt
              - perplexity
              - gemini
              - google_ai_overview
              - copilot
              - claude
              - ai_mode
              - grok
              - deepseek
              - meta_ai
              - mistral
          example:
            - chatgpt
            - perplexity
        prompt_ids:
          type: array
          description: Filtrar por IDs de consultas concretas
          items:
            type: string
            format: uuid
        competitor_ids:
          type: array
          description: Filtrar por IDs de competidores concretos
          items:
            type: string
            format: uuid
        location_ids:
          type: array
          description: >-
            Filtra por ID de ubicaciones. Pásalo en el cuerpo JSON como
            `filters.location_ids`, incluso para una sola ubicación. Usa los ID
            devueltos por `GET /api/v1/locations`.
          items:
            type: string
            format: uuid
          example:
            - 123e4567-e89b-12d3-a456-426614174111
        prompt_status:
          type: string
          enum:
            - active
            - paused
          description: Filtrar por estado de la consulta
        prompt_type:
          type: string
          enum:
            - branded
            - non_branded
          description: Filtrar por tipo de consulta
    PromptScheduleSelection:
      description: >-
        Selecciona una programación de recopilación. Usa la selección devuelta
        por GET /api/v1/prompt-schedules. La predeterminada incluye el historial
        anterior al cambio y ejecuciones puntuales; las archivadas conservan
        resultados. El antiguo token manual se admite como alias de default.
        Solo acepta una programación; una lista devuelve 400.
      default: default
      oneOf:
        - type: string
          enum:
            - default
            - manual
        - type: string
          format: uuid
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Clave de API para autenticarse. Puedes crear una
        [aquí](https://app.athenahq.ai/organization?tab=api).

````

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