Docs
Buscar documentación...⌘K

Publicaciones

API + MCP
GET/v3/social-media/posts

Las solicitudes a este endpoint son gratuitas y no consumen ninguna unidad de API.

Parámetros de consulta

statusstringObligatorio

La fase del ciclo de vida editorial de la publicación.

Valores permitidos:publishedscheduleddraftfaileddeleted
channel_idsstring

Lista de identificadores de canales separados por comas para filtrar.

author_idsstring

Lista de identificadores de usuario de los autores, separados por comas, para filtrar.

search_querystring

Consulta de búsqueda de texto para filtrar publicaciones por contenido.

date_fromstring (date)

La fecha de inicio del periodo histórico, en formato AAAA-MM-DD.

date_tostring (date)

La fecha de fin del periodo histórico, en formato AAAA-MM-DD.

order_bystring

Campo por el que ordenar las publicaciones. La ordenación basada en métricas solo se aplica a las publicaciones publicadas.

Valores permitidos:dateviewsunique_viewscommentslikes
order_directionstring

El orden en que se devuelven los resultados, ascendente o descendente.

Valores permitidos:ascdesc
limitinteger

El número de resultados que se devolverán.

Opción predeterminada:50
offsetinteger

El número de resultados que se deben omitir.

Opción predeterminada:0
outputstring

El formato de salida.

Valores permitidos:jsonphp

Respuestas

postsarray<object>
author_idstring or null

Identificador único del autor.

author_namestring or null

Nombre del autor.

auto_commentstring or null

Texto del comentario automático publicado tras la publicación.

channelsarray<object>

Canales de redes sociales asociados a la publicación.

channel_idstring
channel_kindstring
channel_usernamestring
channel_display_namestring
channel_profile_image_urlstring (url) or null
created_atstring (date-time)

Marca de tiempo de cuando el autor creó la publicación.

external_post_idstring or null

Identificador de publicación específico de la plataforma.

permalinkstring or null

URL de la publicación en la plataforma.

post_idinteger

Identificador único de la publicación.

status_timestampstring

Marca de tiempo asociada al estado actual.

text_contentstring

Contenido de texto de la publicación.