---
title: "Retrieve recommendation"
method: GET
path: "/marketing/aeo/2027-03-beta/recommendations/{recommendationId}"
tags: ["Basic"]
---

# Retrieve recommendation

`GET /marketing/aeo/2027-03-beta/recommendations/{recommendationId}`

## Request

- Base URL: `https://api.hubapi.com`
- URL: `https://api.hubapi.com/marketing/aeo/2027-03-beta/recommendations/{recommendationId}`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `marketing.aeo.write`
  - OAuth 2
    - Authorization code: `https://app.hubspot.com/oauth/authorize`
    - Token URL: `https://api.hubapi.com/oauth/v1/token` scopes: `marketing.aeo.read`

Retrieve a specific recommendation by its unique identifier. This endpoint is useful for accessing detailed information about a particular recommendation within your HubSpot account.

## Path parameters

- `recommendationId` string, required

## Response `200`

successful operation

- PublicRecommendation
  - `actionCategory` 'CREATE_AD' | 'CREATE_CONTENT' | 'OUTREACH' | 'UPDATE_CONTENT' | 'UPDATE_ROBOTS': The category of action suggested by the recommendation. Valid values include 'CREATE_CONTENT', 'UPDATE_CONTENT', 'OUTREACH', and 'UPDATE_ROBOTS'.
  - `actionChannel` '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': The channel through which the recommended action should be taken. Valid values include 'YOUTUBE', 'LINKEDIN', 'REDDIT', 'AFFILIATE', 'PR', 'PEER', 'REVIEW_SITE', 'TECHNICAL_SEO', 'OWNED_CONTENT', 'LINKEDIN_ARTICLE', and 'LINKEDIN_POST'.
  - `answerEngine` 'CHATGPT' | 'CLAUDE' | 'GEMINI': The answer engine used to generate the recommendation. Valid values include 'CHATGPT', 'GEMINI', and 'CLAUDE'.
  - `associatedContentUrl` string: The URL of the content associated with the recommendation.
  - `contentTopic` string: A string representing the topic of the content related to the recommendation.
  - `contentType` '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': The type of content associated with the recommendation. Valid values include 'UNKNOWN', 'LISTICLE', 'COMPARISON', 'PRODUCT', 'BLOG', 'DOCUMENTATION', 'WIKI', 'NEWS', 'PR', 'RESEARCH', 'USER_REVIEW', 'SOCIAL', 'HOW_TO', 'GUIDE', 'EDUCATIONAL', 'HOMEPAGE', 'MULTIMEDIA', 'ARTICLE', and 'DOMAIN'.
  - `createdAt` string, date-time, required: The date and time when the recommendation was created, in ISO 8601 format.
  - `domain` string: The domain associated with the recommendation.
  - `endDate` string, date, required: The end date for the recommendation's relevance, formatted as a date.
  - `id` string, required: The unique identifier for the recommendation.
  - `influencingCitations` string[], required: An array of strings representing citations that influenced the recommendation.
  - `justification` string: The justification for why the recommendation was made.
  - `priority` 'HIGH' | 'LOW' | 'MEDIUM': The priority level of the recommendation. Valid values include 'HIGH', 'MEDIUM', and 'LOW'.
  - `promptIds` string[], required: An array of strings representing the IDs of prompts that influenced this recommendation.
  - `recommendationSummary` string: A summary of the recommendation provided.
  - `recommendationType` 'ADS' | 'CONTENT' | 'DOMAIN' | 'TECHNICAL' | 'URL', required: The type of recommendation provided. Valid values include 'DOMAIN', 'URL', 'TECHNICAL', and 'CONTENT'.
  - `startDate` string, date, required: The start date for the recommendation's relevance, formatted as a date.
  - `status` 'ARCHIVED' | 'COMPLETED' | 'DISMISSED' | 'DRAFT_CREATED' | 'FAILED' | 'IN_PROGRESS' | 'NEW', required: The current status of the recommendation. Valid values include 'NEW', 'IN_PROGRESS', 'COMPLETED', 'ARCHIVED', 'FAILED', 'DISMISSED', and 'DRAFT_CREATED'.
  - `url` string: The URL associated with the recommendation.

## Other responses

- `default`: An error occurred.

## Changes

- **2026-10-10** (2027-03-beta) `3e1835f1fe1d`: 2 info
  - the security scope `marketing.aeo.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `marketing.aeo.read` was removed from the endpoint's security scheme `oauth2`
- **2026-10-02** (2027-03-beta) `53bae9def894`: 2 info
  - the security scope `marketing.aeo.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `marketing.aeo.read` was removed from the endpoint's security scheme `oauth2`
- **2026-09-29** (2027-03-beta) `19a567d4b6bd`: 3 warning, 2 info
  - added the new `ADS` enum value to the `recommendationType` response property for the response status `200`
  - added the new `CHAT_GPT_ADS` enum value to the `actionChannel` response property for the response status `200`
  - added the new `CREATE_AD` enum value to the `actionCategory` response property for the response status `200`
  - the security scope `marketing.aeo.write` was added to the endpoint's security scheme `oauth2`
  - …1 more
- **2026-09-18** (2027-03-beta) `619ce091a93a`: 2 info
  - the security scope `marketing.aeo.write` was added to the endpoint's security scheme `oauth2`
  - the security scope `marketing.aeo.read` was removed from the endpoint's security scheme `oauth2`
- …earlier changes not shown

[Operation history](https://skmtc.dev/hubspot/apis/marketing-aeo/changes/marketing/aeo/2027-03-beta/recommendations/:recommendationId/get.md)

---

[API](https://skmtc.dev/hubspot/apis/marketing-aeo.md) - [All operations](https://skmtc.dev/hubspot/apis/marketing-aeo/llms.txt) - [OpenAPI document](https://skmtc.dev/hubspot/apis/marketing-aeo/revisions/3e1835f1fe1d?raw)