---
title: "List recommendations"
method: GET
path: "/marketing/aeo/2026-09-beta/recommendations"
tags: ["Basic"]
---

# List recommendations

`GET /marketing/aeo/2026-09-beta/recommendations`

Retrieve a list of recommendations from the AnswerEngineVisibilityPublicApi. This endpoint allows users to filter and sort recommendations based on various criteria such as prompt ID, status, and recommendation type. It supports pagination and sorting to efficiently manage large sets of data.

## Query parameters

- `after` string
- `createdAfter` string
- `createdAt` string
- `createdBefore` string
- `limit` integer
- `promptId` string
- `recommendationType` string
- `sort` string
- `status` string

## Response `200`

successful operation

- CollectionResponsePublicRecommendationForwardPaging
  - `paging` ForwardPaging
    - `next` NextPage — Specifies the paging information needed to retrieve the next set of results in a paginated API response
      - `after` string, required — A string token used as a cursor to retrieve the next set of results in a paginated response.
      - `link` string — A URL string pointing to the next page of results in the paginated response.
  - `results` PublicRecommendation[], required — An array of public recommendations. Each item in the array is a PublicRecommendation object.
    - `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)