Skip to main content
GET
Obtener recomendación

Supported products

Autorizaciones

Authorization
string
header
requerido

The access token received from the authorization server in the OAuth 2.0 flow.

FlowAuthorization Code
Authorization URL
https://app.hubspot.com/oauth/authorize
Token URL
https://api.hubapi.com/oauth/v1/token
Scopes1
marketing.aeo.write

Parámetros de ruta

recommendationId
string
requerido

Respuesta

successful operation

createdAt
string<date-time>
requerido

La fecha y hora en que se creó la recomendación, en formato ISO 8601.

endDate
string<date>
requerido

La fecha de finalización de la relevancia de la recomendación, con formato de fecha.

id
string
requerido

El identificador único de la recomendación.

influencingCitations
string[]
requerido

Un conjunto de cadenas que representan las citas que influyeron en la recomendación.

promptIds
string[]
requerido

Una matriz de cadenas que representan los ID de los prompts que influyeron en esta recomendación.

recommendationType
enum<string>
requerido

El tipo de recomendación proporcionada. Los valores válidos incluyen "DOMAIN", "URL", "TECHNICAL" y "CONTENT".

Opciones disponibles:
CONTENT,
DOMAIN,
TECHNICAL,
URL
startDate
string<date>
requerido

La fecha de inicio de la relevancia de la recomendación, con formato de fecha.

status
enum<string>
requerido

El estado actual de la recomendación. Los valores válidos incluyen "NEW", "IN_PROGRESS", "COMPLETED", "ARCHIVED", "FAILED", "DISMISSED" y "DRAFT_CREATED".

Opciones disponibles:
ARCHIVED,
COMPLETED,
DISMISSED,
DRAFT_CREATED,
FAILED,
IN_PROGRESS,
NEW
actionCategory
enum<string>

La categoría de acción sugerida por la recomendación. Los valores válidos incluyen "CREATE_CONTENT", "UPDATE_CONTENT", "OUTREACH" y "UPDATE_ROBOTS".

Opciones disponibles:
CREATE_CONTENT,
OUTREACH,
UPDATE_CONTENT,
UPDATE_ROBOTS
actionChannel
enum<string>

El canal a través del cual se debe realizar la acción recomendada. Los valores válidos incluyen "YOUTUBE", "LINKEDIN", "REDDIT", "AFFILIATE", "PR", "PEER", "REVIEW_SITE", "TECHNICAL_SEO", "OWNED_CONTENT", "LINKEDIN_ARTICLE" y "LINKEDIN_POST".

Opciones disponibles:
AFFILIATE,
CONTENT_SITE_AUDIT,
LINKEDIN,
LINKEDIN_ARTICLE,
LINKEDIN_POST,
OWNED_CONTENT,
PEER,
PR,
REDDIT,
REDDIT_SUBREDDIT,
REVIEW_SITE,
TECHNICAL_SITE_AUDIT,
YOUTUBE
answerEngine
enum<string>

El motor de respuestas utilizado para generar la recomendación. Los valores válidos incluyen "CHATGPT", "GEMINI" y "CLAUDE".

Opciones disponibles:
CHATGPT,
CLAUDE,
GEMINI
associatedContentUrl
string

La URL del contenido asociado con la recomendación.

contentTopic
string

Una cadena que representa el tema del contenido relacionado con la recomendación.

contentType
enum<string>

El tipo de contenido asociado a la recomendación. Los valores válidos incluyen "UNKNOWN", "LISTICLE", "COMPARISON", "PRODUCT", "BLOG", "DOCUMENTATION", "WIKI", "NEWS", "PR", "RESEARCH", "USER_REVIEW", "SOCIAL", "HOW_TO", "GUIDE", "EDUCATIONAL", "HOMEPAGE", "MULTIMEDIA", "ARTICLE" y "DOMAIN".

Opciones disponibles:
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
domain
string

El dominio asociado con la recomendación.

justification
string

La justificación de por qué se hizo la recomendación.

priority
enum<string>

El nivel de prioridad de la recomendación. Los valores válidos incluyen "HIGH", "MEDIUM" y "LOW".

Opciones disponibles:
HIGH,
LOW,
MEDIUM
recommendationSummary
string

Un resumen de la recomendación proporcionada.

url
string

La URL asociada con la recomendación.

Última modificación el 6 de octubre de 2026