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

# Obtenir les analyses d'État du site

> Chiffres en direct de Google Analytics 4, Google Search Console et des citations par l'IA pour un site web sur les 28 derniers jours complets, chacun à côté des 28 jours précédents (period donne les deux plages ; change_pct vaut null lorsque la période précédente était à zéro). ga4 : sessions issues de l'IA, leur taux d'engagement et leurs événements clés, sessions organiques et totales, part des sessions issues de l'IA en pourcentage, sessions IA quotidiennes, et le top 10 des sources IA, des pages de destination IA et des pages de destination organiques. gsc : clics, impressions, CTR en pourcentage et position moyenne, une série quotidienne, et le top 10 des requêtes et des pages. cited_pages : les pages du site web les plus citées par les réponses IA, avec les chiffres Google de la même page. connected à false signifie qu'aucune propriété Google n'est reliée pour ce fournisseur ; available à false signifie qu'elle est reliée mais que la lecture a échoué. Lu en direct depuis Google, donc une connexion établie à l'instant apparaît aussitôt. Nécessite État du site dans l'offre du site web ; sinon l'appel échoue avec un code 403.



## OpenAPI

````yaml fr/api-reference/openapi.json get /api/v1/seo/analytics
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/seo/analytics:
    get:
      tags:
        - Site Health
      summary: Obtenir les analyses d'État du site
      description: >-
        Chiffres en direct de Google Analytics 4, Google Search Console et des
        citations par l'IA pour un site web sur les 28 derniers jours complets,
        chacun à côté des 28 jours précédents (period donne les deux plages ;
        change_pct vaut null lorsque la période précédente était à zéro). ga4 :
        sessions issues de l'IA, leur taux d'engagement et leurs événements
        clés, sessions organiques et totales, part des sessions issues de l'IA
        en pourcentage, sessions IA quotidiennes, et le top 10 des sources IA,
        des pages de destination IA et des pages de destination organiques. gsc
        : clics, impressions, CTR en pourcentage et position moyenne, une série
        quotidienne, et le top 10 des requêtes et des pages. cited_pages : les
        pages du site web les plus citées par les réponses IA, avec les chiffres
        Google de la même page. connected à false signifie qu'aucune propriété
        Google n'est reliée pour ce fournisseur ; available à false signifie
        qu'elle est reliée mais que la lecture a échoué. Lu en direct depuis
        Google, donc une connexion établie à l'instant apparaît aussitôt.
        Nécessite État du site dans l'offre du site web ; sinon l'appel échoue
        avec un code 403.
      operationId: seoAnalytics.site
      parameters:
        - name: website_id
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Réussite
          content:
            application/json:
              schema:
                type: object
                properties:
                  period:
                    type: object
                    properties:
                      start_date:
                        type: string
                      end_date:
                        type: string
                      previous_start_date:
                        type: string
                      previous_end_date:
                        type: string
                    required:
                      - start_date
                      - end_date
                      - previous_start_date
                      - previous_end_date
                  ga4:
                    type: object
                    properties:
                      connected:
                        type: boolean
                      available:
                        type: boolean
                      property_name:
                        anyOf:
                          - type: string
                          - type: 'null'
                      ai_sessions:
                        type: object
                        properties:
                          current:
                            type: number
                          previous:
                            type: number
                          change_pct:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - current
                          - previous
                          - change_pct
                      ai_engagement_rate:
                        anyOf:
                          - type: number
                          - type: 'null'
                      ai_key_events:
                        type: object
                        properties:
                          current:
                            type: number
                          previous:
                            type: number
                          change_pct:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - current
                          - previous
                          - change_pct
                      organic_sessions:
                        type: object
                        properties:
                          current:
                            type: number
                          previous:
                            type: number
                          change_pct:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - current
                          - previous
                          - change_pct
                      total_sessions:
                        type: object
                        properties:
                          current:
                            type: number
                          previous:
                            type: number
                          change_pct:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - current
                          - previous
                          - change_pct
                      ai_share_pct:
                        anyOf:
                          - type: number
                          - type: 'null'
                      ai_daily:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                            value:
                              type: number
                          required:
                            - date
                            - value
                      sources:
                        type: array
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                            sessions:
                              type: number
                            previous:
                              type: number
                          required:
                            - name
                            - sessions
                            - previous
                      ai_landing_pages:
                        type: array
                        items:
                          type: object
                          properties:
                            url:
                              type: string
                            sessions:
                              type: number
                            previous:
                              type: number
                          required:
                            - url
                            - sessions
                            - previous
                      organic_landing_pages:
                        type: array
                        items:
                          type: object
                          properties:
                            url:
                              type: string
                            sessions:
                              type: number
                            key_events:
                              type: number
                          required:
                            - url
                            - sessions
                            - key_events
                    required:
                      - connected
                      - available
                      - property_name
                      - ai_sessions
                      - ai_engagement_rate
                      - ai_key_events
                      - organic_sessions
                      - total_sessions
                      - ai_share_pct
                      - ai_daily
                      - sources
                      - ai_landing_pages
                      - organic_landing_pages
                  gsc:
                    type: object
                    properties:
                      connected:
                        type: boolean
                      available:
                        type: boolean
                      site_url:
                        anyOf:
                          - type: string
                          - type: 'null'
                      clicks:
                        type: object
                        properties:
                          current:
                            type: number
                          previous:
                            type: number
                          change_pct:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - current
                          - previous
                          - change_pct
                      impressions:
                        type: object
                        properties:
                          current:
                            type: number
                          previous:
                            type: number
                          change_pct:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - current
                          - previous
                          - change_pct
                      ctr:
                        type: object
                        properties:
                          current:
                            type: number
                          previous:
                            type: number
                          change_pct:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - current
                          - previous
                          - change_pct
                      position:
                        type: object
                        properties:
                          current:
                            type: number
                          previous:
                            type: number
                          change_pct:
                            anyOf:
                              - type: number
                              - type: 'null'
                        required:
                          - current
                          - previous
                          - change_pct
                      daily:
                        type: array
                        items:
                          type: object
                          properties:
                            date:
                              type: string
                            clicks:
                              type: number
                            impressions:
                              type: number
                          required:
                            - date
                            - clicks
                            - impressions
                      queries:
                        type: array
                        items:
                          type: object
                          properties:
                            clicks:
                              type: number
                            impressions:
                              type: number
                            ctr:
                              type: number
                            position:
                              type: number
                            previous_clicks:
                              type: number
                            query:
                              type: string
                          required:
                            - clicks
                            - impressions
                            - ctr
                            - position
                            - previous_clicks
                            - query
                      pages:
                        type: array
                        items:
                          type: object
                          properties:
                            clicks:
                              type: number
                            impressions:
                              type: number
                            ctr:
                              type: number
                            position:
                              type: number
                            previous_clicks:
                              type: number
                            url:
                              type: string
                          required:
                            - clicks
                            - impressions
                            - ctr
                            - position
                            - previous_clicks
                            - url
                    required:
                      - connected
                      - available
                      - site_url
                      - clicks
                      - impressions
                      - ctr
                      - position
                      - daily
                      - queries
                      - pages
                  cited_pages:
                    type: object
                    properties:
                      available:
                        type: boolean
                      pages:
                        type: array
                        items:
                          type: object
                          properties:
                            url:
                              type: string
                            citations:
                              type: number
                            prompts:
                              type: number
                            ai_sessions:
                              anyOf:
                                - type: number
                                - type: 'null'
                            clicks:
                              anyOf:
                                - type: number
                                - type: 'null'
                            impressions:
                              anyOf:
                                - type: number
                                - type: 'null'
                            position:
                              anyOf:
                                - type: number
                                - type: 'null'
                          required:
                            - url
                            - citations
                            - prompts
                            - ai_sessions
                            - clicks
                            - impressions
                            - position
                    required:
                      - available
                      - pages
                required:
                  - period
                  - ga4
                  - gsc
                  - cited_pages
        '400':
          description: 'Requête incorrecte : échec de la validation'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Non authentifié
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: Interdit
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: Introuvable
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '409':
          description: Conflit
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '429':
          description: 'Limite atteinte : respectez Retry-After avant de réessayer'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
          headers:
            Retry-After:
              description: Secondes à attendre avant de réessayer
              schema:
                type: integer
                minimum: 1
        '500':
          description: Erreur interne
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  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.