Listar desempenho dos posts do canal
Classifica os posts do canal no período (feitos no PostClean ou não) por uma métrica, do melhor para o pior, e retorna os 50 primeiros, uma página por vez. O tamanho da página é definido pelo servidor: leia meta.per_page. A resposta também traz os filters que o servidor aplicou. Posts sem a métrica ficam por último. Mesmo fuso horário, filtros, limite de datas e regra de 404 de GET /channels/{account}/insights.
Authorizations
Chave de API do workspace, criada em Configurações > Chaves de API.
Path Parameters
Id da conta social (canal). Uma conta de outro workspace devolve 404.
Query Parameters
7d (últimos 7 dias), 30d (últimos 30 dias, o padrão), mtd (mês até hoje) ou custom. Os dias são dias corridos no fuso horário do usuário dono da chave de API, incluindo hoje.
7d, 30d, mtd, custom Primeiro dia, Y-m-d. Obrigatório com range=custom e ignorado nos outros períodos prontos. Enviar start e end sem range equivale a custom.
Último dia, Y-m-d, igual ou depois de start. Obrigatório com range=custom.
Só posts com alguma destas etiquetas (etiquetas deste workspace). Etiquetas desconhecidas ou apagadas retornam 422.
Inclui (ou mostra só) posts sem etiqueta. Posts feitos fora do PostClean não têm etiquetas. Envie 1 ou 0; true e false são recusados com 422.
1, 0 Só estes tipos de conteúdo. Eles precisam ser da rede do canal.
Formato do post numa rede. Precisa pertencer à rede do destino. GET /content-types lista os formatos de cada rede com as regras de mídia. Stories do Instagram e do Facebook não publicam texto.
instagram_feed, instagram_reel, instagram_story, linkedin_post, linkedin_page_post, facebook_post, facebook_reel, facebook_story, tiktok_video, tiktok_photo, youtube_short, x_post, threads_post, threads_ghost_post, pinterest_pin, pinterest_video_pin, pinterest_carousel, bluesky_post, mastodon_post, telegram_post, discord_message, google_business_post previous classifica os posts do período anterior de mesmo tamanho.
current, previous Métrica usada na classificação. Quando o canal não informa essa métrica (ou ela não é enviada), vale a primeira desta lista que o canal informa; filters.sort mostra qual.
reactions, comments, engagement_rate, views, impressions, shares, saves, reach x >= 1