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

# Retrieve recommendation

`GET /marketing/aeo/2026-09-beta/recommendations/{recommendationId}`

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_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' | 'CONTENT_SITE_AUDIT' | 'LINKEDIN' | 'LINKEDIN_ARTICLE' | 'LINKEDIN_POST' | 'OWNED_CONTENT' | 'PEER' | 'PR' | 'REDDIT' | '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` '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.

---

[API](https://skmtc.net/hubspot/apis/marketing-aeo.md) · [All operations](https://skmtc.net/hubspot/apis/marketing-aeo/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/marketing-aeo/revisions/511ca1e59a4c/schema)
