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

# Obtener analíticas de Estado del sitio

> Cifras en vivo de Google Analytics 4, Google Search Console y citas de IA de un sitio web en los últimos 28 días completos, cada una junto a los 28 días anteriores (period indica ambos rangos; change_pct es null cuando el periodo anterior fue cero). ga4: sesiones procedentes de IA, su tasa de interacción y eventos clave, sesiones orgánicas y totales, cuota de sesiones de IA en porcentaje, sesiones de IA diarias y las 10 principales fuentes de IA, páginas de destino de IA y páginas de destino orgánicas. gsc: clics, impresiones, CTR en porcentaje y posición media, una serie diaria y las 10 principales consultas y páginas. cited_pages: las páginas del sitio web que más citan las respuestas de IA, con las cifras de Google de la misma página. connected en false significa que no hay ninguna propiedad de Google vinculada para ese proveedor; available en false significa que está vinculada pero la lectura falló. Se lee en vivo desde Google, así que una conexión hecha hace un momento aparece de inmediato. Requiere Estado del sitio en el plan del sitio web; de lo contrario, la llamada falla con 403.



## OpenAPI

````yaml es/api-reference/openapi.json get /api/v1/seo/analytics
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/seo/analytics:
    get:
      tags:
        - Site Health
      summary: Obtener analíticas de Estado del sitio
      description: >-
        Cifras en vivo de Google Analytics 4, Google Search Console y citas de
        IA de un sitio web en los últimos 28 días completos, cada una junto a
        los 28 días anteriores (period indica ambos rangos; change_pct es null
        cuando el periodo anterior fue cero). ga4: sesiones procedentes de IA,
        su tasa de interacción y eventos clave, sesiones orgánicas y totales,
        cuota de sesiones de IA en porcentaje, sesiones de IA diarias y las 10
        principales fuentes de IA, páginas de destino de IA y páginas de destino
        orgánicas. gsc: clics, impresiones, CTR en porcentaje y posición media,
        una serie diaria y las 10 principales consultas y páginas. cited_pages:
        las páginas del sitio web que más citan las respuestas de IA, con las
        cifras de Google de la misma página. connected en false significa que no
        hay ninguna propiedad de Google vinculada para ese proveedor; available
        en false significa que está vinculada pero la lectura falló. Se lee en
        vivo desde Google, así que una conexión hecha hace un momento aparece de
        inmediato. Requiere Estado del sitio en el plan del sitio web; de lo
        contrario, la llamada falla con 403.
      operationId: seoAnalytics.site
      parameters:
        - name: website_id
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Correcto
          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: 'Solicitud incorrecta: la validación ha fallado'
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '401':
          description: Sin autenticar
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '403':
          description: Acceso denegado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '404':
          description: No encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '409':
          description: Conflicto
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
        '429':
          description: >-
            Límite de solicitudes alcanzado: respeta Retry-After antes de
            reintentar
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
          headers:
            Retry-After:
              description: Segundos que debes esperar antes de reintentar
              schema:
                type: integer
                minimum: 1
        '500':
          description: Error interno
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error
components:
  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.