Docs
Pesquisar na documentação...⌘K

Postagens

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

As solicitações para este endpoint são gratuitas e não consomem unidades da API.

Parâmetros de consulta

statusstringObrigatório

A etapa do ciclo de vida de publicação do post.

Valores permitidos:publishedscheduleddraftfaileddeleted
channel_idsstring

Lista de IDs de canais, separados por vírgulas, para usar como filtro.

author_idsstring

Lista de IDs de usuário dos autores, separados por vírgulas, para usar como filtro.

search_querystring

Consulta de pesquisa textual para filtrar posts por conteúdo.

date_fromstring (date)

A data de início do período histórico, no formato YYYY-MM-DD.

date_tostring (date)

A data de término do período histórico, no formato YYYY-MM-DD.

order_bystring

Campo de ordenação dos posts. A ordenação baseada em métricas se aplica apenas a posts publicados.

Valores permitidos:dateviewsunique_viewscommentslikes
order_directionstring

A ordem em que os resultados são retornados, em ordem crescente ou decrescente.

Valores permitidos:ascdesc
limitinteger

O número de resultados a retornar.

Padrão:50
offsetinteger

O número de resultados a serem ignorados.

Padrão:0
outputstring

O formato de saída.

Valores permitidos:jsonphp

Respostas

postsarray<object>
author_idstring or null

Identificador único do autor.

author_namestring or null

Nome do autor.

auto_commentstring or null

Texto do comentário automático publicado após a publicação.

channelsarray<object>

Canais de mídia social associados à publicação.

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

Carimbo de data/hora em que o autor criou a publicação.

external_post_idstring or null

Identificador de publicação específico da plataforma.

permalinkstring or null

URL da publicação na plataforma.

post_idinteger

Identificador único da postagem.

status_timestampstring

Registro de data e hora associado ao status atual.

text_contentstring

Conteúdo de texto da publicação.