> ## 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 tarea de recomendaciones de SEO

> Lee un trabajo guardado con acceso de lectura de contenido del sitio (lector o superior). Los resultados pueden incluir evidencias de los borradores enviados. Un resultado completado contiene recomendaciones basadas en fuentes, source_digest, uso de tokens y advertencias. El coste en dólares no está disponible expresamente. Los trabajos pendientes esperan capacidad; el tiempo en cola no hace caducar el análisis. Un fallo del trabajador devuelve un error estructurado; envía un request_id nuevo para reintentar. Consulta un subconjunto limitado y espacia las consultas mientras siga pendiente; comparten el presupuesto de solicitudes de API de la organización.



## OpenAPI

````yaml es/api-reference/openapi.json get /api/v1/seo/recommendations/{job_id}
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/recommendations/{job_id}:
    get:
      tags:
        - SEO Recommendations
      summary: Obtener tarea de recomendaciones de SEO
      description: >-
        Lee un trabajo guardado con acceso de lectura de contenido del sitio
        (lector o superior). Los resultados pueden incluir evidencias de los
        borradores enviados. Un resultado completado contiene recomendaciones
        basadas en fuentes, source_digest, uso de tokens y advertencias. El
        coste en dólares no está disponible expresamente. Los trabajos
        pendientes esperan capacidad; el tiempo en cola no hace caducar el
        análisis. Un fallo del trabajador devuelve un error estructurado; envía
        un request_id nuevo para reintentar. Consulta un subconjunto limitado y
        espacia las consultas mientras siga pendiente; comparten el presupuesto
        de solicitudes de API de la organización.
      operationId: seoRecommendations.get
      parameters:
        - name: job_id
          in: path
          required: true
          schema:
            type: string
        - name: website_id
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Correcto
          content:
            application/json:
              schema:
                type: object
                properties:
                  job_id:
                    type: string
                  status:
                    type: string
                    enum:
                      - pending
                      - running
                      - completed
                      - failed
                  created_at:
                    type: string
                  completed_at:
                    anyOf:
                      - type: string
                      - type: 'null'
                  result:
                    anyOf:
                      - type: object
                        properties:
                          contract_version:
                            enum:
                              - seo-recommendations/v1
                            type: string
                          source_digest:
                            type: string
                          recommendations:
                            type: array
                            items:
                              type: object
                              properties:
                                id:
                                  type: string
                                priority:
                                  type: string
                                  enum:
                                    - high
                                    - medium
                                    - low
                                category:
                                  type: string
                                  enum:
                                    - seo
                                    - aio
                                title:
                                  type: string
                                change:
                                  type: string
                                evidence:
                                  type: string
                                heading_path:
                                  type: array
                                  items:
                                    type: string
                              required:
                                - id
                                - priority
                                - category
                                - title
                                - change
                                - evidence
                                - heading_path
                          usage:
                            type: object
                            properties:
                              input_characters:
                                type: integer
                              input_tokens:
                                anyOf:
                                  - type: integer
                                  - type: 'null'
                              output_tokens:
                                anyOf:
                                  - type: integer
                                  - type: 'null'
                              provider_cost_usd:
                                anyOf:
                                  - type: number
                                  - type: 'null'
                              cost_status:
                                enum:
                                  - unavailable
                                type: string
                            required:
                              - input_characters
                              - input_tokens
                              - output_tokens
                              - provider_cost_usd
                              - cost_status
                          warnings:
                            type: array
                            items:
                              type: string
                        required:
                          - contract_version
                          - source_digest
                          - recommendations
                          - usage
                          - warnings
                      - type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                          message:
                            type: string
                        required:
                          - code
                          - message
                      - type: 'null'
                required:
                  - job_id
                  - status
                  - created_at
                  - completed_at
                  - result
                  - error
        '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 con el mismo ID de solicitud
          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.