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

# Récupérer la tâche de recommandations SEO

> Lit une tâche enregistrée avec accès en consultation du contenu (lecteur ou supérieur). Les résultats peuvent contenir les éléments de brouillons soumis. Un résultat terminé inclut recommandations fondées sur les sources, source_digest, consommation de jetons et avertissements. Le coût monétaire est explicitement indisponible. Les tâches attendent la capacité des workers ; le temps en file ne fait pas expirer une analyse. Un worker en échec renvoie une erreur structurée ; soumettez un nouveau request_id pour réessayer. Interrogez un sous-ensemble borné et espacez si pending ; le suivi partage le budget API de l’organisation.



## OpenAPI

````yaml fr/api-reference/openapi.json get /api/v1/seo/recommendations/{job_id}
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/recommendations/{job_id}:
    get:
      tags:
        - SEO Recommendations
      summary: Récupérer la tâche de recommandations SEO
      description: >-
        Lit une tâche enregistrée avec accès en consultation du contenu (lecteur
        ou supérieur). Les résultats peuvent contenir les éléments de brouillons
        soumis. Un résultat terminé inclut recommandations fondées sur les
        sources, source_digest, consommation de jetons et avertissements. Le
        coût monétaire est explicitement indisponible. Les tâches attendent la
        capacité des workers ; le temps en file ne fait pas expirer une analyse.
        Un worker en échec renvoie une erreur structurée ; soumettez un nouveau
        request_id pour réessayer. Interrogez un sous-ensemble borné et espacez
        si pending ; le suivi partage le budget API de l’organisation.
      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: Réussite
          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: '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 avec le
            même identifiant de requête
          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.