Como usar o Social Listening

O Social Listening recolhe publicações das redes sociais para dois usos diferentes: importa as publicações das suas contas ligadas que foram publicadas diretamente na rede e acompanha contas externas para que possa monitorizar e reutilizar as suas publicações públicas. Os dois tipos de publicações não aparecem nos mesmos sítios. Quando a Nonli começa a recolher uma conta de qualquer um dos tipos, obtém as suas publicações dos últimos 60 dias, no máximo.

1. Publicações das suas contas ligadas#

Quando uma publicação é feita numa das suas contas ligadas sem passar pela Nonli, o Social Listening importa-a. O seu autor é Social Listening e não tem link curto da Nonli.

• Aparece na página Posts (Publicações) com as suas outras publicações, e a API devolve-a com GET /posts.
• Um filtro por marca inclui-a: a Nonli seleciona as publicações das contas atualmente associadas à marca, quer tenham sido publicadas através da Nonli, quer importadas.

2. Publicações de contas externas#

Para acompanhar uma conta pública que a sua empresa não gere, ative-a em Intelligence a partir da tabela Account Finder, como descrito em como ativar uma conta no Facebook Intelligence. Cada ativação consome a quota de ativação de contas da sua empresa.

• As suas publicações aparecem na secção Social Listening do Intelligence e podem ser adicionadas ao seu Spotlight do Instagram.
• Não aparecem na página Posts, e GET /posts não as devolve. Use antes GET /listening/social.
• As publicações de outras empresas mostram apenas o seu conteúdo público e os contadores públicos. Um filtro, uma ordenação ou uma pesquisa num campo ou contador não público limita os resultados às publicações da sua empresa.
• Os resultados abrangem apenas as redes incluídas no seu plano de Social Listening. Um utilizador sem um lugar de Social Listening ativo não obtém resultados.

3. Exportar publicações com a API#

Crie um token de API e siga a referência da API para programadores.

Para exportar as publicações de uma das suas redes ligadas, por exemplo todas as publicações do YouTube feitas em junho de 2026, chame GET /posts sem filtro de marca:

1curl --location 'https://api.nonli.com/v2.1/posts?filters=socialAccount.type:youtube;publishedAt:2026-06-01T00:00:00Z..2026-07-01T00:00:00Z&fields=id,publishedAt,message,postType,socialAccount,status&sort=-publishedAt&size=100&page=0' \
2  --header 'Authorization: Bearer YOUR_API_TOKEN'

• O limite superior do intervalo de datas é excluído.
• Aumente page até uma página devolver menos linhas do que size. Uma pesquisa pode ir até 10 000 publicações de profundidade: para uma exportação maior, divida o período em intervalos mais curtos.
• Envie os separadores :, ;, , e .. como caracteres simples e codifique apenas os espaços e os outros caracteres dentro dos valores.
• O token só vê as contas a que o seu utilizador tem acesso. Um resultado vazio significa normalmente que o utilizador não tem acesso à conta, que ainda não foi importada nenhuma publicação ou que a rede ou o período não corresponde a nada.

Para exportar as publicações de contas externas, chame GET /listening/social com filtros em campos públicos, como a rede e a data de publicação. Cada pedido da primeira página (page=0 ou sem page) é descontado do seu pacote de Social Listening; os pedidos das páginas seguintes não são.

4. Verificar o resultado#

Verifique a empresa, o tema, as contas de redes sociais, a métrica, o período, o fuso horário e os filtros ativos selecionados antes de interpretar o resultado. Reponha os filtros e reproduza a consulta com uma conta ou publicação conhecida. Os dados das redes sociais podem chegar mais tarde do que a própria publicação, por isso anote a hora visível e tente novamente após o ciclo normal de atualização antes de contactar o suporte com uma captura de ecrã recortada e sem dados sensíveis.