> ## Documentation Index > Fetch the complete documentation index at: https://developers.hubspot.fr/docs/llms.txt > Use this file to discover all available pages before exploring further. # List recommendations > Récupérer une liste de recommandations depuis l'AnswerEngineVisibilityPublicApi. Ce point de terminaison permet aux utilisateurs de filtrer et de trier les recommandations en fonction de divers critères tels que l'ID du prompt, le statut et le type de recommandation. Il prend en charge la pagination et le tri pour gérer efficacement de grands ensembles de données. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2027-03-beta/marketing-aeo-v2027-03-beta.json GET /marketing/aeo/2027-03-beta/recommendations openapi: 3.0.1 info: title: Marketing Aeo description: Basepom for all HubSpot Projects version: 2027-03-beta x-hubspot-product-tier-requirements: marketing: FREE sales: FREE service: FREE cms: FREE commerce: FREE crmHub: FREE dataHub: FREE servers: - url: https://api.hubapi.com security: [] tags: - name: Basic paths: /marketing/aeo/2027-03-beta/recommendations: get: tags: - Basic summary: Lister les recommandations description: >- Récupérer une liste de recommandations depuis l'AnswerEngineVisibilityPublicApi. Ce point de terminaison permet aux utilisateurs de filtrer et de trier les recommandations en fonction de divers critères tels que l'ID du prompt, le statut et le type de recommandation. Il prend en charge la pagination et le tri pour gérer efficacement de grands ensembles de données. operationId: get-/marketing/aeo/2027-03-beta/recommendations parameters: - name: after in: query description: "Le jeton de curseur de pagination de la dernière ressource lue avec succès sera renvoyé en tant que propriété JSON «\_paging.next.after\_» d'une réponse paginée contenant plus de résultats." required: false style: form explode: true schema: type: string - name: createdAfter in: query description: '' required: false style: form explode: true schema: type: string - name: createdAt in: query description: '' required: false style: form explode: true schema: type: string - name: createdBefore in: query description: '' required: false style: form explode: true schema: type: string - name: limit in: query description: Le nombre maximum de résultats à afficher par page. required: false style: form explode: true schema: type: integer format: int32 - name: promptId in: query description: '' required: false style: form explode: true schema: type: string - name: recommendationType in: query description: '' required: false style: form explode: true schema: type: string - name: sort in: query description: '' required: false style: form explode: true schema: type: string - name: status in: query description: '' required: false style: form explode: true schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: >- #/components/schemas/CollectionResponsePublicRecommendationForwardPaging default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - marketing.aeo.write - oauth2: - marketing.aeo.read components: schemas: CollectionResponsePublicRecommendationForwardPaging: required: - results type: object properties: paging: $ref: '#/components/schemas/ForwardPaging' results: type: array description: >- Un tableau de recommandations publiques. Chaque élément du tableau est un objet PublicRecommendation. items: $ref: '#/components/schemas/PublicRecommendation' ForwardPaging: type: object properties: next: $ref: '#/components/schemas/NextPage' description: "Informations de pagination pour une pagination unidirectionnelle. Contient la référence de la page suivante lorsque d'autres résultats sont disponibles\_; omis ou vide sur la dernière page." PublicRecommendation: required: - createdAt - endDate - id - influencingCitations - promptIds - recommendationType - startDate - status type: object properties: actionCategory: type: string description: "La catégorie d’action suggérée par la recommandation. Les valeurs valides incluent «\_CREATE_CONTENT\_», «\_UPDATE_CONTENT\_», «\_OUTREACH\_» et «\_UPDATE_ROBOTS\_»." enum: - CREATE_AD - CREATE_CONTENT - OUTREACH - UPDATE_CONTENT - UPDATE_ROBOTS actionChannel: type: string description: "Le canal par lequel l'action recommandée doit être effectuée. Les valeurs valides incluent «\_YOUTUBE\_», «\_LINKEDIN\_», «\_REDDIT\_», «\_AFFILIATE\_», «\_PR\_», «\_PEER\_», «\_REVIEW_SITE\_», «\_TECHNICAL_SEO\_», «\_OWNED_CONTENT\_», «\_LINKEDIN_ARTICLE\_» et «\_LINKEDIN_POST\_»." enum: - AFFILIATE - CHAT_GPT_ADS - CONTENT_SITE_AUDIT - LINKEDIN - LINKEDIN_ARTICLE - LINKEDIN_POST - OWNED_CONTENT - PEER - PR - REDDIT - REDDIT_SUBREDDIT - REVIEW_SITE - TECHNICAL_SITE_AUDIT - YOUTUBE answerEngine: type: string description: >- Le moteur IA utilisé pour générer la recommandation. Les valeurs valides incluent « CHATGPT », « GEMINI » et « CLAUDE ». enum: - CHATGPT - CLAUDE - GEMINI associatedContentUrl: type: string description: L'URL du contenu associé à la recommandation. contentTopic: type: string description: Une chaîne représentant le sujet du contenu lié à la recommandation. contentType: type: string description: "Le type de contenu associé à la recommandation. Les valeurs valides incluent «\_UNKNOWN\_», «\_LISTICLE\_», «\_COMPARISON\_», «\_PRODUCT\_», «\_BLOG\_», «\_DOCUMENTATION\_», «\_WIKI\_», «\_NEWS\_», «\_PR\_», «\_RESEARCH\_», «\_USER_REVIEW\_», «\_SOCIAL\_», «\_HOW_TO\_», «\_GUIDE\_», «\_EDUCATIONAL\_», «\_HOMEPAGE\_», «\_MULTIMEDIA\_», «\_ARTICLE\_» et «\_DOMAIN\_»." enum: - ARTICLE - BLOG - COMPARISON - DOCUMENTATION - DOMAIN - EDUCATIONAL - GUIDE - HOMEPAGE - HOW_TO - LISTICLE - LISTICLE_COMPARISON - LISTICLE_EDUCATIONAL - MULTIMEDIA - NEWS - PR - PRODUCT - RESEARCH - SOCIAL - UNKNOWN - USER_REVIEW - WIKI createdAt: type: string description: >- La date et l'heure de création de la recommandation, au format ISO 8601. format: date-time domain: type: string description: Le domaine associé à la recommandation. endDate: type: string description: >- La date de fin de pertinence de la recommandation, formatée comme une date. format: date id: type: string description: L'identifiant unique de la recommandation. influencingCitations: type: array description: >- Un tableau de chaînes de caractères représentant les citations qui ont influencé la recommandation. items: type: string justification: type: string description: La justification de la recommandation. priority: type: string description: "Le niveau de priorité de la recommandation. Les valeurs valides sont «\_HIGH\_», «\_MEDIUM\_» et «\_LOW\_»." enum: - HIGH - LOW - MEDIUM promptIds: type: array description: >- Un ensemble de chaînes représentant les ID des prompts qui ont influencé cette recommandation. items: type: string recommendationSummary: type: string description: Un résumé de la recommandation fournie. recommendationType: type: string description: "Le type de recommandation fourni. Les valeurs valides incluent «\_DOMAIN\_», «\_URL\_», «\_TECHNICAL\_» et «\_CONTENT\_»." enum: - ADS - CONTENT - DOMAIN - TECHNICAL - URL startDate: type: string description: >- La date de début pour la pertinence de la recommandation, au format de date. format: date status: type: string description: "Le statut actuel de la recommandation. Les valeurs valides incluent «\_NEW\_», «\_IN_PROGRESS\_», «\_COMPLETED\_», «\_ARCHIVED\_», «\_FAILED\_», «\_DISMISSED\_» et «\_DRAFT_CREATED\_»." enum: - ARCHIVED - COMPLETED - DISMISSED - DRAFT_CREATED - FAILED - IN_PROGRESS - NEW url: type: string description: L'URL associée à la recommandation. Error: required: - category - correlationId - message type: object properties: category: type: string description: La catégorie d'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Un identifiant unique pour la demande. Incluez cette valeur dans tous les rapports d'erreurs ou tickets d'assistance format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: informations supplémentaires à propos de l'erreur items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Une carte des noms de liens vers les URI associés contenant de la documentation sur l'erreur ou les mesures correctives recommandées message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant example: An error occurred subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente une réponse d'erreur renvoyée par l'API lorsqu'une opération échoue. Ce composant est utilisé dans divers points de terminaison pour fournir des informations détaillées sur l'erreur rencontrée. example: message: Invalid input (details will vary based on the error) correlationId: aeb5f871-7f07-4993-9211-075dc63e7cbf category: VALIDATION_ERROR links: knowledge-base: https://www.hubspot.com/products/service/knowledge-base NextPage: required: - after type: object properties: after: type: string description: >- Un jeton de chaîne utilisé comme curseur pour récupérer l'ensemble de résultats suivant dans une réponse paginée. link: type: string description: >- Chaîne d'URL pointant vers la page de résultats suivante dans la réponse paginée. description: >- Specifies the paging information needed to retrieve the next set of results in a paginated API response ErrorDetail: required: - message type: object properties: code: type: string description: Le code du statut associé au détail de l'erreur context: type: object additionalProperties: type: array items: type: string description: Contexte concernant la condition d'erreur example: '{missingScopes=[scope1, scope2]}' in: type: string description: >- Le nom du champ ou du paramètre dans lequel l'erreur a été détectée. Il s'agit d'une propriété de type chaîne de caractères. message: type: string description: >- Un message lisible par la personne décrivant l'erreur ainsi que les mesures correctives possibles, le cas échéant subCategory: type: string description: >- Une catégorie spécifique qui contient des détails plus précis sur l'erreur description: >- Représente des informations détaillées sur une erreur survenue dans l'API. Ce composant est utilisé pour fournir un contexte et des spécificités supplémentaires sur les erreurs, généralement dans le cadre d'une réponse d'erreur. responses: Error: description: An error occurred. content: '*/*': schema: $ref: '#/components/schemas/Error' securitySchemes: oauth2: type: oauth2 flows: authorizationCode: authorizationUrl: https://app.hubspot.com/oauth/authorize tokenUrl: https://api.hubapi.com/oauth/v1/token scopes: marketing.aeo.read: '' marketing.aeo.write: '' ````