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

# Listar problemas de Estado del sitio

> Lista los problemas de Estado del sitio de un sitio web: un grupo por tipo de problema (check) con su título, por qué importa, gravedad (critical, warning, opportunity), prioridad (high, medium, low), responsable (writer, developer o either; null si se desconoce), esfuerzo (minutes, hours, days), si afecta a todo el sitio, recuentos de páginas afectadas por estado (open, in_progress, fixed, verified, dismissed), hasta tres secciones en las que se concentra y páginas afectadas de muestra con el detalle, la recomendación, la evidencia, la persona asignada y task_revision de cada página. Filtra por estado, check, un término de búsqueda, las URL almacenadas de páginas concretas (page_urls) o assignee "me" (solo conexiones con sesión iniciada). Los grupos se paginan: page empieza en 0, page_size es 25 por defecto (máximo 200) y total cuenta los grupos que coinciden; counts suma las páginas por estado de todo el sitio, ignorando el filtro de estado. Un grupo incluye como máximo 50 páginas de muestra (10 cuando lo llama una herramienta, lo que también limita page_size a 25); has_more_pages indica que el resto se lee con la lectura de páginas del problema (get_site_health_issue_pages o POST /v1/seo/issues/pages), cuya página 0 repite las páginas de muestra. has_evidence en false significa que el sitio nunca se ha rastreado ni auditado. 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 post /api/v1/seo/issues
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/issues:
    post:
      tags:
        - Site Health
      summary: Listar problemas de Estado del sitio
      description: >-
        Lista los problemas de Estado del sitio de un sitio web: un grupo por
        tipo de problema (check) con su título, por qué importa, gravedad
        (critical, warning, opportunity), prioridad (high, medium, low),
        responsable (writer, developer o either; null si se desconoce), esfuerzo
        (minutes, hours, days), si afecta a todo el sitio, recuentos de páginas
        afectadas por estado (open, in_progress, fixed, verified, dismissed),
        hasta tres secciones en las que se concentra y páginas afectadas de
        muestra con el detalle, la recomendación, la evidencia, la persona
        asignada y task_revision de cada página. Filtra por estado, check, un
        término de búsqueda, las URL almacenadas de páginas concretas
        (page_urls) o assignee "me" (solo conexiones con sesión iniciada). Los
        grupos se paginan: page empieza en 0, page_size es 25 por defecto
        (máximo 200) y total cuenta los grupos que coinciden; counts suma las
        páginas por estado de todo el sitio, ignorando el filtro de estado. Un
        grupo incluye como máximo 50 páginas de muestra (10 cuando lo llama una
        herramienta, lo que también limita page_size a 25); has_more_pages
        indica que el resto se lee con la lectura de páginas del problema
        (get_site_health_issue_pages o POST /v1/seo/issues/pages), cuya página 0
        repite las páginas de muestra. has_evidence en false significa que el
        sitio nunca se ha rastreado ni auditado. Requiere Estado del sitio en el
        plan del sitio web; de lo contrario, la llamada falla con 403.
      operationId: seoIssues.list
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                website_id:
                  type: string
                status:
                  type: string
                  enum:
                    - open
                    - in_progress
                    - fixed
                    - verified
                    - dismissed
                check:
                  type: string
                search:
                  type: string
                assignee:
                  enum:
                    - me
                  type: string
                page:
                  type: integer
                page_urls:
                  type: array
                  items:
                    type: string
                page_size:
                  type: integer
              required:
                - website_id
      responses:
        '200':
          description: Correcto
          content:
            application/json:
              schema:
                type: object
                properties:
                  groups:
                    type: array
                    items:
                      type: object
                      properties:
                        check:
                          type: string
                        title:
                          type: string
                        why_it_matters:
                          anyOf:
                            - type: string
                            - type: 'null'
                        owner:
                          anyOf:
                            - type: string
                              enum:
                                - writer
                                - developer
                                - either
                            - type: 'null'
                        effort:
                          anyOf:
                            - type: string
                              enum:
                                - minutes
                                - hours
                                - days
                            - type: 'null'
                        bucket:
                          type: string
                          enum:
                            - technical_cleanup
                            - content_restructuring
                            - content_enrichment
                        severity:
                          type: string
                          enum:
                            - critical
                            - warning
                            - opportunity
                        priority:
                          type: string
                          enum:
                            - high
                            - medium
                            - low
                        site_wide:
                          type: boolean
                        counts:
                          type: object
                          properties:
                            open:
                              type: integer
                            in_progress:
                              type: integer
                            fixed:
                              type: integer
                            verified:
                              type: integer
                            dismissed:
                              type: integer
                          required:
                            - open
                            - in_progress
                            - fixed
                            - verified
                        sections:
                          type: array
                          items:
                            type: object
                            properties:
                              section:
                                type: string
                              open:
                                type: integer
                              audited:
                                type: integer
                            required:
                              - section
                              - open
                              - audited
                        pages:
                          type: array
                          items:
                            type: object
                            properties:
                              finding_id:
                                type: string
                              page_id:
                                type: string
                              property_id:
                                type: string
                              url:
                                type: string
                              status:
                                type: string
                                enum:
                                  - open
                                  - in_progress
                                  - fixed
                                  - verified
                                  - dismissed
                              page_title:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              detail:
                                type: string
                              recommendation:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              shared_value:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              evidence:
                                type: array
                                items:
                                  type: string
                              evidence_links:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    label:
                                      type: string
                                    url:
                                      type: string
                                  required:
                                    - label
                                    - url
                              robots_txt_rule:
                                anyOf:
                                  - type: object
                                    properties:
                                      url:
                                        type: string
                                      line:
                                        type: integer
                                      excerpt:
                                        type: array
                                        items:
                                          type: object
                                          properties:
                                            line:
                                              type: integer
                                            text:
                                              type: string
                                          required:
                                            - line
                                            - text
                                    required:
                                      - url
                                      - line
                                      - excerpt
                                  - type: 'null'
                              first_seen_at:
                                type: string
                              last_seen_at:
                                type: string
                              resolved_at:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              last_checked_at:
                                anyOf:
                                  - type: string
                                  - type: 'null'
                              assignee:
                                anyOf:
                                  - type: object
                                    properties:
                                      id:
                                        type: string
                                      name:
                                        type: string
                                    required:
                                      - id
                                      - name
                                  - type: 'null'
                              task_revision:
                                type: integer
                              draft:
                                anyOf:
                                  - type: object
                                    properties:
                                      run_id:
                                        type: string
                                      status:
                                        type: string
                                    required:
                                      - run_id
                                      - status
                                  - type: 'null'
                            required:
                              - finding_id
                              - page_id
                              - property_id
                              - url
                              - status
                              - page_title
                              - detail
                              - recommendation
                              - shared_value
                              - evidence
                              - evidence_links
                              - robots_txt_rule
                              - first_seen_at
                              - last_seen_at
                              - resolved_at
                              - last_checked_at
                              - assignee
                              - task_revision
                              - draft
                        has_more_pages:
                          type: boolean
                      required:
                        - check
                        - title
                        - why_it_matters
                        - owner
                        - effort
                        - bucket
                        - severity
                        - priority
                        - site_wide
                        - counts
                        - sections
                        - pages
                        - has_more_pages
                  total:
                    type: integer
                  counts:
                    type: object
                    properties:
                      open:
                        type: integer
                      in_progress:
                        type: integer
                      fixed:
                        type: integer
                      verified:
                        type: integer
                      dismissed:
                        type: integer
                    required:
                      - open
                      - in_progress
                      - fixed
                      - verified
                  page_size:
                    type: integer
                  has_evidence:
                    type: boolean
                required:
                  - groups
                  - total
                  - counts
                  - page_size
                  - has_evidence
        '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.