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

# Interroger les données d’un rapport Looker Studio

> Renvoie les lignes du rapport pour un site et une planification. filters.schedule_id accepte default ou un UUID personnalisé ; l’omission sélectionne Par défaut. L’ancien jeton manual est accepté comme alias de default. La planification s’applique à toutes les métriques/dimensions et entre dans la clé de cache. Les planifications archivées conservent l’historique. Les rapports au niveau réponse sont bornés avant chargement du texte ; resserrez les filtres si la limite de lignes est dépassée.



## OpenAPI

````yaml fr/api-reference/openapi.json post /api/v1/looker-studio/data
openapi: 3.1.0
info:
  title: API AthenaHQ
  description: >-
    L’API AthenaHQ permet de gérer vos sites et prompts par programme pour
    l’optimisation de contenu par IA.
  version: 1.0.0
  contact:
    email: support@athenahq.ai
servers:
  - url: https://api.athenahq.ai
    description: Serveur de production
security:
  - apiKey: []
tags:
  - name: Basics
    description: Opérations API principales pour gérer sites et prompts
  - name: Metrics
    description: Points de terminaison de métriques et analyses de visibilité IA
  - name: Billing
    description: Points de facturation et crédits pour gérer la consommation
  - name: Team Management
    description: Points de terminaison de gestion des membres et invitations
  - name: Groups
    description: Points de terminaison de gestion des groupes de sites
  - name: Content
    description: >-
      Points de terminaison Content Hub : onglets, URL suivies et détail des
      prompts par URL.
  - name: Pitch Workspace
    description: >-
      Points de terminaison des rapports Pitch Workspace : exécutions à
      l’échelle de l’organisation avec concurrents, prompts, attributs et
      métriques agrégées.
  - name: Knowledge Base
    description: >-
      Endpoints de lecture de la base de connaissances de la marque — faits
      approuvés et piliers qui les organisent.
paths:
  /api/v1/looker-studio/data:
    post:
      tags:
        - Analytics
      summary: Interroger les données d’un rapport Looker Studio
      description: >-
        Renvoie les lignes du rapport pour un site et une planification.
        filters.schedule_id accepte default ou un UUID personnalisé ; l’omission
        sélectionne Par défaut. L’ancien jeton manual est accepté comme alias de
        default. La planification s’applique à toutes les métriques/dimensions
        et entre dans la clé de cache. Les planifications archivées conservent
        l’historique. Les rapports au niveau réponse sont bornés avant
        chargement du texte ; resserrez les filtres si la limite de lignes est
        dépassée.
      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: Lignes du rapport
          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: Requête invalide ou limite de lignes de rapport de réponses dépassée
        '401':
          description: Authentification requise
        '403':
          description: Accès au site ou à une ressource de filtre refusé
        '404':
          description: Site introuvable
components:
  schemas:
    ApiFilters:
      type: object
      description: >-
        Filtres pour interroger les réponses et les indicateurs. Transmettez les
        filtres d’emplacements dans le corps JSON comme `filters.location_ids`.
      required:
        - start_date
      properties:
        schedule_id:
          $ref: '#/components/schemas/PromptScheduleSelection'
        start_date:
          type: string
          format: date-time
          description: Date de début du filtre (UTC)
          example: '2024-01-01T00:00:00.000Z'
        end_date:
          type: string
          format: date-time
          description: Date de fin du filtre (UTC)
          example: '2024-12-31T23:59:59.999Z'
        models:
          type: array
          description: Filtrer par modèles 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: Filtrer par ID de prompts précis
          items:
            type: string
            format: uuid
        competitor_ids:
          type: array
          description: Filtrer par ID de concurrents précis
          items:
            type: string
            format: uuid
        location_ids:
          type: array
          description: >-
            Filtre par ID d’emplacement dans le corps JSON sous
            `filters.location_ids`, même pour un seul. Utilisez les ID de `GET
            /api/v1/locations`.
          items:
            type: string
            format: uuid
          example:
            - 123e4567-e89b-12d3-a456-426614174111
        prompt_status:
          type: string
          enum:
            - active
            - paused
          description: Filtrer par statut du prompt
        prompt_type:
          type: string
          enum:
            - branded
            - non_branded
          description: Filtrer par type de prompt
    PromptScheduleSelection:
      description: >-
        Sélectionnez une planification de collecte, avec la valeur renvoyée par
        GET /api/v1/prompt-schedules. Par défaut inclut l’historique antérieur à
        la transition et les exécutions ponctuelles ; les planifications
        archivées conservent leurs résultats. L’ancien jeton manual est accepté
        comme alias de default. Ce champ accepte une seule planification ; une
        liste renvoie 400.
      default: default
      oneOf:
        - type: string
          enum:
            - default
            - manual
        - type: string
          format: uuid
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: >-
        Clé API d’authentification. Créez-en une
        [ici](https://app.athenahq.ai/organization?tab=api).

````

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