> ## Documentation Index > Fetch the complete documentation index at: https://br.developers.hubspot.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve recommendation > Recupere uma recomendação específica pelo seu identificador exclusivo. Este endpoint é útil para acessar informações detalhadas sobre uma recomendação específica na sua conta HubSpot. > **Supported products** > **Required Scopes** ## OpenAPI ````yaml specs/2027-03-beta/marketing-aeo-v2027-03-beta.json GET /marketing/aeo/2027-03-beta/recommendations/{recommendationId} 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/{recommendationId}: get: tags: - Basic summary: Recuperar recomendação description: >- Recupere uma recomendação específica pelo seu identificador exclusivo. Este endpoint é útil para acessar informações detalhadas sobre uma recomendação específica na sua conta HubSpot. operationId: get-/marketing/aeo/2027-03-beta/recommendations/{recommendationId} parameters: - name: recommendationId in: path description: '' required: true style: simple explode: false schema: type: string responses: '200': description: successful operation content: application/json: schema: $ref: '#/components/schemas/PublicRecommendation' default: $ref: '#/components/responses/Error' description: '' security: - oauth2: - marketing.aeo.write - oauth2: - marketing.aeo.read components: schemas: PublicRecommendation: required: - createdAt - endDate - id - influencingCitations - promptIds - recommendationType - startDate - status type: object properties: actionCategory: type: string description: >- A categoria de ação sugerida pela recomendação. Os valores válidos incluem "CREATE_CONTENT", "UPDATE_CONTENT", "OUTREACH" e "UPDATE_ROBOTS". enum: - CREATE_AD - CREATE_CONTENT - OUTREACH - UPDATE_CONTENT - UPDATE_ROBOTS actionChannel: type: string description: >- O canal pelo qual a ação recomendada deve ser tomada. Os valores válidos incluem 'YOUTUBE', 'LINKEDIN', 'REDDIT', 'AFFILIATE', 'PR', 'PEER', 'REVIEW_SITE', 'TECHNICAL_SEO', 'OWNED_CONTENT', 'LINKEDIN_ARTICLE' e '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: >- O mecanismo de resposta usado para gerar a recomendação. Os valores válidos incluem "CHATGPT", "GEMINI" e "CLAUDE". enum: - CHATGPT - CLAUDE - GEMINI associatedContentUrl: type: string description: O URL do conteúdo associado à recomendação. contentTopic: type: string description: >- Uma string que representa o tópico do conteúdo relacionado à recomendação. contentType: type: string description: >- O tipo de conteúdo associado à recomendação. Os valores válidos incluem "UNKNOWN", "LISTICLE", "COMPARISON", "PRODUCT", "BLOG", "DOCUMENTATION", "WIKI", "NEWS", "PR", "RESEARCH", "USER_REVIEW", "SOCIAL", "HOW_TO", "GUIDE", "EDUCATIONAL", "HOMEPAGE", "MULTIMEDIA", "ARTICLE" e "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: A data e hora em que a recomendação foi criada, no formato ISO 8601. format: date-time domain: type: string description: O domínio associado à recomendação. endDate: type: string description: A data final da relevância da recomendação, formatada como data. format: date id: type: string description: O identificador exclusivo da recomendação. influencingCitations: type: array description: >- Uma matriz de strings que representam citações que influenciaram a recomendação. items: type: string justification: type: string description: A justificativa para a recomendação. priority: type: string description: >- O nível de prioridade da recomendação. Os valores válidos incluem "HIGH", "MEDIUM" e "LOW". enum: - HIGH - LOW - MEDIUM promptIds: type: array description: >- Uma matriz de strings que representam os IDs dos prompts que influenciaram esta recomendação. items: type: string recommendationSummary: type: string description: Um resumo da recomendação fornecida. recommendationType: type: string description: >- O tipo de recomendação fornecida. Os valores válidos incluem "DOMAIN", "URL", "TECHNICAL" e "CONTENT". enum: - ADS - CONTENT - DOMAIN - TECHNICAL - URL startDate: type: string description: A data de início da relevância da recomendação, formatada como data. format: date status: type: string description: >- O status atual da recomendação. Os valores válidos incluem "NEW", "IN_PROGRESS", "COMPLETED", "ARCHIVED", "FAILED", "DISMISSED" e "DRAFT_CREATED". enum: - ARCHIVED - COMPLETED - DISMISSED - DRAFT_CREATED - FAILED - IN_PROGRESS - NEW url: type: string description: O URL associado à recomendação. Error: required: - category - correlationId - message type: object properties: category: type: string description: A categoria de erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: >- {invalidPropertyName=[propertyValue], missingScopes=[scope1, scope2]} correlationId: type: string description: >- Um identificador exclusivo para a solicitação. Inclua este valor em relatórios de erro ou tickets de suporte format: uuid example: aeb5f871-7f07-4993-9211-075dc63e7cbf errors: type: array description: mais informações sobre o erro items: $ref: '#/components/schemas/ErrorDetail' links: type: object additionalProperties: type: string description: >- Um mapa de nomes de links para URIs associados que contêm documentação sobre o erro ou as etapas de correção recomendadas message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado example: An error occurred subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa uma resposta de erro retornada pela API quando uma operação falha. Este componente é usado em vários endpoints para fornecer informações detalhadas sobre o erro encontrado. 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 ErrorDetail: required: - message type: object properties: code: type: string description: O código de status associado ao detalhe do erro context: type: object additionalProperties: type: array items: type: string description: Contexto sobre a condição do erro example: '{missingScopes=[scope1, scope2]}' in: type: string description: O nome do campo ou parâmetro no qual o erro foi encontrado. message: type: string description: >- Uma mensagem legível por humanos que descreve o erro, juntamente com as etapas de correção, quando apropriado subCategory: type: string description: >- Uma categoria específica que contém mais detalhes específicos sobre o erro description: >- Representa informações detalhadas sobre um erro ocorrido na API. Este componente é usado para fornecer contexto e detalhes adicionais sobre os erros, geralmente como parte de uma resposta de erro. 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: '' ````