O objetivo principal desta documentação é prover contexto específico para desenvolvedores e, também, apresentar tecnicamente os parâmetros de requisição e resposta das APIs que atendem à plataforma STI.
Caso esteja procurando explicações mais detalhadas de uso e melhores práticas na ferramenta, acesse o nosso Help Center!
Aqui você encontrará exemplos de requisições e modelos de consumo, com instruções à direita sobre como realizá-las e, neste painel central, explicações detalhadas sobre cada parâmetro de requisição e resposta.
Dicionário
Posts: Tudo dentro da Stilingue é post, ou seja post pode ser: post feito em um feed, menção a uma marca, comentário realizado. Tudo é tratado e entendido como post. Para diferenciá-los iremos usar os nomes que são como:
Post: Post principal feito na rede social
Comentário: Post comentário ao post principal
Listening: Publicações que estão na rede social e que são coletadas para dentro do painel pelas configurações de coleta relacionada, também conhecido como Mar aberto, ou seja, todos os posts disponíveis que foram coletados da rede social. Por exemplo, se um cliente expressa um sentimento negativo em relação à sua marca e publica: Não estou feliz com o serviço prestado pela NOME DA MARCA, e sua pesquisa estiver configurada para coletar sempre que o nome da marca for mencionado, esse post será considerado listening. (Esse exemplo não é de menções é apenas citação), mas pode variar dependendo do seu setup.
Proprietário: São publicações realizadas nas páginas conectadas ao Warroom, feitas diretamente pelo perfil vinculado, que também recebe as análises. Ou seja, sempre que a página da marca publica algo na rede social por meio do perfil conectado, esse conteúdo é classificado como post proprietário, assim como todas as interações relacionadas a ele.
Smartcare: Ferramenta utilizada para responder os usuários nas redes sociais, provendo atendimento personalizado que atenda as suas regras de atendimento.
Autenticação
Para se autenticar e conseguir utilizar os endpoints é necessário criar um token de API utilizando o painel do Warroom.
Acesse seu setup em: https://warroom.stilingue.com.br/editarpesquisa/{id-da-conta}/{id-do-painel}
Ou através da interface, fazendo login no Warroom e acessando no menu lateral Otimizar > Editar pesquisa
Você deve ver uma seção chamada Crie a API-Token para essa pesquisa. Basta clicar no botão Criar API-Token e "SIM" na tela que abrir. Pronto usando esse token gerado você poderá informar nas requisições.
Leia atentamente os avisos abaixo
Divisão
Essa documentação está organizada em três seções. Cada uma delas separadas pelo escopo dos endpoints.
Listening Endpoints relacionados aos serviços disponibilizados em Listening, tanto métricas quanto publicações.
Proprietário Endpoints relacionados à publicações e métricas de posts proprietários.
Smartcare Endpoints relacionados à ferramenta de atendimento ao usuário.
Listening
Publicações que estão na rede social e que são coletadas para dentro do painel pelas configurações de coleta relacionada, também conhecido como Mar aberto, ou seja, todos os posts disponíveis que foram coletados da rede social. Para saber mais consulte aqui
Se o serviço demorar mais de 60 segundos para responder, a requisição será interrompida e um erro é retornado. Quando isso acontecer basta fazer a requisição mais uma vez que os dados, provavelmente, já estarão prontos.
Para pesquisas que usam a aba Filtro de Conversas alguns parâmetros são obrigatórios. Para saber quais, leia aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Nome dos grupos da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
interests
string
InteressesA
Lista de interesses para serem filtrados. Separar múltiplas valores usando dois pontos. Interesses podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
order_by
string
date_desc
Ordem na qual as publicações aparecem. Os valores possíveis são:
Retorna apenas publicações apagadas (o padrão é false)
Não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações. Separar múltiplos valores usando dois pontos
Não
uids
string
149775728483392:17841401681785347
Filtrar pelo ID de um ou mais usuários. Separar múltiplos valores usando dois pontos
Não
annotated
boolean
true
Filtra por publicações que tiveram anotações realizadas
Não
fanpages
string
987654321
IDs das páginas proprietárias conectadas. Separar múltiplos valores usando dois pontos. Os IDs podem ser encontrados em api.stilingue.com.br/pages/getpages/TOKEN
Atenção: se o parâmetro filters for referente à um "Filtro de conversa", esse parâmetro se torna obrigatório!
Leia a descrição
sac_type
string
comentarios
Tipo de interação do post. Os valores possíveis são:
Canal origem do post. Os valores possíveis são: `Twitter, Instagram, InstagramComments,
Facebook, FacebookComments, YouTube, YouTubeComments, News, Blogs,
Linkedin, Tiktok`
sim
comments
number
Número inteiro positivo
Número de comentários do post
sim
contact_reasons
List<string>
Lista de strings
Retorna uma lista de motivos de contatos. *Funcionalidade limitada a
alguns clientes.
não
crawled_at
string
Data
Data em que a publicação foi coletada no formato dd/MM/aaaa HH:mm
sim
critical_level
number
Número inteiro positivo
Classificação do nível de criticidade do post
sim
dislikes
number
Número inteiro positivo
Número de dislikes da postagem
sim
emotion DEPRECATED
string
Texto com valor de emoção
Não é mais utilizado desde 2018
não
favorite
boolean
true ou false
Se a publicação é checada
sim
fb_pid
string
ID como string ou null
ID do post do Facebook
não
fb_uid
string
ID como string ou null
ID do usuário que publicou no Facebook
não
features
List<string>
Lista de strings
Campo interno usado para auxiliar no processamento. Os valores possíveis são: `FEED,
REELS`
não
followers
number
Número inteiro positivo
Quantidade de seguidores da página/autor
sim
gender
string
Valor em string ou null
Gênero de quem fez a publicação. Os valores possíveis são: `"" (vazio),
Homem, Mulher, Marca`
sim
groups
List<string>
Lista de strings. Lista pode ser vazia.
Lista de grupos da pesquisa que foram associados a publicação
sim
hashtags
List<string>
Lista de strings ou null. Lista pode ser vazia.
Lista de hashtags do post
não
hidden_by_user
boolean
true ou false
Se a mensagem foi oculta pelo usuário
sim
hot
number
Número float
Pontuação interna que indica o quanto a publicação continua
repercutindo na rede
sim
hot_post
boolean
true ou false
Se é uma publicação hot. A publicação é hot se ela estiver entre
as 20 publicações mais quentes
sim
image_url
string
string ou null
URL da imagem do post
não
interacted_page_id
string
string ou null
ID da página que interagiu com a publicação
não
interacted_page_name
string
string ou null
Nome da página que interagiu com a publicação
não
interactions
number
número inteiro positivo ou null
Quantidade total de interações no post (soma comentários, curtidas,
compartilhamentos, etc)
não
interests
List<string>
Lista de strings. Lista pode ser vazia.
Interesses do autor do post. Exemplo: `Tecnologia & Computação,Mídia /
Impresso,Imprensa Social`
Idioma do post. Os valores possíveis são: pt, en, es
sim
likes
number
Número inteiro positivo ou null
Número de curtidas no post
não
location
string
string ou null
Localização do autor do post
não
long_posted_at
number
UNIX Timestamp
Data de postagem do post em formato UNIX milissegundos. Ex:
1734727140000
não
long_updated_at
number
UNIX Timestamp
Data da última alteração do post em formato UNIX milissegundos. Ex:
1734727140000
sim
machine_learning
string
string ou null
Armazena informações relacionadas aos dados de aprendizado de máquina
associados ao post.
não
mentions
List<string>
Lista de strings ou null. Lista pode ser vazia.
Nome dos usuários mencionados no post
não
metrics_updated_at
string
Data em string
Última vez que as métricas do post foram atualizadas. Ex: `22/12/2024
17:23`
sim
name
string
string ou null
Nome do usuário que realizou a publicação. Este campo pode estar disponível apenas para determinados canais, como: Comentários no YouTube, Bluesky, Comentários em Artigos
não
operator_id
string
string ou null
ID do operador que respondeu a conversa no Smartcare
não
operator_name
string
string ou null
Nome do operador que respondeu a conversa no Smartcare
não
page_comment
boolean
true ou false
Verifica se a interação ou post foi feito pela página
sim
page_id
string
ID da página proprietária conectada que fez o post
sim
pages
List<string>
Lista de strings. Lista pode ser vazia.
ID da página. Usado para filtrar posts de uma página específica
sim
pid
string
ID
ID do post
sim
post_id
string
ID
Disponível quando o post atual é uma interação em outro post, um
comentário por exemplo. post_id será o ID do post raiz.
não
post_url
string
URL
URL do post raiz
sim
post_user_image_url
string
string ou null
URL da imagem de perfil página que fez o post
não
posted_at
string
Data
Data da postagem. Ex: 23/12/2024 10:23
sim
primary_channel
string
Canal onde a publicação foi feita. Os valores possíveis são: `Twitter, Instagram,
Facebook, YouTube, News, Blogs, Linkedin`
{"limit":1,"next_offset":2,"offset":1,"posts":[{"AAA_score":0.01,"anonymous_user":null,"attachments":[{"attachment_type":"post","id":"18091344544509794","media_type":"IMAGE","storage_url":"https://scontent-atl3-1.cdninstagram.com/","type":"image/jpeg","url":"https://scontent-atl3-1.cdninstagram.com/"}],"channel":"Instagram","comments":7,"contact_reasons":[],"crawled_at":"26/12/2024 05:30","critical_level":0,"dislikes":0,"emotion":"","favorite":false,"fb_pid":null,"fb_uid":null,"features":["FEED"],"followers":3051441,"gender":"","groups":["Grupo teste - Restaurante"],"hashtags":null,"hidden_by_user":false,"hot":2478.65230354763,"hot_post":false,"image_url":"https://scontent-atl3-1.cdninstagram.com/","interacted_page_id":null,"interacted_page_name":null,"interactions":145306,"interests":[],"is_dynamic_post":false,"is_hidden":null,"is_root":null,"lang":"pt","likes":145299,"location":null,"long_posted_at":null,"long_updated_at":1735191780000,"machine_learning":null,"mentions":null,"metrics_updated_at":"26/12/2024 02:43","name":null,"operator_id":null,"operator_name":null,"page_comment":true,"page_id":"17841400742140112","pages":["17841400742140112"],"pid":"18091344544509794","post_id":null,"post_url":"https://www.instagram.com/p/DEBw5a_NRu4/","post_user_image_url":null,"posted_at":"26/12/2024 01:06","primary_channel":"Instagram","reaction_angry":null,"reaction_haha":null,"reaction_like":null,"reaction_love":null,"reaction_pride":null,"reaction_sad":null,"reaction_thankful":null,"reaction_total":null,"reaction_wow":null,"reactions":null,"receiver":{"email":null,"id":null,"image_url":null,"name":null},"replier":null,"replier_name":null,"reply_pid":"18091344544509794","root_id":null,"sac_call_id":null,"sac_type":null,"sentiment":-1,"shares":0,"spam":false,"status":"Pendente","tags":[],"talk_id":null,"text":"A moreia é um tipo de peixe pertencente à família Muraenidae.","text_append":null,"themes":["Moreia"],"title":"","to":null,"type":"image","uid":"17841400742140113","update_time_ago":"Nunca editado","user_image_url":null,"user_url":null,"username":"claumello","verified":null,"videoplays":0}],"request_time_millis":110}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Visão Geral
Retorna dados encontrados em Visão Geral dentro do Warroom, como quantidade de publicações coletadas, total de usuários, entre outros.
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de influenciadores que serão retornados na lista.
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
não
Corpo da resposta
Campo
Tipo
Descrição
channels
List
lista com o distribuição de canais encontrados no Warroom
collected_mentions
number
Número de publicações coletadas
collected_mentions_variation
number
Porcentagem da variação de publicações coletadas comparadas ao período anterior
date_range
string
intervalo de data passado na requisição
general_sentiment
List
Lista com a distribuição de sentimentos encontrados no Warroom
influencers_list
List
Lista com o ranking de influenciadores encontrados no Warroom e com detalhes referentes a esses perfis como
foto de perfil, uid, entre outros
influencers_static
booleano
-
net_promoter_score
number
Valor com o índice de sentimento
net_promoter_score_variation
number
Valor em percentagem da variação do índice de sentimento em relação ao período anterior
net_sentiment
number
-
net_sentiment_score
number
-
net_sentiment_score_variation
number
-
potential_reach
number
Número com o alcance potencial encontrado no Warroom
potential_reach_variation
number
Valor em percentagem da variação do alcance potencial em relação ao período anterior
previous_collected_mentions
number
Número de publicações coletadas do período anterior ao que foi passado na requisição
previous_date_range
string
Intervalo de datas anterior ao que foi passado na requisição
previous_net_promoter_score
string
Valor com o índice de sentimento anterior ao que foi passado na requisição
previous_net_sentiment
string
Valor com o índice de sentimento anterior ao que foi passado na requisição
previous_net_sentiment_score
string
Valor em percentagem da variação do índice de sentimento anterior ao que foi passado na requisição
previous_potential_reach
string
Número com o alcance potencial anterior ao que foi passado na requisição
talking_about
dicionário
Esse campo é um dicionário que possui os valores para distribuição de publicações por dispositivo, gênero e
interesse
total_localized_mentions
number
Esse número é referente a quantidade de publicações coletadas
total_users
number
Esse número é referente a quantidade total de usuários
total_users_variation
number
Esse número é referente a variação em porcentagem da quantidade total de usuários em relação ao período
anterior
Corpo da resposta em json
{"channels":{"Blogs":208.0,"Bluesky":9603.0,"Comentários em Artigos":8911.0,"Comentários no Facebook":310004.0,"Facebook":74844.0,"Instagram":62113.0,"InstagramComments":8.0,"LinkedIn":8.0,"LinkedInComments":6.0,"News":243798.0,"Reclame Aqui":9652.0,"Twitter":164473.0},"collected_mentions":883628.0,"collected_mentions_variation":389.41173864158765,"date_range":"202412080000|202501062359","general_sentiment":{"negative_value":293572.0,"neutral_value":82579.0,"not_classified_value":0.0,"positive_value":507477.0},"influencers_list":[{"afinity_normalized":0.0,"afinity_score":0.0,"assertiviness_score":0.0,"channel":"Instagram","followers_score":0.0,"interests":[],"is_verified":false,"name":"Corinthians","position":0,"posts_count":0.0,"profile_picture":"https://scontent-cdg4-1.xx.fbcdn.net/v/t51.2885-15/472499346_990867516393751_8862369786220012236_n.jpg?_nc_cat=1&ccb=1-7&_nc_sid=7d201b&_nc_ohc=qIGnP9RvfkYQ7kNvgEYX_e0&_nc_zt=23&_nc_ht=scontent-cdg4-1.xx&edm=AL-3X8kEAAAA&oh=00_AYCdBYg-SCJjwZgg4FIGEXCdb_sDVxT2_HxNVwTnEtG8jQ&oe=678383CB","ranking_harmonic_mean":0.0,"reach_normalized":0.0,"reach_score":0.0,"uid":"17841401449488648","url":"https://www.instagram.com/corinthians","username":"corinthians","virality_score":0.0,"viralization_normalized":0.0}],"influencers_static":false,"net_promoter_score":24.207585092369193,"net_promoter_score_variation":43.49306545986955,"net_sentiment":296484.0,"net_sentiment_score":0.3355303362953641,"net_sentiment_score_variation":-99.31207155621908,"potential_reach":2843633656.0,"potential_reach_variation":82.29237518264873,"previous_collected_mentions":180549.0,"previous_date_range":"202411080001|202412080000","previous_net_promoter_score":16.870212518485282,"previous_net_sentiment":88061.0,"previous_net_sentiment_score":48.774017025848934,"previous_potential_reach":1559930114.0,"talking_about":{"device":[[{"percentage":100.0}],[["Não Classificados",0.0],["Computador",547996],["Celular/Tablet",335632]]],"gender":[[{"percentage":20.880822842619434}],[["Não Classificados",378537.0],["Homem",41651],["Marca",9732],["Organização",0],["Mulher",48519]]],"publishers":[[{"percentage":4.606229843302908}],[["Comuns",456401.0],["Cursos de bitoneteiro",10921],["Animais de Estimação",9196],["spotify",3318]]]},"total_localized_mentions":883628.0,"total_users":478439,"total_users_variation":428.708615126199}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Publicações no tempo
O endpoint traz a quantidade de publicações por dia. Os dados são referentes ao gráfico de linha Publicações no tempo encontrado no Warroom. Para mais detalhes clique aqui.
O que o endpoint não faz: O endpoint fornece dados apenas em escala diária, não sendo possível utilizá-lo para obter informações em intervalos menores, como por hora.
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso
informado 50d, os posts serão apenas dos últimos 30 dias apenas.
Para prazos maiores, utilize o formato
AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não
seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de temas por canal que serão
retornados com sentimento. Caso não informado é limitado a retornar
o máximo possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o
offset for 1000, os primeiros 1000 posts serão ignorados pegando a
partir dos 1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais
de um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook,
FacebookComments, YouTube, YouTubeComments, News, Blogs,
Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas
encontrados nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de
posts que contenham esse grupo. Separar múltiplos valores usando
dois pontos. Grupos podem ser encontrados ao acessar a área de
editar pesquisa no Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos,
pegando apenas posts que contenham esses temas. Caso precise passar
mais de um tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento,
trazendo apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise.
Para filtrar por mais de um interesse, basta usar dois pontos.
não
genders
string
Mulher:Homem
Gênero usado para filtrar os sentimentos desses gêneros pelos temas,
caso precise passar mais de um tema utilize dois pontos. Caso não
seja informado será considerado todos. Os valores possíveis são:
Homem - Mulher - Marca
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por
mais de um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Sentimento por Temas
O endpoint fornece dados de sentimento (positivo, negativo e neutro) relacionado ao usuário com base em um Tema específico. Ele retorna a contagem total de cada tipo de sentimento associado ao Tema, bem como a contagem única de sentimento por Temas em cada canal individualmente. O resultado deste endpoint é referente aos dados do gráfico "Distribuição por Temas" encontrado no Warroom, o qual informa quais são os Temas mais citados nas publicações versus sentimento. Para saber mais clique aqui.
O endpoint não traz os motivos dos sentimentos, apenas o número total de cada tipo de sentimento.
> ⚠️ Importante: para o campo all na resposta da requisição, deve-se considerar a soma de todos os canais em que o tema foi identificado.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de temas por canal que serão retornados com sentimento. Caso não informado é limitado a retornar o máximo possível que é 100.000.
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
.
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos 1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de um, deve separá-los com dois pontos. Os valores possíveis são: (Twitter, Instagram, InstagramComments, Facebook, FacebookComments, YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de sentimento apenas dos temas desses ids informados. Separar múltiplos valores usando dois pontos.
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts que contenham esse grupo. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom.
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando apenas posts que contenham esses temas. Caso precise passar mais de um tema separe-os com dois pontos. Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento, trazendo apenas temas que contenham esses interesses para análise. Para filtrar por mais de um interesse, basta usar dois pontos.
não
genders
string
Mulher:Homem
Gênero usado para filtrar os sentimentos desses gêneros pelos temas, caso precise passar mais de um tema utilize dois pontos. Caso não seja informado será considerado todos. Os valores possíveis são Homem - Mulher - Marca
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Os valores possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser: Text, Image, Video e Audio. Caso queira filtrar por mais de um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como spam) na análise de sentimentos. Valor padrão é false
Cada canal possui um array de dados por tema encontrado, cada tema tem os dados gerais de sentimento.
Métricas
Campo
Tipo
Exemplo
Descrição
channel
string
Instagram
Nome do canal que foi detectado aquele tema com aqueles dados de sentimento.
name
string
TemaXPTO
Nome do tema identificado.
negative
number
10
Quantidade total de sentimentos negativos para um determinado tema.
neutral
number
50
Quantidade total de sentimentos neutros para um determinado tema.
not_classified
number
5
Quantidade total de sentimento não classificado, quando não identifica um determinado sentimento.
positive
number
20
Quantidade total de sentimentos positivos para um determinado tema.
total
number
80
Quantidade total de posts para o tema definido.
total_polarity_classified
number
80
Total de publicações que foram classificadas.
Corpo da resposta em json
{"data":{"Bluesky":[{"channel":"Bluesky","name":"N\u00e3o Classificados","negative":72,"neutral":33,"not_classified":0,"positive":47,"total":152,"total_polarity_classified":152}],"Coment\u00e1rios em Artigos":[{"channel":"Coment\u00e1rios em Artigos","name":"AAteeeeemasssss","negative":86,"neutral":9,"not_classified":0,"positive":82,"total":177,"total_polarity_classified":177}],"Coment\u00e1rios no Facebook":[{"channel":"Coment\u00e1rios no Facebook","name":"AAteeeeemasssss","negative":1838,"neutral":259,"not_classified":0,"positive":1325,"total":3422,"total_polarity_classified":3422}],"Facebook":[{"channel":"Facebook","name":"AAteeeeemasssss","negative":873,"neutral":136,"not_classified":0,"positive":1053,"total":2062,"total_polarity_classified":2062}],"Instagram":[{"channel":"Instagram","name":"AAteeeeemasssss","negative":34,"neutral":7,"not_classified":0,"positive":116,"total":157,"total_polarity_classified":157}],"Portais":[{"channel":"News","name":"AAteeeeemasssss","negative":3374,"neutral":43,"not_classified":0,"positive":4402,"total":7819,"total_polarity_classified":7819}],"Reclame Aqui":[{"channel":"Reclame Aqui","name":"AAteeeeemasssss","negative":288,"neutral":0,"not_classified":0,"positive":10,"total":298,"total_polarity_classified":298}],"Twitter":[{"channel":"Twitter","name":"AAteeeeemasssss","negative":372,"neutral":108,"not_classified":0,"positive":299,"total":779,"total_polarity_classified":779}],"all":[{"channel":"all","name":"AAteeeeemasssss","negative":6883,"neutral":567,"not_classified":0,"positive":7306,"total":14756,"total_polarity_classified":14756}]},"request_time_millis":84,"total_posts":21974}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Sentimento por Grupos
O endpoint fornece dados de sentimento (positivo, negativo e neutro) relacionado ao usuário com base em um Grupo específica. Ele retorna a contagem total de cada tipo de sentimento associado ao Grupo, bem como a contagem única de sentimento por Grupos em cada canal individualmente. O resultado deste endpoint é referente aos dados do gráfico "Distribuição por Grupos" encontrado no Warroom, o qual informa quais são as Grupos mais citados nas publicações versus sentimento. Para saber mais clique aqui.
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de grupos por canal que serão retornados
com sentimento. Caso não informado é limitado a retornar o máximo
possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
genders
string
Mulher:Homem
Gênero utilizado para filtrar os sentimentos por grupos, considerando apenas os gêneros especificados. Para informar mais de um gênero, separe-os por dois pontos. Se não for informado, todos os gêneros serão considerados. Os valores possíveis são: Homem - Mulher - Marca
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
não
Corpo da resposta
Campo
Tipo
Descrição
channel
string
Nome do canal correspondente ao Grupo.
Quando o name for All o valor considerado é a soma de todos os
canais.
name
string
Nome do Grupo definido
negative
number
Quantidade de posts classificados com sentimento negativo em relação ao
Grupo definido
neutral
number
Quantidade de posts classificados com sentimento neutro em relação ao
Grupo definido
not_classified
number
Quantidade de posts não classificados em relação ao Grupo definido
positive
number
Quantidade de posts classificados com sentimento positivo em relação ao
Grupo definido
Se o serviço demorar mais de 60 segundos para responder, a requisição será interrompida e um erro é retornado. Quando isso acontecer basta fazer a requisição mais uma vez que os dados, provavelmente, já estarão prontos.
Para pesquisas que usam a aba Filtro de Conversas alguns parâmetros são obrigatórios. Para saber quais, leia aqui.
Request
curl -H'Content-Type: application/json'\-X GET \'https://api.stilingue.com.br/wrapi/sentimento_regioes/{{TOKEN}}'
Parâmetros da requisição
Campo
Tipo
Exemplo
Descrição
Obrigatório
date_range
string
7d ou 202401010000:202401072359
Intervalo de data com formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm
Não
last_days
number
30
Traz dados dos últimos N dias.
Atenção: esse filtro sobrescreve o filtro date_range
Não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Nome dos grupos da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
interests
string
InteressesA
Lista de interesses para serem filtrados. Separar múltiplas valores usando dois pontos. Interesses podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
order_by
string
date_desc
Ordem na qual as publicações aparecem. Os valores possíveis são:
{"data":{"Cidades":[{"name":"São Paulo, São Paulo, Brasil","negative":48,"neutral":0,"positive":1,"total":49,"total_classified":49}],"Estados":[{"name":"São Paulo, Brasil","negative":108,"neutral":25,"positive":10,"total":143,"total_classified":118}],"Mesorregiões":[{"name":"Metropolitana de São Paulo, Brasil","negative":81,"neutral":3,"positive":6,"total":90,"total_classified":87}],"Países":[{"name":"Brasil","negative":546,"neutral":88,"positive":415,"total":1049,"total_classified":961}],"Regiões":[{"name":"Sudeste, Brasil","negative":171,"neutral":57,"positive":16,"total":244,"total_classified":187}]},"request_time_millis":1274,"total_posts":8009}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Sentimento por Buscas
Este endpoint fornece dados sobre o sentimento (positivo, negativo e neutro) do usuário com base em uma busca específica. Ele retorna:
A contagem total de cada tipo de sentimento associado à busca.
A contagem individual de sentimentos por canal, permitindo uma análise segmentada.
O resultado deste endpoint está relacionado ao gráfico Distribuição por Buscas, disponível no Warroom. Esse gráfico leva em consideração os descritores definidos nos Grupos e Temas da sua Configuração de Pesquisa. Isso significa que, entre as palavras que você incluiu nos campos de Grupos e Temas, aquelas que aparecem com maior frequência nas publicações coletadas são destacadas no gráfico. Para saber mais detalhes clique aqui..
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de buscas por canal que serão retornados
com sentimento. Caso não informado é limitado a retornar o máximo
possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
genders
string
Mulher:Homem
Gênero utilizado para filtrar os sentimentos por buscas, considerando apenas os gêneros especificados. Para informar mais de um gênero, separe-os por dois pontos. Se não for informado, todos os gêneros serão considerados. Os valores possíveis são: Homem - Mulher - Marca
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
não
Corpo da resposta
Campo
Tipo
Descrição
channel
string
Nome do canal correspondente a Busca.
Quando o name for All o valor considerado é a soma de todos os
canais.
name
string
Nome da Busca
negative
number
Quantidade de posts classificados com sentimento negativo em relação a
busca
neutral
number
Quantidade de posts classificados com sentimento neutro em relação a
busca
not_classified
number
Quantidade de posts não classificados em relação a busca
positive
number
Quantidade de posts classificados com sentimento positivo em relação a
busca
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Sentimento por Tags
O endpoint fornece dados de sentimento (positivo, negativo e neutro) relacionado ao usuário com base em uma Tag específica. Ele retorna a contagem total de cada tipo de sentimento associado à Tag, bem como a contagem única de sentimento por Tags em cada canal individualmente. O resultado deste endpoint é referente aos dados do gráfico "Distribuição por Tags" encontrado no Warroom, o qual informa quais são as Tags mais citadas nas publicações versus sentimento. Para saber mais clique aqui.
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de tags por canal que serão retornadas
com sentimento. Caso não informado é limitado a retornar o máximo
possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
genders
string
Mulher:Homem
Gênero usado para filtrar os sentimentos desses gêneros pelos tags,
caso precise passar mais de um tema utilize dois pontos. Caso não seja
informado será considerado todos. Os valores possíveis são Homem - Mulher - Marca
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
não
annotated
boolean
true
Se true filtra publicações que estiverem marcadas como
"checadas". Se false filtra publicações que estiverem
marcadas como "não checadas"
não
Corpo da resposta
Campo
Tipo
Descrição
channel
string
Nome do canal correspondente a Tag.
Quando o name for All o valor considerado é a soma de todos os
canais.
name
string
Nome da Tag definida
negative
number
Quantidade de posts classificados com sentimento negativo em relação a
Tag definida
neutral
number
Quantidade de posts classificados com sentimento neutro em relação a Tag
definida
not_classified
number
Quantidade de posts não classificados em relação a Tag definida
positive
number
Quantidade de posts classificados com sentimento positivo em relação a
Tag definida
total
number
Quantidade total de posts para a tag definida.
total_polarity_classified
number
Total de publicações que foram classificadas.
total_posts
number
Total de posts (publicações).
Corpo da resposta em json
{"data":{"Facebook":[{"channel":"Facebook","name":"tag nova q n existe ainda","negative":952,"neutral":313,"not_classified":0,"positive":2437,"total":3702,"total_polarity_classified":3702}],"Instagram":[{"channel":"Instagram","name":"tag nova q n existe ainda","negative":522,"neutral":125,"not_classified":0,"positive":1861,"total":2508,"total_polarity_classified":2508}],"all":[{"channel":"all","name":"tag nova q n existe ainda","negative":1474,"neutral":438,"not_classified":0,"positive":4298,"total":6210,"total_polarity_classified":6210}]},"request_time_millis":1788,"total_posts":884102}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Sentimento por HashTags
O endpoint fornece dados de sentimento (positivo, negativo e neutro) relacionado ao usuário com base em uma HashTag específica. Ele retorna a contagem total de cada tipo de sentimento associado a HashTag, bem como a contagem única de sentimento por HashTags em cada canal individualmente. O resultado deste endpoint é referente aos dados do gráfico "Distribuição por HashTags" encontrado no Warroom, o qual informa quais são as hashtags mais citadas nas publicações versus sentimento. Para saber mais clique aqui
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de hashtags por canal que serão retornados
com sentimento. Caso não informado é limitado a retornar o máximo
possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
genders
string
Mulher:Homem
Genêro usado para filtrar os sentimentos desses genêros pelos temas,
caso precise passar mais de um tema utilize dois pontos. Caso não seja
informado será considerado todos. Os valores possíveis são: Homem - Mulher - Marca
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
não
Corpo da resposta
Campo
Tipo
Descrição
channel
string
Nome do canal correspondente a hashtag coletada.
Quando o name for All o valor considerado é a soma de todos os
canais.
name
string
Nome do domínio coletado
negative
number
Quantidade de posts classificados com sentimento negativo em relação a
hashtag
neutral
number
Quantidade de posts classificados com sentimento neutro em relação a
hashtag
not_classified
number
Quantidade de posts não classificados em relação a hashtag
positive
number
Quantidade de posts classificados com sentimento positivo em relação a
hashtag
total
number
Quantidade total de posts para a hashtag definida.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Sentimento por Domínios
O resultado deste endpoint é referente aos dados do gráfico "Distribuição por Domínios" encontrado no Warroom, o qual informa quais são os domínios de sites onde foram encontradas publicações que batem com a sua Configuração de Pesquisa versus sentimento. Para mais detalhes clique aqui.
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo represeta dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de domínios por canal que serão retornados
com sentimento. Caso não informado é limitado a retornar o máximo
possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
genders
string
Mulher:Homem
Gênero utilizado para filtrar os sentimentos por domínios, considerando apenas os gêneros especificados. Para informar mais de um gênero, separe-os por dois pontos. Se não for informado, todos os gêneros serão considerados. Os valores possíveis são: Homem - Mulher - Marca
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua.Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
não
Corpo da resposta
Campo
Tipo
Descrição
channel
string
Nome do canal correspondente ao domínio coletado.
Quando o name for All o valor considerado é a soma de todos os
canais.
name
string
Nome do domínio coletado
negative
number
Quantidade de posts classificados com sentimento negativo em relação ao
domínio
neutral
number
Quantidade de posts classificados com sentimento neutro em relação ao
domínio
not_classified
number
Quantidade de posts não classificados em relação ao domínio
positive
number
Quantidade de posts classificados com sentimento positivo em relação ao
domínio
total
number
Quantidade total de posts para o domínio definido.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Sentimento por Links
O resultado deste endpoint é referente aos dados do gráfico "Distribuição por Links" encontrado no Warroom, o qual apresenta os links que mais aparecem nas publicações coletadas durante a pesquisa versus sentimento. Para mais detalhes, clique aqui.
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de links por canal que serão retornados
com sentimento. Caso não informado é limitado a retornar o máximo
possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
genders
string
Mulher:Homem
Gênero utilizado para filtrar os sentimentos por links, considerando apenas os gêneros especificados. Para informar mais de um gênero, separe-os por dois pontos. Se não for informado, todos os gêneros serão considerados. Os valores possíveis são: Homem - Mulher - Marca
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
não
Corpo da resposta
Campo
Tipo
Descrição
channel
string
Nome do canal correspondente ao link coletado.
Quando o name for All o valor considerado é a soma de todos os
canais.
name
string
Nome do link coletado
negative
number
Quantidade de posts classificados com sentimento negativo em relação ao
link
neutral
number
Quantidade de posts classificados com sentimento neutro em relação ao
link
not_classified
number
Quantidade de posts não classificados em relação ao link
positive
number
Quantidade de posts classificados com sentimento positivo em relação ao
link
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Sentimento por Termos
O endpoint fornece dados de sentimento (positivo, negativo e neutro) relacionado ao usuário com base em um Termo específico. Ele retorna a contagem total de cada tipo de sentimento associado ao Termo, bem como a contagem única de sentimento por Termos em cada canal individualmente. O resultado deste endpoint é referente aos dados do gráfico "Distribuição por Termos" encontrado no Warroom, o qual informa quais são os Termos mais citados nas publicações versus sentimento. Para saber mais clique aqui.
Se o serviço demorar mais de 60 segundos para responder, a requisição será interrompida e um erro é retornado. Quando isso acontecer basta fazer a requisição mais uma vez que os dados, provavelmente, já estarão prontos.
Request
curl -H'Content-Type: application/json'\-X POST \'https://api.stilingue.com.br/wrapi/estatisticas_termos/{api-token}'\-ddate_range=7d \-dlimit=20 \
Parâmetros da requisição
Campo
Tipo
Exemplo
Descrição
Obrigatório
date_range
string
7d ou 202401010000:202401072359
Intervalo de data com formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm
Não
limit
number
100
Limite total de termos retornados em cada canal. O limite máximo é 1000.
Não
last_days
number
30
Traz dados dos últimos N dias.
Atenção: esse filtro sobrescreve o filtro date_range
Não
offset
number
1000
Usado para paginação, por exemplo, se o valor de offset for 1000, as 1000 primeiras publicações serão ignoradas
Não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Filtrar pelo ID de um ou mais usuários. Separar múltiplos valores usando dois pontos
Não
groups
string
GrupoA
Nome dos grupos da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
interests
string
InteressesA
Lista de interesses para serem filtrados. Separar múltiplas valores usando dois pontos. Interesses podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
annotated
boolean
true
Filtra por publicações que tiveram anotações realizadas
Não
removed
boolean
false
Retorna apenas publicações apagadas (o padrão é false)
Uma resposta pode conter mais de uma chave `canal` no JSON. Novos canais são adicionados e alterados com frequência, então recomendamos um algoritmo que não dependa de nomes exatos.
palavras semelhantes que contabilizaram para estatística
channel
string
canal
name
string
nome do termo
negative
integer
quantidade de interações negativas
neutral
integer
quantidade de interações neutras
not_classified
integer
quantidade de interações não classificadas
positive
integer
quantidade de interações positivas
total
integer
total de interações
total_polarity_classified
integer
Total de publicações que foram classificadas.
Corpo da resposta em json
{"data":{"Blogs":[{"absorbed_names":[],"channel":"Blogs","name":"Honda","negative":1,"neutral":0,"not_classified":0,"positive":10,"total":11,"total_polarity_classified":11}],"Bluesky":[{"absorbed_names":["TIKTOK","TiKtOk","Tik Tok","TikTok"],"channel":"Bluesky","name":"Tiktok","negative":202,"neutral":108,"not_classified":0,"positive":126,"total":436,"total_polarity_classified":436}],"Comentários em Artigos":[{"absorbed_names":[],"channel":"Comentários em Artigos","name":"RISOS","negative":166,"neutral":31,"not_classified":0,"positive":152,"total":349,"total_polarity_classified":349}],"Comentários no Facebook":[{"absorbed_names":["RISOS"],"channel":"Comentários no Facebook","name":"Risos","negative":3322,"neutral":1096,"not_classified":0,"positive":2527,"total":6945,"total_polarity_classified":6945}],"Comentários no Instagram":[{"absorbed_names":[],"channel":"InstagramComments","name":"Teste","negative":0,"neutral":1,"not_classified":0,"positive":0,"total":1,"total_polarity_classified":1}],"Facebook":[{"absorbed_names":["BRASIL"],"channel":"Facebook","name":"Brasil","negative":335,"neutral":86,"not_classified":0,"positive":588,"total":1009,"total_polarity_classified":1009}],"Instagram":[{"absorbed_names":["BRASIL"],"channel":"Instagram","name":"Brasil","negative":151,"neutral":32,"not_classified":0,"positive":473,"total":656,"total_polarity_classified":656}],"LinkedinComments":[{"absorbed_names":[],"channel":"LinkedinComments","name":"Teste De Resposta","negative":0,"neutral":16,"not_classified":0,"positive":0,"total":16,"total_polarity_classified":16}],"Portais":[{"absorbed_names":["BRASIL"],"channel":"News","name":"Brasil","negative":2768,"neutral":35,"not_classified":0,"positive":4431,"total":7234,"total_polarity_classified":7234}],"Reclame Aqui":[{"absorbed_names":["PRODUTO"],"channel":"Reclame Aqui","name":"Produto","negative":508,"neutral":1,"not_classified":0,"positive":11,"total":520,"total_polarity_classified":520}],"Twitter":[{"absorbed_names":["BRASIL"],"channel":"Twitter","name":"Brasil","negative":782,"neutral":303,"not_classified":0,"positive":594,"total":1679,"total_polarity_classified":1679}],"all":[{"absorbed_names":["BRASIL","BrasiL"],"channel":"all","name":"Brasil","negative":7908,"neutral":859,"not_classified":0,"positive":7594,"total":16361,"total_polarity_classified":16361}]},"request_time_millis":30110,"total_posts":211020}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Top Influenciadores
O endpoint inclui a lista de influenciadores correspondente ao ranking "Influenciadores Ranking AAA" do Warroom. Este endpoint também pode ser utilizado como uma alternativa para obter essas informações sobre os influenciadores. Para saber mais clique aqui.
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de influenciadores que serão retornados. Caso não informado é limitado a retornar o máximo
possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
Se o serviço demorar mais de 60 segundos para responder, a requisição será interrompida e um erro é retornado. Quando isso acontecer basta fazer a requisição mais uma vez que os dados, provavelmente, já estarão prontos.
Para pesquisas que usam a aba Filtro de Conversas alguns parâmetros são obrigatórios. Para saber quais, leia aqui.
Request
curl -H'Content-Type: application/json'\-X POST \'https://api.stilingue.com.br/wrapi/aaa/{api-token}'\-ddate_range=30d \
Parâmetros da requisição
Campo
Tipo
Exemplo
Descrição
Obrigatório
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no icone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Nome dos grupos da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
interests
string
InteressesA
Lista de interesses para serem filtrados. Separar múltiplas valores usando dois pontos. Interesses podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
order_by
string
date_desc
Ordem na qual as publicações aparecem. Os valores possíveis são:
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Machetes sociais
Esse endpoint traz manchetes que são títulos de noticias ou posts das redes sociais, onde seu conteúdo selecionado da pesquisa com base nos compartilhamentos dessas notícias nas redes, e também por meio dos plug-ins sociais (botões de compartilhamento nos portais e blogs) associados a essas redes. Para mais detalhes do que é Consulte aqui
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
{"data":[{"available_time":693,"channel":"Facebook","published_at":"21/01/2025 06:00","real_weight":0,"sentiment":1,"title":"Resumo BBB 25: Troca de farpas no Sincer\u00e3o e qual a primeira dupla eliminada","uid":"169741159736092","user":"Metro Jornal","weight":10},{"available_time":592,"channel":"Facebook","published_at":"21/01/2025 07:41","real_weight":2,"sentiment":-1,"title":"BBB 25: Camilla e Thamiris perdem a linha ap\u00f3s discuss\u00e3o com Diogo, que se irrita","uid":"252618518084219","user":"Itatiaia - A R\u00e1dio de Minas","weight":11}],"request_time_millis":143}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Onde estão falando
Retorna dados onde é possível observar onde estão as pessoas da pesquisa e o que estão falando sobre os grupos/temas. Para mais detalhes clique aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos 1001 até 2000.
Lista de termos que estão sendo discutidos e coordenadas no mapa.
Objeto Cities
Campo
Tipo
Descrição
cidade
string
Nome da cidade
estado
string
Nome do estado
pais
string
Nome do país
quantidade
string
Quantidade de pessoas falando
Objeto Coordinates
Campo
Tipo
Descrição
Longitude
number
Coordenada geográfica.
Latitude
number
Coordenada geográfica.
ids
List
Lista de id's do grupo.
terms
List
Lista de terms utilizado no agrupamento.
request_time_millis
number
Tempo total da requisição.
Corpo da resposta em json
{"cities_table":[{"cidade":"Cabo Frio","estado":"Rio de Janeiro","pais":"Brasil","quantidade":3}],"data":[[-19.884749,-44.017266,{"ids":["1882589102144635093_Twitter"],"terms":[{"BBB 25":1}]}]],"request_time_millis":606}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Mural de imprensa
Esse endpoint traz publicações/posts que foram coletados por clipadoras de portais de noticias e conteúdos. São informações que foram importadas via integração com essas clipadoras. Para mais detalhes veja aqui
Limitações
Não é possível pegar posts de um prazo maior do que 30 dias no campo date-range, para isso informe o last_days. Caso precise acessar mais posts o parâmetro limit deve ser alterado para uma quantidade maior.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Não
limit
number
30
Esse campo limita a quantidade total de posts retornados. Caso não informado o padrão é 5
Não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Nome dos grupos da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
interests
string
InteressesA
Lista de interesses para serem filtrados. Separar múltiplas valores usando dois pontos. Interesses podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
offset
number
10
Essa propriedade serve para paginar os resultados, ele pula N posts pra frente, atualizando a propriedade next_offset mostrando quantidade de posts pulados para frente na paginação. Quando não informado esse valor é 0 representando a primeira página de resultados.
Não
order_by
string
date_desc
Ordem na qual as publicações aparecem. Os valores possíveis são:
Idioma do post. Os valores possíveis são: pt, en, es
sim
likes
number
Número inteiro positivo ou null
Número de curtidas no post
não
location
string
string ou null
Localização do autor do post
não
long_posted_at
number
UNIX Timestamp
Data de postagem do post em formato UNIX milissegundos. Ex:
1734727140000
não
long_updated_at
number
UNIX Timestamp
Data da última alteração do post em formato UNIX milissegundos. Ex:
1734727140000
sim
machine_learning
string
string ou null
Armazena informações relacionadas aos dados de aprendizado de máquina
associados ao post.
não
mentions
List<string>
Lista de strings ou null. Lista pode ser vazia.
Nome dos usuários mencionados no post
não
metrics_updated_at
string
Data em string
Última vez que as métricas do post foram atualizadas. Ex: `22/12/2024
17:23`
sim
name
string
string ou null
Nome do usuário que realizou a publicação. Este campo pode estar disponível apenas para determinados canais, como: Comentários no YouTube, Bluesky, Comentários em Artigos
não
operator_id
string
string ou null
ID do operador que respondeu a conversa no Smartcare
não
operator_name
string
string ou null
Nome do operador que respondeu a conversa no Smartcare
não
page_comment
boolean
true ou false
Verifica se a interação ou post foi feito pela página
sim
page_id
string
ID da página proprietária conectada que fez o post
sim
pages
List<string>
Lista de strings. Lista pode ser vazia.
ID da página. Usado para filtrar posts de uma página específica
sim
pid
string
ID
ID do post
sim
post_id
string
ID
Disponível quando o post atual é uma interação em outro post, um
comentário por exemplo. post_id será o ID do post raiz.
não
post_url
string
URL
URL do post raiz
sim
post_user_image_url
string
string ou null
URL da imagem de perfil página que fez o post
não
posted_at
string
Data
Data da postagem. Ex: 23/12/2024 10:23
sim
primary_channel
string
Canal onde a publicação foi feita. Os valores possíveis são: `Twitter, Instagram,
Facebook, YouTube, News, Blogs, Linkedin`
sim
reactions
number
Número inteiro positivo ou null
Número de reações à publicação
não
reply_pid
string
string ou null
ID (pid) do post que o post respondeu. *Se um post responde um
comentário, o reply_pid será do comentário respondido
não
sentiment
number
Número entre -1 e 1
Valor do sentimento do post. -1 para negativo, 0 para neutro e 1 para
positivo
sim
shares
number
Número inteiro positivo
Número de compartilhamentos da publicação
sim
spam
boolean
true ou false
Verifica se a mensagem foi selecionada para ser deletada
sim
status
string
Status da conversa. Os valores possíveis são: `Ignorado, Pendente, Aberto, Em Espera,
Respondido, Fechado`
sim
tags
List<string>
Lista de strings. Lista pode ser vazia.
Lista de tags da conversa
sim
text
string
Conteúdo html com o texto do post
sim
themes
List<string>
Lista de strings. Lista pode ser vazia.
Temas da conversa
sim
title
string
Valor em string que pode ser vazio
Título da postagem
sim
type
string
Tipo da publicação. Os valores possíveis são: `video, image, carrossel (exclusivo
Instagram), post`
não
uid
string
ID
ID do usuário/autor do post
sim
update_time_ago
boolean/string
true, false ou string
Indica há quanto tempo o post foi editado.
sim
user_url
string
string ou null
URL da conta que fez o post
não
username
string
string ou null
Nome de usuário da conta que fez o post
não
verified
boolean
true, false ou null
Se a conta que fez o post é verificada
não
videoplays
number
Número inteiro positivo
Número de vezes que um vídeo foi executado. *Disponível quando type é
video
sim
Attachment
Campo
Tipo
O que retorna
Descrição
Obrigatório
id
string
ID
ID do anexo
sim
media_type
string
string
Tipo de mídia anexada na publicação. Os valores possíveis são: IMAGE, VIDEO
sim
storage_url
string
string
URL da mídia anexada, na Storage
não
url
string
string
URL da mídia anexada
não
Corpo da resposta em json
{"limit":5,"next_offset":5,"offset":0,"posts":[{"AAA_score":0.01,"_id":"6ce394e9501de69ece782e93d7336dcb5177b8f3bc89e249dd59d606dd7fcf13_News","attachments":[{"id":"6ce394e9501de69ece782e93d7336dcb5177b8f3bc89e249dd59d606dd7fcf13","media_type":"IMAGE","storage_url":"https://www.odocumento.com.br/content/images/2025/01/a-a-21.png","url":"https://www.odocumento.com.br/content/images/2025/01/a-a-21.png"}],"authors":[],"channel":"Portais","comments":0,"computer_vision":{"has_image_text":true,"text":"<u>civil</u> <u>comentoon</u> <u>connon</u> <u>less</u> <u>many</u> <u>i</u> ii <u>el</u> <u>i</u> <u>new</u> <u>nert</u> <u>and</u> <u>i</u> <u>the</u> <u>vocc</u> a 2014 <u>iii</u> <u>t</u> 2 a t m"},"contact_reasons":[],"crawled_at":1737563090182,"critical_level":0,"dislikes":0,"emotion":"","favorability":[],"favorite":false,"features":["NEWS"],"followers":45330,"footage":0,"from_integration":false,"gender":"Homem","group_polarity":[{"group":"[test]","sentiment":0.0},{"group":"ANAST\u00c1CIA","sentiment":0.0}],"groups":["[test]","ANAST\u00c1CIA"],"hashtags":[],"hidden_by_user":false,"hot":2485.419285,"hot_post":false,"image_url":"https://www.odocumento.com.br/content/images/2025/01/a-a-21.png","impact":0,"interactions":0,"interests":["Animais de Estima\u00e7\u00e3o","a","Cursos de bitoneteiro","Animais de Estima\u00e7\u00e3o / Aqu\u00e1rios","spotify","Aeroporto / Linhas A\u00e9reas","Artes & Entretenimento"],"is_dynamic_post":false,"lang":"pt","likes":0,"location":"Brasil","long_posted_at":1737571860000,"long_updated_at":1737571860000,"max_shared_followers":0,"max_shared_show_dossier":false,"mentions":[],"metrics_updated_at":"22/01/2025 13:24","name":"odocumento.com.br","nlp_text_hash":"194d0a5a5851226238ef673ecc2da7cdb17d8885e82306f95597d93128102acb","order_by":"hot","pages":[],"pid":"6ce394e9501de69ece782e93d7336dcb5177b8f3bc89e249dd59d606dd7fcf13","post_url":"https://odocumento.com.br/o-aval-brasileiro-ao-ditador-maduro/","posted_at":"22/01/2025 15:51","primary_channel":"News","reactions":0,"replied":false,"reply_pid":"6ce394e9501de69ece782e93d7336dcb5177b8f3bc89e249dd59d606dd7fcf13","sentiment":2,"shares":0,"spam":false,"spokesman":[],"status":"Pendente","summary_text":"<b>Resumo</b>: O <u>Ditador</u> <u>Nicol\u00e1s</u> <u>Maduro</u> assumiu o <u>terceiro</u> <u>mandato</u> <u>como</u> <u>presidente</u> da <u>Venezuela</u> na <u>Assembleia</u> <u>Nacional</u>, em <u>Caracas</u>, em 10/1. <u>L\u00edder</u> <u>chavista</u> tomou <u>posse</u> <u>em</u> <u>meio</u> <u>a</u> <u>contesta\u00e7\u00f5es</u> <u>sobre</u> <u>resultado</u> <u>eleitoral</u> <b>e</b> <u>ten......","tags":[],"text":"O <u>Ditador</u> <u>Nicol\u00e1s</u> <u>Maduro</u> assumiu o <u>terceiro</u> <u>mandato</u> <u>como</u> <u>presidente</u> da <u>Venezuela</u> na <u>Assembleia</u> <u>Nacional</u>, em <u>Caracas</u>, em 10/1. <u>L\u00edder</u> <u>chavista</u> tomou <u>posse</u> <u>em</u> <u>meio</u> <u>a</u> <u>contesta\u00e7\u00f5es</u> <u>sobre</u> <u>resultado</u> <u>eleitoral</u> <b>e</b> <u>tens\u00e3o</u> com a......","theme_polarity":[{"sentiment":0.0,"theme":"N\u00e3o convers\u00e1veis_7178381"},{"sentiment":0.0,"theme":"teeeeemasssss_769246"},{"sentiment":0.0,"theme":"teste23_9517158"}],"themes":["N\u00e3o convers\u00e1veis - testani","AAteeeeemasssss","teste23"],"title":"O <u>aval</u> <u>brasileiro</u> ao <u>ditador</u> <u>Maduro</u>","type":"image","uid":"7110fdc2df2da5397876f195cd57770b21370e37ca12f88d6a291db8e72da5e3","update_time_ago":"Nunca editado","user_url":"http://odocumento.com.br","username":"odocumento.com.br","valoration":0.0,"verified":false,"videoplays":0}],"request_time_millis":159}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Estatísticas
Retorna estatísticas de publicações, grupos e temas disponíveis na página de Estatísticas do Warroom. Se quiser saber mais acesse aqui.
Limitações
Se o serviço demorar mais de 60 segundos para responder, a requisição será interrompida e um erro é retornado. Quando isso acontecer basta fazer a requisição mais uma vez que os dados, provavelmente, já estarão prontos.
Request
curl -H'Content-Type: application/json'\-X GET \'https://api.stilingue.com.br/wrapi/estatisticas/{{TOKEN}}'\-ddate_range=30d \-dremoved=false\-dchannels=Facebook%3AInstagram \-dgenders=Marca \
Parâmetros da requisição
Campo
Tipo
Exemplo
Descrição
Obrigatório
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no icone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Nome dos grupos da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
interests
string
InteressesA
Lista de interesses para serem filtrados. Separar múltiplas valores usando dois pontos. Interesses podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
order_by
string
date_desc
Ordem na qual as publicações aparecem. Os valores possíveis são:
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Quando estão falando
O endpoint traz um conjunto de dados que servem de base para os gráficos que mostra a Distribuição Temporal das publicações coletadas na pesquisa. Esses gráficos indicam a média de distribuição por hora, por dia do mês, por dia da semana e por mês, o que facilita a identificação dos principais picos de coleta no período analisado. Documentação detalhada
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Nome dos grupos da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
interests
string
InteressesA
Lista de interesses para serem filtrados. Separar múltiplas valores usando dois pontos. Interesses podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
removed
boolean
false
Retorna apenas publicações apagadas (o padrão é false)
Lista com tamanho fixo 4. Cada item dessa lista representa um tipo de análise de sentimento: Positivo, Negativo, Neutro e Não classificado por agrupados por dia.
byday_categories
List
Valores apenas dos dia do mês analisado, ordenados de forma crescente.
byday_linechart
List
Índice de sentimento, ordenado de forma crescente por dia, considerando um cálculo que pode ser consultado na documentação de negócio aqui. Relativo ao gráfico seria a linha roxa
byday_reach_linechart
List
Alcance potencial, ordenado de forma crescente por dia, considerando um cálculo que pode ser consultado na documentação de negócio aqui. Relativo ao gráfico seria a linha azul
Lista com tamanho fixo 4. Cada item dessa lista representa um tipo de análise de sentimento: Positivo, Negativo, Neutro e Não classificado por agrupados por hora.
byhour_categories
List
Legenda relativa ao horário e em como ele está ordenado.
byhour_linechart
List
Índice de sentimento, ordenado de forma crescente por hora, considerando um cálculo que pode ser consultado na documentação de negócio aqui. Relativo ao gráfico seria a linha roxa
byhour_reach_linechart
List
Alcance potencial, ordenado de forma crescente por hora, considerando um cálculo que pode ser consultado na documentação de negócio aqui. Relativo ao gráfico seria a linha azul
Lista com tamanho fixo 4. Cada item dessa lista representa um tipo de análise de sentimento: Positivo, Negativo, Neutro e Não classificado por agrupados por mês.
bymonth_categories
List
Legenda relativa ao mês e em como ele está ordenado.
bymonth_linechart
List
Índice de sentimento, ordenado de forma crescente por mês, considerando um cálculo que pode ser consultado na documentação de negócio aqui. Relativo ao gráfico seria a linha roxa
bymonth_reach_linechart
List
Alcance potencial, ordenado de forma crescente por mês, considerando um cálculo que pode ser consultado na documentação de negócio aqui. Relativo ao gráfico seria a linha azul
Lista com tamanho fixo 4. Cada item dessa lista representa um tipo de análise de sentimento: Positivo, Negativo, Neutro e Não classificado por agrupados por dia da semana.
byweekday_categories
List
Legenda relativa ao dia da semana e em como ele está ordenado.
byweekday_linechart
List
Índice de sentimento, ordenado de forma crescente por dia da semana, considerando um cálculo que pode ser consultado na documentação de negócio aqui. Relativo ao gráfico seria a linha roxa
byweekday_reach_linechart
List
Alcance potencial, ordenado de forma crescente por dia da semana, considerando um cálculo que pode ser consultado na documentação de negócio aqui. Relativo ao gráfico seria a linha azul
total_posts
int
Total de posts (publicações).
Info
Campo
Tipo
Descrição
data
List
Uma lista de tamanho fixo seguindo as seguintes regras: byday.data: Tamanho será de 31, representando os dias do mês. Ordenado do dia 1 até o último dia do mês. byhour.data: Tamanho será de 24, representando as horas do dia. Ordenado das 00:00 até as 23:59. bymonth.data: Tamanho será de 12, representando total de meses no ano. Ordenado de Janeiro à Dezembro. byweekday.data: Tamanho será de 7, representando total de dias da semana. Ordenado de Domingo à Sábado.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Ranking Evolutivo
Neste endpoint, é possível acessar os dados do gráfico Ranking/Evolução que compõem a seção Descobertas - O QUE estão falando, e permite que as publicações da sua pesquisa sejam apresentados visualmente como um ranqueamento evolutivo mensurado pelo número de publicações. Para saber mais sobre esse gráfico acesse a documentação, clicando aqui..
No gráfico é possível visualizar os dados considerando os valores para curtidas, compartilhamentos e outros critérios. No entanto, com este endpoint só é possível mensurar pelo número de publicações.
No gráfico também é possível escolher visualizar os dados considerando os temas cadastrados na pesquisa, porém na API traz apenas os dados referentes aos grupos.
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de temas por canal que serão retornados
com sentimento. Caso não informado é limitado a retornar o máximo
possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos
parâmetros. Os filtros codificados não precisam ser enviados novamente
como parâmetros na requisição. Para gerar um filtro, acesse o
Warroom
> Clique no ícone de filtro e selecione a aba (Filtro de publicações ou
Filtro de conversas) > configure os parâmetros > copie, da URL do
navegador, o valor do parâmetro filters, que será atualizado com
código do filtro. Exemplo:
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção:Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema.
Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
não
Corpo da resposta
Campo
Tipo
Descrição
data_represented
string
Especifica se o gráfico está considerando grupos ou temas.
end_date
number
Data de fim passada na requisição.
interval_count
number
Número de dias do intervalo de data passado.
request_time_ms
number
Indica tempo total que levou para fazer a consulta.
start_date
number
Data de inicio passada na requisição.
subjects
List
Lista que contém o nome de todos os grupos.
subjects_avaliable
List
Lista que contém o nome dos grupos que irão aparecer no gráfico.
Lista de objetos que inclui o nome do grupo, sua posição e quantidade de publicações diárias.
theme_title
string
Nome do grupo.
Data
Campo
Tipo
Descrição
date
String
Data correspondente aos dados apresentados.
position
number
Posição do grupo no ranking
themes_descriptors
List
Lista com termos associados ao grupo.
value
number
Número de publicações do grupo para o dia especificado
Corpo da resposta em json
{"data_represented":"groups","end_date":202501192359,"interval_count":3,"request_time_millis":8318,"start_date":202501170000,"subjects":["3 termos","Andre - Rexona","ANASTÁCIA"],"subjects_avaliable":["3 termos","Andre - Rexona","ANASTÁCIA"],"themes":[{"data":[{"date":"2025/01/17 00:00","position":20,"themes_descriptors":["Motivos","RISOS","Bom Jogo","Dandadan","Igual"],"value":"116"},{"date":"2025/01/18 00:00","position":17,"themes_descriptors":["Celular"],"value":"1"},{"date":"2025/01/19 00:00","position":20,"themes_descriptors":["Rosiron Rodrigues","Vale","Tempo De Corinthians","Boa","Autossuficiente"],"value":"38"}],"theme_title":"3 termos"},{"data":[{"date":"2025/01/17 00:00","position":22,"themes_descriptors":["Pre Agendas Nos EUA","Bolsonaro","Argentina","Brasil Argentina","Uniao"],"value":"226"},{"date":"2025/01/18 00:00","position":20,"themes_descriptors":["Entrevista De Ontem","Projeto De Lei"],"value":"2"},{"date":"2025/01/19 00:00","position":16,"themes_descriptors":["Pais Da America Do Sul","EUA","Bolsonaro","Argentina"],"value":"9"}],"theme_title":"ANASTÁCIA"},{"data":[{"date":"2025/01/17 00:00","position":2,"themes_descriptors":[],"value":"0"},{"date":"2025/01/18 00:00","position":13,"themes_descriptors":["Dentro Do Short"],"value":"1"},{"date":"2025/01/19 00:00","position":21,"themes_descriptors":["RexonaNoBBB25","Novinho Roludo","Amigo Com CC","Tensao Entre Irmaos","Volumenoshort"],"value":"39"}],"theme_title":"Andre - Rexona"}],"themes_count":32,"time_interval":"dias","title_chart":"5861432068407296","total_posts":25318}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Temas e Tópicos
Com o endpoint é possível acessar os termos mais mencionados nas publicações coletadas em sua pesquisa para os grupos cadastrados. Além disso, o retorno inclui a quantidade de publicações com sentimentos classificados como positivo, neutro ou negativo para os mesmos grupos. Para saber mais sobre o gráfico pode acessar a documentação: Documentação sobre temas e tópicos
Intervalo de datas que precisa ser retornado os dados no formato
Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm,
d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado
50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos
maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Caso esse parâmetro não seja informado, será considerado 1d.
não
limit
number
100
Esse limite define a quantidade de termos por grupo que serão retornados
com sentimento. Caso não informado é limitado a retornar o máximo
possível que é 100.000
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
não
offset
number
10
Define a paginação de N publicações para frente, ou seja, se o offset
for 1000, os primeiros 1000 posts serão ignorados pegando a partir dos
1001 até 2000.
não
channels
string
Instagram:Facebook
Filtra resultados de canais específicos, caso precise informar mais de
um, deve separá-los com dois pontos. Os valores possíveis são:
(Twitter, Instagram, InstagramComments, Facebook, FacebookComments,
YouTube, YouTubeComments, News, Blogs, Linkedin). Caso não seja informado, será considerado todos os canais.
não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações, trazendo análise de
sentimento apenas dos temas desses ids informados. Separar múltiplos
valores usando dois pontos
não
uids
number
149775728483392:17841401681785347
Filtra pelo id do usuário, trazendo análise apenas dos temas encontrados
nos posts desses usuários.
não
groups
string
GroupA:GroupB
Filtra usando os grupos informados, trazendo sentimento apenas de posts
que contenham esse grupo. Separar múltiplos valores usando dois pontos.
Grupos podem ser encontrados ao acessar a área de editar pesquisa no
Warroom
não
themes
string
TemaA:TemaB
Temas que serão usados para filtrar as análises dos sentimentos, pegando
apenas posts que contenham esses temas. Caso precise passar mais de um
tema separe-os com dois pontos.
Atenção: Irá retornar todos os posts que contenham determinado tema especificado, porém, se o mesmo post tiver vários temas, trará todos os temas correspondentes, e não apenas um tema especificado.
não
tags
string
TagA:TagB
Tags que serão usadas para filtrar as análises de sentimento, trazendo
apenas temas que contenham essa tag no post. Caso precise informar mais de uma tag, separá-las por dois pontos.
não
interests
string
InteresseA:InteresseB
Interesses que serão usados para filtrar análises de sentimento,
trazendo apenas temas que contenham esses interesses para análise. Para
filtrar por mais de um interesse, basta usar dois pontos.
não
devices
string
Computador
Campo usado para filtrar temas que estejam nesse device. Valores
possíveis: Computador ou Mobile
não
types
string
Text:Image
Esse campo é usado para filtrar tipos de posts que podem ser:
Text, Image, Video e Audio. Caso queira filtrar por mais de
um tipo, basta passar eles separados por dois pontos.
não
sentiment
number
1
Esse campo permite filtrar os resultados considerando apenas um tipo específico de sentimento para cada tema. Por exemplo, se você quiser contabilizar apenas sentimentos positivos, negativos ou neutros, utilize um dos valores abaixo:
1 para positivo, -1 para negativo e 0 para neutro.
não
langs
string
pt
Valor a ser usado para filtrar os resultados dos temas para uma
determinada lingua. Os valores possíveis são: en, pt, es
não
removed
boolean
true
Indica se deve considerar os posts que foram removidos(marcados como
spam) na análise de sentimentos. Valor padrão é false
Esse campo traz os valores de publicações separadas por sentimentos, ou seja, quantidade de publicações que se encaixam como positivas, negativas e neutras.
posts_count
number
Número com a quantidade total de publicações.
request_time_ms
number
Indica tempo total que levou para fazer a consulta.
Lista de objetos que apresenta a quantidade de publicações coletadas para os sentimentos positivo, negativo e neutro, juntamente com suas respectivas porcentagens.
sentiment
string
Sentimento associado ao respectivo grupo.
weight
number
Valor do peso associado ao grupo.
Groups Interno
Campo
Tipo
Descrição
label
string
Nome do termo coletado para o respectivo grupo.
weight
number
Peso associado ao termo coletado para o grupo.
Polarities
Campo
Tipo
Descrição
count
number
Quantidade de publicações coletadas referentes ao sentimento positivo, negativo ou neutro.
percent
number
Quantidade de publicações coletadas em porcentagem.
Corpo da resposta em json
{"groups":[{"groups":[{"label":"Bbb, Globo","weight":276},{"label":"BBB, Casa","weight":275}],"label":"BBB25","polarities":[{"negative":{"count":595,"percent":41.204986149584485}},{"neutral":{"count":381,"percent":26.385041551246534}},{"positive":{"count":468,"percent":32.40997229916898}}],"sentiment":"negative","weight":3772},{"groups":[{"label":"Segunda Feira, EUA, Novo Governo","weight":296},{"label":"Trump, Mundo, Donald Trump","weight":229}],"label":"[test]","polarities":[{"negative":{"count":880,"percent":35.28468323977546}},{"neutral":{"count":44,"percent":1.7642341619887731}},{"positive":{"count":1570,"percent":62.951082598235764}}],"sentiment":"positive","weight":3594}],"polarities":{"negative":3252,"neutral":1464,"positive":3834,"total":8550},"posts_count":8522,"request_time_millis":855}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Termos correlacionados
O endpoint traz termos que estão correlacionados, isto é, uma análise mais detalhada que mostra os termos mais populares entre as publicações da sua pesquisa e também a relação entre cada um dos termos. Por exemplo, na imagem que segue, o termo Avião sendo correlacionado a Acidente e Acidente tendo dois outros termos correlacionados Goias e Prefeitura, representando o volume de conversas em torno desses termos. Para mais detalhes, clique aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Objeto contendo estrutura de termos correlacionados com estatísticas
onde cada children representa um termo relacionado a outro, ou seja,
caso o termo Brazil seja identificado e existam dois termos
relacionados a ele como Ano Novo e
Mega da virada, a estrutura será Brazil sendo o nó maior
com dois child, um Ano Novo e outro Mega da virada.
coreferences
Dicionário de Array de String
Essa propriedade traz as correspondências dos termos e todas as formas
possíveis que aquele termo pode ser encontrado/escrito.
Objeto contendo dados estatísticos de um determinado termo.
id
numero
Esse id será um id sequencial de termos relacionados. Funciona da
seguinte forma: nó maior(root) terá id (0), primeiro conjunto de nós
maiores começa a partir do id 1 e vai até no máximo id 10, os nós
internos desses primeiros child(termos) seguem a mesma lógica, começando
a partir de 11 e indo até no máximo 20, nós internos desses nos começam
em 21 e vão até 30 e assim sucessivamente.
name
string
Nome do termo analisado.
type
string
O tipo de estatística analisada, neste caso sempre será
Term.
Data
Campo
Tipo
Descrição
acceleration
number
Velocidade em que um determinado termo é comentado nas redes sociais.
Quanto maior esse número quer dizer que maior a quantidade de pessoas
falando sobre determinado termo em um curto espaço de tempo.
mentions
number
Quantidade de vezes que o termo foi encontrado.
negative
number
Quantidade de vezes que um sentimento negativo foi encontrado ao
relacionar determinado termo.
neutral
number
Quantidade de vezes que um sentimento neutro foi encontrado ao
relacionar determinado termo.
normalized_acceleration
number
-
normalized_mentions
number
-
positive
number
Quantidade de vezes que um sentimento positivo foi encontrado ao
relacionar determinado termo.
sentiment
number
-
total_posts
number
Quantidade total de posts analisados com determinado termo.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Métricas Proprietárias
Posts e métricas de páginas conectadas ao Warroom. Para saber mais clique aqui
Publicações Proprietárias
Retorna as publicações do Warroom encontradas em Métricas Proprietárias > Publicações. Essas são publicações apenas de páginas que estão conectadas ao Warroom. A coleta de todas as páginas conectadas são retornadas neste endpoint. Para saber mais detalhes, clique aqui
Para acessar os dados do Warroom que serão retornados, segue a imagem abaixo.
Se o serviço demorar mais de 60 segundos para responder, a requisição será interrompida e um erro é retornado. Quando isso acontecer basta fazer a requisição mais uma vez que os dados, provavelmente, já estarão prontos.
Dados das redes sociais (Facebook, Instagram, Twitter, YouTube e Linkedin) encontram-se desidratados (alguns campos são sempre null) por conta de compliance/LGPD.
Para acessar dados desidratados, é necessário utilizar os IDs de cada entidade (pid para dados do post e uid para dados do usuário) e buscar na API oficial da rede social.
Em cada requisição desta API é possível fazer apenas uma request por vez.
O page id necessário para essa requisição pode ser pego usando esta documentação: Pegar id paginas conectadas
Request
curl -H'Content-Type: application/json'\-X GET \'https://api.stilingue.com.br/metricaspro/{channel}/posts/{api-token}/{page-id}'\-ddate_range=202402040000:202501282359 \-dlimit=20 \
Parâmetros da requisição
Campo
Tipo
O que retorna
Descrição
Obrigatório
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days
number
2
Esse campo traz dados do dia N antes de hoje. Ex: hoje é 05/01, se o valor for 2, os dados retornados serão do dia 03/01
Atenção: esse filtro sobrescreve o filtro date_range
Não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Nome dos grupos da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
interests
string
InteressesA
Lista de interesses para serem filtrados. Separar múltiplas valores usando dois pontos. Interesses podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
order_by
string
date_desc
Ordem na qual as publicações aparecem. Se nada é enviado o valor padrão é `hot`. Os valores possíveis são:
Canal origem do post. Os valores possíveis são: `Twitter, Instagram, InstagramComments,
Facebook, FacebookComments, YouTube, YouTubeComments, News, Blogs,
Linkedin`. Atenção, novos canais podem ser adicionados a qualquer
momento.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Alcance no tempo
O alcance é uma métrica vinda diretamente do Instagram que representa o número de pessoas que visualizaram uma publicação da sua página. No caso dessa métrica, mesmo que um usuário tenha visto a mesma publicação 5 vezes, ele será contado apenas uma vez, já que é um usuário único. Para mais detalhes sobre essa métrica, acesse aqui.
Para acessar os dados do Warroom que serão retornados, observe a imagem abaixo.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Comentários
O endpoint Comentários retorna todos os comentários feitos em um post de uma página proprietária no LinkedIn. A resposta inclui diversas métricas relacionadas tanto ao post quanto aos comentários, proporcionando uma visão detalhada do engajamento. Para mais detalhes clique aqui.
Token de autenticação necessário para acessar os dados
Sim
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
{"access_token":"abc","from_cache":false,"limit":1,"next_offset":1,"offset":0,"page_info":{"name":"Coruja Testadora.","profile_pic":"https"},"posts":[{"_id":"urn:li:comment:(urn:li:activity:7296192613433458688,7296194513922932737)_LinkedInComments","answered":true,"channel":"LinkedInComments","children":[{"_id":"urn:li:comment:(urn:li:activity:7296192613433458688,7296256941222170625)_LinkedInComments","channel":"LinkedInComments","comments":0,"contact_reasons":[],"crawled_at":1739563383152,"critical_level":0,"cvtags":[],"dislikes":0,"emotion":"","favorite":false,"features":[],"followers":1,"from_integration":false,"gender":"","group_polarity":[],"hashtags":[],"hidden_by_user":false,"hot":2495.376048435,"hot_post":false,"integration_name":null,"interactions":0,"is_dynamic_post":false,"is_root":false,"lang":"pt","likes":0,"location":"","long_posted_at":1739563212687,"long_updated_at":1741946760000,"mentions":[],"metrics_updated_at":"14/03/2025 07:06","name":"Coruja Testadora.","names":[],"nlp_text_hash":"6732612f59906b9452c876b2d4a17d0fcc00dcf3d9472337ed205101e2305627","occupations":[],"page_comment":true,"page_id":"urn:li:organization:91026992","pages":["urn:li:organization:91026992"],"pid":"urn:li:comment:(urn:li:activity:7296192613433458688,7296256941222170625)","polarity":1,"post_id":"urn:li:share:7296192612514881536","post_url":"https://www.linkedin.com/feed/update/urn:li:activity:7296192613433458688?commentUrn=urn%3Ali%3Acomment%3A%28activity%3A7296192613433458688%2C7296194513922932737%29&replyUrn=urn%3Ali%3Acomment%3A%28activity%3A7296192613433458688%2C7296256941222170625%29","post_user_image_url":"https://media.licdn.com/dms/image/v2/D4D0BAQHUrW6bCI0mrw/company-logo_400_400/company-logo_400_400/0/1692200318589/guttoys_logo?e=1749686400&v=beta&t=hBn21ZUhCb_X2RIXwpaHUTOAXVFisgC-mq7kKyC-Wv0","posted_at":"14/02/2025 17:00","primary_channel":"LinkedIn","raw_posted_at":{"$date":"2025-02-14T20:00:12.687Z"},"reactions":0,"reclame_aqui":null,"replied":false,"reply_pid":"urn:li:comment:(urn:li:activity:7296192613433458688,7296256941222170625)","root_id":"urn:li:comment:(urn:li:activity:7296192613433458688,7296194513922932737)","sac_call_id":"urn:li:comment:(urn:li:activity:7296192613433458688,7296194513922932737)","sac_type":"PostComment","same_text":null,"same_text_posts":null,"same_user":null,"same_user_posts":null,"shares":0,"spam":false,"status":"Ignorado","tags":[],"text":"<u>Ficaremos</u> <u>atentos</u> <u>ao</u> <u>ponto</u> <u>colocado</u>.","text_append":null,"text_header":null,"theme_polarity":[],"themes":[],"title":"","type":"post","uid":"urn:li:organization:91026992","update_time_ago":"3 semanas atrás","url_content":null,"user_comments":64,"user_image_url":"https://media.licdn.com/dms/image/v2/D4D0BAQHUrW6bCI0mrw/company-logo_400_400/company-logo_400_400/0/1692200318589/guttoys_logo?e=1749686400&v=beta&t=hBn21ZUhCb_X2RIXwpaHUTOAXVFisgC-mq7kKyC-Wv0","user_score":0.01,"user_url":"https://www.linkedin.com/company/91026992","username":"","verified":false,"videoplays":0}],"comments":43,"contact_reasons":[],"crawled_at":1739549165049,"critical_level":0,"custom_fields":{"name":"Guto Castelão"},"cvtags":[],"dislikes":0,"emotion":"","favorite":false,"features":[],"followers":0,"from_integration":false,"gender":"Homem","group_polarity":[],"hashtags":[],"hidden_by_user":false,"hot":2496.9350977505796,"hot_post":false,"integration_name":null,"interactions":43,"is_dynamic_post":false,"is_root":true,"lang":"pt","likes":0,"location":"","long_posted_at":1739548328859,"long_updated_at":1741946700000,"mentions":[],"metrics_updated_at":"14/03/2025 07:05","name":"Guto Castelão 🏳️🌈","names":[],"nlp_text_hash":"b89014b2e82bfd02ce55afd844101822b586bc19b2690253c8c50001578cdb76","occupations":[],"page_comment":false,"page_id":"urn:li:organization:91026992","pages":["urn:li:organization:91026992"],"pid":"urn:li:comment:(urn:li:activity:7296192613433458688,7296194513922932737)","polarity":1,"post_details":{"_id":"urn:li:share:7296192612514881536_LinkedIn","channel":"LinkedIn","comments":44,"contact_reasons":null,"crawled_at":1739548169399,"critical_level":0,"cvtags":[],"dislikes":0,"emotion":"","favorite":false,"fb_clicks":1,"fb_engagement_rate":5,"fb_impressions":9,"features":[],"followers":8,"from_integration":false,"gender":"","group_polarity":[],"hashtags":[],"hidden_by_user":false,"hot":2496.942816246486,"hot_post":false,"image_url":"https://media.licdn.com/dms/image/v2/D4D22AQEsZUvDrvOQcQ/feedshare-shrink_2048_1536/B4DZUFIhH4HAA0-/0/1739547874561?e=1742428800&v=beta&t=aXFt6XqF8MkpVDCsI9ejpGvh0KWrSd9EVq6W83yDUjY","integration_name":null,"interactions":44,"is_dynamic_post":false,"is_root":false,"lang":"pt","likes":0,"location":"","long_posted_at":1739547875714,"long_updated_at":1741954860000,"mentions":[],"metrics_updated_at":"14/03/2025 09:21","name":"Coruja Testadora.","names":[],"nlp_text_hash":"b91c4ec88499312b4a47843ce885c0a1ce9c81f5f7ca6871611f37961ad7bb0a","occupations":[],"pid":"urn:li:share:7296192612514881536","polarity":3,"post_id":"urn:li:share:7296192612514881536","post_url":"https://www.linkedin.com/feed/update/urn:li:share:7296192612514881536","post_user_image_url":"https://media.licdn.com/dms/image/v2/D4D0BAQHUrW6bCI0mrw/company-logo_400_400/company-logo_400_400/0/1692200318589/guttoys_logo?e=1747872000&v=beta&t=ag8t08bcStCeOw7u4eSo1gyHHZEIheOzEmwDWd3GyfU","posted_at":"14/02/2025 12:44","primary_channel":"LinkedIn","raw_posted_at":{"$date":"2025-02-14T15:44:35.714Z"},"reactions":0,"reclame_aqui":null,"replied":false,"reply_pid":"urn:li:share:7296192612514881536","root_id":"urn:li:share:7296192612514881536","sac_type":"Post","same_text":null,"same_text_posts":null,"same_user":null,"same_user_posts":null,"shares":0,"spam":false,"status":"Pendente","tags":[],"text":"A técnica secreta do clã Shiranui","text_append":null,"text_header":null,"theme_polarity":[],"themes":[],"title":"","type":"image","uid":"urn:li:organization:91026992","update_time_ago":"Nunca editado","url_content":null,"user_image_url":"https://media.licdn.com/dms/image/v2/D4D0BAQHUrW6bCI0mrw/company-logo_400_400/company-logo_400_400/0/1692200318589/guttoys_logo?e=1747872000&v=beta&t=ag8t08bcStCeOw7u4eSo1gyHHZEIheOzEmwDWd3GyfU","user_score":0.01,"user_url":"https://www.linkedin.com/company/91026992","username":"coruja-testadora","verified":false,"videoplays":0},"post_id":"urn:li:share:7296192612514881536","post_url":"https://www.linkedin.com/feed/update/urn:li:activity:7296192613433458688?commentUrn=urn%3Ali%3Acomment%3A%28activity%3A7296192613433458688%2C7296194513922932737%29","post_user_image_url":"https://media.licdn.com/dms/image/v2/D4E03AQEaE3jUad0lUQ/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1723213967103?e=1744848000&v=beta&t=Zx4xUn5nub7KcR9ZxYJu4AvUxFbqp9EbdiGFbFY9F68","posted_at":"14/02/2025 12:52","primary_channel":"LinkedIn","raw_posted_at":{"$date":"2025-02-14T15:52:08.859Z"},"reactions":0,"reclame_aqui":null,"replied":false,"reply_pid":"urn:li:comment:(urn:li:activity:7296192613433458688,7296194513922932737)","root_id":"urn:li:share:7296192612514881536","sac_call_id":"urn:li:comment:(urn:li:activity:7296192613433458688,7296194513922932737)","sac_type":"PostComment","same_text":null,"same_text_posts":null,"same_user":null,"same_user_posts":null,"shares":0,"spam":false,"status":"Ignorado","tags":[],"text":"Esse <b>é</b> o <b><u>tema</u> <u>mais</u> <u>divertido</b></u> de todos","text_append":null,"text_header":null,"theme_polarity":[{"polarity":0,"theme":"tema mais divertido_9237797"},{"polarity":0,"theme":"teeeeemasssss_769246"}],"themes":["tema mais divertido do mundo","AAteeeeemasssss"],"title":"","type":"post","uid":"urn:li:person:YZGIJoo0No","update_time_ago":"3 semanas atrás","url_content":null,"user_comments":7,"user_image_url":"https://media.licdn.com/dms/image/v2/D4E03AQEaE3jUad0lUQ/profile-displayphoto-shrink_800_800/profile-displayphoto-shrink_800_800/0/1723213967103?e=1744848000&v=beta&t=Zx4xUn5nub7KcR9ZxYJu4AvUxFbqp9EbdiGFbFY9F68","user_score":0.01,"user_url":"https://www.linkedin.com/in/gucastelao","username":"","verified":false,"videoplays":0}],"total_posts":5}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Comparar fan pages
Esse endpoint traz algumas dados quantitativos de performance das páginas proprietárias do Facebook que estão conectadas no Warroom em termos comparativos. Para entender detalhadamente sobre esse recurso, consulte a documentação aqui
Page ids para serem comparados. Separar múltiplos valores usando dois pontos.
Sim
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Os dados são referente a um comparativo de publicações e interações das páginas. Dentro do Warroom seu representativo é atualmente o gráfico 'Radar de concorrência'
Esses dados são referente ao volume de fãs das páginas representado por dias. Dentro do Warroom seu representativo é atualmente o gráfico 'Fãs das páginas'
Esse campo retorna dados referente a duas métricas agrupadas, que seriam um comparativo de interações das páginas e um comparativo por volume de publicações. Dentro do Warroom seus representativos gráficos são: 'Comparativo por volume de interações' e 'Comparativo por volume de publicações' respectivamente.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Evolução da Base de fãs
Este endpoint permite acompanhar os dados exibidos na tela "Evolução da Base de Fãs". Com essa ferramenta, é possível selecionar um período e visualizar uma linha do tempo para analisar se um post contribuiu para o ganho de novos fãs ou impactou negativamente a base existente. Para acessar o gráfico, é necessário conectar a rede social cujas métricas deseja acompanhar. Para saber mais detalhes sobre as métricas você pode acessar aqui.
ID da página conectada. Os IDs podem ser encontrados em Get pages
Sim
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no icone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
sentimento
integer
-1
Filtrar por sentimento (-1: negativo, 0: neutro, 1: positivo)
Não
dark_post
boolean
false
Filtra publicações que são ou não dark posts
Não
pids
number
987654321
IDs das publicações para filtrar
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
devices
string
mobile
Tipo de dispositivo (computador ou mobile)
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
last_days
number
30
Substitui date_range, trazendo dados dos últimos N dias
Não
annotated
boolean
true
Filtra publicações que tiveram anotações realizadas
Não
order_by
string
date_desc
Ordem na qual as publicações aparecem. Os valores possíveis são:
Quantidade de novos seguidores adquiridos em determinado período.
Counter
Campo
Tipo
Descrição
date
Date
Data de ingresso do novo seguidor
value
number
Quantidade de novos seguidores adquiridos.
Objeto Parâmetros de Requisição
Campo
Tipo
Descrição
account_id
number
Identificação única da conta conectada.
universe_id
number
Identificação do universo ao qual a conta pertence.
page_id
number
Identificação única da página conectada.
ids
List
Lista de identificadores das páginas incluídas na análise.
date_range
Date
Período da análise dos dados.
filter
Object
Filtros aplicados na requisição.
path_info
string
Endpoint utilizado para obter os dados.
decoded_filters
Object
Filtros detalhados aplicados à requisição.
from_cache
string
Indica se os dados foram obtidos do cache.
Corpo da resposta em json
{"results":[{"name":"Dia com ativação","data":[{"date":"2025/01/06","value":3},{"date":"2025/01/07","value":7},{"date":"2025/01/08","value":1},{"date":"2025/01/09","value":2},{"date":"2025/01/10","value":1},{"date":"2025/01/11","value":1},{"date":"2025/01/12","value":0},{"date":"2025/01/13","value":4},{"date":"2025/01/14","value":436},{"date":"2025/01/15","value":638},{"date":"2025/01/16","value":529},{"date":"2025/01/17","value":27},{"date":"2025/01/18","value":10},{"date":"2025/01/19","value":15},{"date":"2025/01/20","value":25},{"date":"2025/01/21","value":0}]},{"name":"Novos fãs","data":[{"date":"2025/01/06","value":62},{"date":"2025/01/07","value":51},{"date":"2025/01/08","value":42},{"date":"2025/01/09","value":54},{"date":"2025/01/10","value":54},{"date":"2025/01/11","value":75},{"date":"2025/01/12","value":83},{"date":"2025/01/13","value":44},{"date":"2025/01/14","value":58},{"date":"2025/01/15","value":43},{"date":"2025/01/16","value":91},{"date":"2025/01/17","value":73},{"date":"2025/01/18","value":123},{"date":"2025/01/19","value":143},{"date":"2025/01/20","value":122}]},{"name":"Cancelamentos","data":[{"date":"2025/01/06","value":20},{"date":"2025/01/07","value":21},{"date":"2025/01/08","value":25},{"date":"2025/01/09","value":10},{"date":"2025/01/10","value":21},{"date":"2025/01/11","value":11},{"date":"2025/01/12","value":18},{"date":"2025/01/13","value":11},{"date":"2025/01/14","value":20},{"date":"2025/01/15","value":26},{"date":"2025/01/16","value":20},{"date":"2025/01/17","value":23},{"date":"2025/01/18","value":24},{"date":"2025/01/19","value":7},{"date":"2025/01/20","value":25}]},{"name":"FanBase","data":[{"date":"2025/01/06","value":1137051},{"date":"2025/01/07","value":1137057},{"date":"2025/01/08","value":1137055},{"date":"2025/01/09","value":1137083},{"date":"2025/01/10","value":1137101},{"date":"2025/01/11","value":1137146},{"date":"2025/01/12","value":1137200},{"date":"2025/01/13","value":1137218},{"date":"2025/01/14","value":1137243},{"date":"2025/01/15","value":1137239},{"date":"2025/01/16","value":1137301},{"date":"2025/01/17","value":1137326},{"date":"2025/01/18","value":1137416},{"date":"2025/01/19","value":1137539},{"date":"2025/01/20","value":1137622},{"date":"2025/01/21","value":1137700}]}],"request_parameters":{"account_id":"123456789123456","universe_id":"987654321987654","page_id":"150346229783366032222","ids":"150346229783366032222","show_terms":"false","group_posts":"false","limit":"20","date_range":"202501060000:202501202359","filter":"{}","path_info":"/facebook/fan_evolution","decoded_filters":{"channels":{"value":["Facebook"]},"date_range":{"value":"202501060000:202501202359"},"pages":{"value":["150346229783366032222"]},"account_id":123456789123456,"universe_id":987654321987654}},"from_cache":false}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Impressões no Tempo
O endpoint de Impressões e Publicações do Instagram fornece dados analíticos sobre o desempenho de conteúdos na plataforma, permitindo visualizar métricas de impressões, publicações e stories ao longo do tempo. Os dados podem ser filtrados por período (diário, semanal ou mensal) e atualizados em tempo real para garantir informações recentes. Entre as métricas disponíveis, a API retorna a quantidade de impressões (número de vezes que uma publicação apareceu para os usuários, exceto Reels), o total de publicações (separadas entre postagens únicas e carrosséis), a quantidade de anúncios promovidos (dark posts) e o número de visualizações dos stories. Para saber mais detalhes sobre as métricas você pode acessar aqui.
Intervalo de datas que precisa ser retornado os dados no formato **Nd** ou **AAAAMMDDHHmm:AAAAMMDDHHmm**, **d** nesse exemplo representa dias. Utilizando formato **Nd**, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato **AAAAMMDDHHmm:AAAAMMDDHHmm**, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Impressões orgânicas
Esse endpoint traz informações e dados de performance da página em relação aos posts do canal Facebook, como: quantidade de publicações diárias e a relação dessa quantidade de publicações com impressões orgânicas; impressões virais; e a média de impressões. Para saber mais detalhes sobre as métricas e como o cálculo é feito, você pode acessar aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Lista com a respectiva data e o valor encontrado para aquela métrica
name
string
Nome da métrica
Data
Campo
Tipo
Descrição
date
Date(aaaa/MM/dd)
Data daquela métrica
value
number
Quantidade total para aquela métrica naquele respectivo dia
Corpo da resposta em json
{"from_cache":false,"results":[{"data":[{"date":"2025/02/18","value":100}],"name":"Publicações"},{"data":[{"date":"2025/02/18","value":50}],"name":"Impressões orgânicas"},{"data":[{"date":"2025/02/18","value":15}],"name":"Impressões virais"},{"data":[{"date":"2025/02/18","value":65}],"name":"Média de impressões"}]}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Impressões pagas
Esse endpoint retorna dados específicos dos conteúdos pagos realizados em suas páginas que estão conectadas à plataforma. Para saber mais detalhes sobre as métricas e como o cálculo é feito você pode acessar aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Lista com a respectiva data e o valor encontrado para aquela métrica
name
string
Nome da métrica
Data
Campo
Tipo
Descrição
date
Date(aaaa/MM/dd)
Data daquela métrica
value
number
Quantidade total para aquela métrica naquele respectivo dia
Corpo da resposta em json
{"from_cache":true,"results":[{"data":[{"date":"2025/02/18","value":0}],"name":"Posts"},{"data":[{"date":"2025/02/18","value":0}],"name":"Dark Posts"},{"data":[{"date":"2025/02/18","value":0}],"name":"Publicações Impulsionadas"},{"data":[{"date":"2025/02/18","value":0}],"name":"Impressões pagas"},{"data":[{"date":"2025/02/18","value":0}],"name":"Impressões dark posts"},{"data":[{"date":"2025/02/18","value":0}],"name":"Impressões impulsionadas"},{"data":[{"date":"2025/02/18","value":0}],"name":"Média de impressões"},{"data":[{"date":"2025/02/18","value":0}],"name":"Média de impressões dark posts"},{"data":[{"date":"2025/02/18","value":0}],"name":"Média de impressões impulsionadas"}]}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Interações em Stories
Retorna uma lista de interações nos Stories do Instagram dos últimos 30 dias
Disponível no Warroom em Métricas Proprietárias > Selecionar uma página do Instagram > Interações em Stories
curl -H'Content-Type: application/json'\-X GET \'https://api.stilingue.com.br/metricaspro/instagram/interacoesstory/{api-token}/{page-id}'
Parâmetros da requisição
Campo
Tipo
O que retorna
Descrição
Obrigatório
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Interações
Retorna as publicações do Warroom encontradas em Métricas Proprietárias > Interações. Para entender melhor clique aqui.
Request
curl -H'Content-Type: application/json'\-X GET \'https://api.stilingue.com.br/metricaspro/facebook/interacoes/{api-token}/{page-id}'\-ddate_range=202402040000:202501282359 \
Parâmetros da requisição
Campo
Tipo
O que retorna
Descrição
Obrigatório
page_id
string
abc123xyz
ID da página conectada. Os IDs podem ser encontrados em Get pages
Sim
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Não
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Nome dos grupos da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Grupos podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
interests
string
InteressesA
Lista de interesses para serem filtrados. Separar múltiplas valores usando dois pontos. Interesses podem ser encontrados ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
removed
boolean
false
Retorna apenas publicações apagadas (o padrão é false)
Não
pids
string
12345:67890:98765
Filtrar pelo ID de uma ou mais publicações. Separar múltiplos valores usando dois pontos
Não
uids
string
149775728483392:17841401681785347
Filtrar pelo ID de um ou mais usuários. Separar múltiplos valores usando dois pontos
Não
annotated
boolean
true
Filtra por publicações que tiveram anotações realizadas
Não
sac_type
string
comentarios
Tipo de interação do post. Os valores possíveis são:
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Campanha page likes
Este endpoint permite o acompanhamento detalhado dos novos likes em uma página do Facebook. Ele fornece uma visão segmentada dos novos seguidores, diferenciando entre aqueles adquiridos de forma orgânica e aqueles obtidos por meio de campanhas pagas. Além disso, o endpoint também calcula a média dessas métricas ao longo do tempo, facilitando a análise do crescimento da página. Para saber mais detalhes sobre as métricas você pode acessar aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Posts pagos e Orgânicos
Este endpoint permite comparar o desempenho de posts pagos e orgânicos ao longo do tempo. Para mais informações sobre impressões, consulte este artigo: Impressões Orgânicas no Facebook.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Publicações X Interações
Esse endpoint traz dados sobre qual é o volume de interações e a quantidade de publicações feitas nas páginas proprietárias conectadas. Para saber mais detalhes sobre as métricas e como o cálculo é feito você pode acessar aqui.
Filtra pelo canal específico. Onde só é possível passar um canal por vez. Visto que é um path param, no momento devem ser escritos em minúsculas. Os valores possíveis são:
instagram, twitter, youtube, linkedin, tiktok
Sim
page_id
string
2332231
Filtra por determinada pagina proprietária conectada. Esse page_id tem que ser o id da pagina do channel informado. Ou seja, se o path for /instagram esse page_id precisa ser de uma página do Instagram.
Sim
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range e não é válido para o canal TikTok
Lista contendo objeto com valor da sua respectiva métrica.
Axe
Campo
Tipo
Descrição
label
string
Nome do campo, neste caso posted_at que significa que os valores são relativos a data da métrica
values
List<number>
Valores das datas filtradas, cada valor representa uma data no formato timestamp. Essa lista está ordenada de forma crescente, ou seja, a menor data vem primeiro.
Points
Campo
Tipo
Descrição
data
List<number>
Esse é o valor de determinada métrica. Ela está ordenada por data, ou seja, a primeira posição é referente a primeira data no array do objeto axes[0].values[0] e a segunda é referente a segunda data do array em axes[1].values[1] e assim por diante.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Taxa de interações
Este endpoint permite monitorar as taxas de interação de uma página proprietária, oferecendo insights sobre o engajamento do público com seu conteúdo. Essas taxas refletem a atividade dos consumidores por meio de curtidas, comentários e compartilhamentos. Para visualizar o gráfico, basta conectar a rede social desejada. Para mais detalhes, clique aqui.
Token de autenticação necessário para acessar os dados
Sim
page_id
string
abc123xyz
ID da página conectada. Os IDs podem ser encontrados em Get pages
Sim
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
sentimento
integer
-1
Filtrar por sentimento (-1: negativo, 0: neutro, 1: positivo)
Não
dark_post
boolean
false
Filtra publicações que são ou não dark posts
Não
pids
number
987654321
IDs das publicações para filtrar
Não
types
string
Image
Tipo do post. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são:
Text, Image, Video, Audio
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
devices
string
mobile
Tipo de dispositivo (computador ou mobile)
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
last_days
number
30
Substitui date_range, trazendo dados dos últimos N dias
Não
annotated
boolean
true
Filtra publicações que tiveram anotações realizadas
Não
order_by
string
date_desc
Ordem na qual as publicações aparecem. Os valores possíveis são:
{"from_cache":false,"results":[{"data":[{"date":"2025/02/20","value":0}],"name":"Interações"},{"data":[{"date":"2025/02/20","value":0}],"name":"Taxa de Interações"}],"video_views":{"avg_time_watched":{"value":39465},"avg_time_watched_perc":{"value":-34.12839},"total_videos":{"value":22},"total_videos_perc":{"value":175},"unique_video_views":{"value":7654579},"unique_video_views_perc":{"value":63788060},"views":{"value":7873453},"views_perc":{"value":60564920}}}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Alcance x Índice de engajamento
Esse endpoint retorna dados de duas métricas presentes nas redes sociais: alcance, que se refere ao número de pessoas que tiveram o conteúdo da página proprietária (ou sobre ela) exibido em suas telas; e índice de engajamento, que é uma porcentagem que indica o quanto sua página cresceu em relação às métricas de engajamento, observadas nas interações: curtidas, comentários e compartilhamentos. Para saber mais detalhes sobre as métricas de como o calculo é feito você pode acessar aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Lista com a respectiva data e o valor encontrado para aquela métrica
name
string
Nome da métrica
Data
Campo
Tipo
Descrição
date
Date(aaaa/MM/dd)
Data daquela métrica
value
number
Quantidade total para aquela métrica naquele respectivo dia
Corpo da resposta em json
{"from_cache":false,"results":[{"data":[{"date":"2025/02/18","value":0}],"name":"Alcance"},{"data":[{"date":"2025/02/18","value":0.0}],"name":"Índice de engajamento"}]}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Publicações ativadas
Esse endpoint retorna dados sobre qual é a relação entre impressões e cliques das suas páginas conectadas. Para saber mais detalhes sobre as métricas e como o cálculo é feito você pode acessar aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Visão geral - Métricas Proprietárias
Neste endpoint é retornado os dados para seção de Visão Geral dentro de métricas proprietárias. Com ele é possível ter acesso aos dados gerais de sua página conectada nos canais de Facebook, Linkedin, YouTube, Twitter, Instagram e TikTok. Para saber mais detalhes sobre as métricas, você pode acessar aqui.
id da pagina conectada (os ids podem ser encontrados em api.stilingue.com.br/pages/getpages/|TOKEN|)
sim
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou
AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato
Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos
30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse
parâmetro não seja informado, será considerado 1d.
não
last_days
number
10
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro
sobrescreve o filtro date_range
Variação do tempo médio de visualização em percentagem.
total_videos
number
Total de vídeos publicados.
total_videos_perc
number
Variação do total de vídeos publicados em percentagem.
unique_video_views
number
Visualizações únicas do vídeo.
unique_video_views_perc
number
Variação de visualizações únicas do vídeo em percentagem.
views
number
Total de visualizações.
views_perc
number
Variação do total de visualizações em percentagem.
Corpo da resposta em json
{"digital_score":{"name":"Pontuação digital","organic":{"details":3.010760031756402,"name":"Orgânico","type":"down","value":0.022336368588995254},"paid":{"details":0.32467295870822555,"name":"Pago","type":"up","value":0.014670402365942876}},"engagement":{"name":"Engajamento","rate":{"details":297.6311889064824,"name":"Índice de engajamento","type":"up","value":0.11556835432010014},"users":{"details":0.0,"name":"Usuários engajados","type":"stand","value":0.0}},"followers":{"name":"Seguidores","total":{"details":0.05695137628554144,"name":"Total de seguidores","type":"up","value":423409.0}},"from_cache":false,"impressions":{"name":"Impressões","total":{"details":38.65502496598176,"name":"Impressões","type":"down","value":103559711.0}},"interactions":{"comments":{"details":52.780692549842605,"name":"Comentários","type":"up","value":1456.0},"likes":{"details":132.42296813971237,"name":"Curtidas","type":"up","value":155312.0},"name":"Interações","reaction_angry":{"details":58.8235294117647,"name":"reaction_angry","type":"up","value":81.0},"reaction_haha":{"details":55.88235294117647,"name":"reaction_haha","type":"up","value":212.0},"reaction_like":{"details":132.42296813971237,"name":"reaction_like","type":"up","value":155312.0},"reaction_love":{"details":276.83982683982686,"name":"reaction_love","type":"up","value":1741.0},"reaction_others":{"details":0.0,"name":"reaction_others","type":"stand","value":0.0},"reaction_sad":{"details":242.85714285714286,"name":"reaction_sad","type":"up","value":24.0},"reaction_total":{"details":133.28197911265832,"name":"reaction_total","type":"up","value":157477.0},"reaction_wow":{"details":300.0,"name":"reaction_wow","type":"up","value":108.0},"reactions":{"details":133.28197911265832,"name":"Reações","type":"up","value":157477.0},"shares":{"details":86.88212927756653,"name":"Compartilhamentos","type":"up","value":983.0},"total":{"details":131.9261290275783,"name":"Interações","type":"up","value":159869.0}},"posts":{"dark_posts":{"details":29.609948504437384,"name":"Dark Posts","type":"down","value":25698.0},"name":"Número de Publicações","timeline":{"details":100.0,"name":"Timeline","type":"down","value":0.0},"total":{"details":29.62922394435621,"name":"Total","type":"down","value":25698.0}},"reach":{"average":{"details":42.55269480321101,"name":"Alcance Médio","type":"down","value":2463337.0},"name":"Alcance","total":{"details":40.69955573333625,"name":"Alcance","type":"down","value":78826789.0}},"video_views":{"avg_time_watched":{"value":308543},"avg_time_watched_perc":{"value":135.9054},"total_videos":{"value":668},"total_videos_perc":{"value":-6.04782},"unique_video_views":{"value":10287556},"unique_video_views_perc":{"value":53.74794},"views":{"value":12135431},"views_perc":{"value":69.54287}}}
Instagram
Abaixo encontra-se os campos específicos para Instagram.
Contém dados sobre a quantidade de toques de avanço nos stories.
Corpo da resposta em json
{"engagement":{"name":"Engajamento","rate":{"details":0.0,"name":"Índice de engajamento","type":"stand","value":0.0},"users":{"details":0.0,"name":"Usuários engajados","type":"stand","value":0.0}},"followers":{"name":"Seguidores","total":{"details":0.0,"name":"Total de seguidores","type":"stand","value":0.0}},"from_cache":false,"impressions":{"dark_posts":{"details":0.0,"name":"Dark Posts","type":"stand","value":0.0},"name":"Impressões","stories":{"details":0.0,"name":"Histórias","type":"stand","value":0.0},"timeline":{"details":0.0,"name":"Timeline","type":"stand","value":0.0},"total":{"details":0.0,"name":"Alcance","type":"stand","value":0.0}},"interactions":{"comments":{"details":0.0,"name":"Comentários","type":"stand","value":0.0},"likes":{"details":0.0,"name":"Curtidas","type":"stand","value":0.0},"name":"Interações","saves":{"details":0.0,"name":"Salvos","type":"stand","value":0.0},"shares":{"details":0.0,"name":"Compartilhamentos","type":"stand","value":0.0},"total":{"details":0.0,"name":"Interações","type":"stand","value":0.0},"views":{"details":0.0,"name":"Visualizações em Videos","type":"stand","value":0.0}},"posts":{"dark_posts":{"details":0.0,"name":"Dark Posts","type":"stand","value":0.0},"name":"Número de Publicações","stories":{"details":0.0,"name":"Histórias","type":"stand","value":0.0},"timeline":{"details":0.0,"name":"Timeline","type":"stand","value":0.0},"total":{"details":0.0,"name":"Total","type":"stand","value":0.0}},"reach":{"dark_posts":{"details":0.0,"name":"Dark Posts","type":"stand","value":0.0},"name":"Alcance","stories":{"details":0.0,"name":"Histórias","type":"stand","value":0.0},"timeline":{"details":0.0,"name":"Timeline","type":"stand","value":0.0},"total":{"details":0.0,"name":"Alcance","type":"stand","value":0.0}},"reels":{"comments":{"details":0.0,"name":"Comentários","type":"stand","value":0.0},"likes":{"details":0.0,"name":"Curtidas","type":"stand","value":0.0},"name":"Reels","saved":{"details":0.0,"name":"Salvos","type":"stand","value":0.0},"total":{"details":0.0,"name":"Interações","type":"stand","value":0.0}},"stories":{"exits":{"details":0.0,"name":"Saídas","type":"stand","value":0.0},"impressions":{"details":0.0,"name":"Impressões","type":"stand","value":0.0},"name":"Histórias","replies":{"details":0.0,"name":"Respostas","type":"stand","value":0.0},"taps_back":{"details":0.0,"name":"TAPAS PRA TRÁS","type":"stand","value":0.0},"taps_forward":{"details":0.0,"name":"TAPAS PRA FRENTE","type":"stand","value":0.0}}}
Linkedin, YouTube e Twitter
Abaixo encontra-se os campos específicos para Linkedin, YouTube e Twitter.
{"followers":{"name":"Seguidores","total":{"details":0.0,"name":"Total de seguidores","type":"stand","value":0.0}},"from_cache":false,"interactions":{"comments":{"details":0.0,"name":"Comentários","type":"stand","value":0.0},"likes":{"details":0.0,"name":"Curtidas","type":"stand","value":0.0},"name":"Interações","shares":{"details":0.0,"name":"Compartilhamentos","type":"stand","value":0.0},"total":{"details":0.0,"name":"Interações","type":"stand","value":0.0},"views":{"details":0.0,"name":"Visualizações em Videos","type":"stand","value":0.0}},"posts":{"name":"Número de Publicações","total":{"details":0.0,"name":"Total","type":"stand","value":0.0}}}
TikTok
Abaixo encontra-se os campos específicos para TikTok.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Visão Geral Sentimento
Esse endpoint traz os dados para o total de sentimentos dos comentários feitos pelos usuários das páginas proprietárias do Facebook que estão conectadas no Warroom. Para entender detalhadamente sobre esse recurso, acesse aqui
Page ids para serem comparados. Separar múltiplos valores usando dois pontos.
Sim
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Contém os dados para os de sentimentos dos comentários para cada fanpage diários.
name
String
Data referente aos dados
Data Geral
Campo
Tipo
Descrição
name
String
Nome do sentimento
value
Number
Quantidade comentários referente ao sentimento.
Corpo da resposta em json
{"from_cache":false,"results":[{"data":[{"data":[{"name":"Positivo","value":0.0},{"name":"Negativo","value":0.0},{"name":"Neutro","value":0.0},{"name":"Total de Comentários","value":0},{"name":"Não Classificado","value":0.0}],"name":"2025/01/23"},{"data":[{"name":"Positivo","value":0.0},{"name":"Negativo","value":0.0},{"name":"Neutro","value":100.0},{"name":"Total de Comentários","value":1},{"name":"Não Classificado","value":0.0}],"name":"2025/01/24"},{"data":[{"name":"Positivo","value":0.0},{"name":"Negativo","value":0.0},{"name":"Neutro","value":0.0},{"name":"Total de Comentários","value":0},{"name":"Não Classificado","value":0.0}],"name":"2025/01/25"},{"data":[{"name":"Positivo","value":0.0},{"name":"Negativo","value":0.0},{"name":"Neutro","value":0.0},{"name":"Total de Comentários","value":0},{"name":"Não Classificado","value":0.0}],"name":"2025/01/26"},{"data":[{"name":"Positivo","value":0.0},{"name":"Negativo","value":0.0},{"name":"Neutro","value":0.0},{"name":"Total de Comentários","value":0},{"name":"Não Classificado","value":0.0}],"name":"2025/01/27"},{"data":[{"name":"Positivo","value":0.0},{"name":"Negativo","value":0.0},{"name":"Neutro","value":0.0},{"name":"Total de Comentários","value":0},{"name":"Não Classificado","value":0.0}],"name":"2025/01/28"},{"data":[{"name":"Positivo","value":25.0},{"name":"Negativo","value":0.0},{"name":"Neutro","value":75.0},{"name":"Total de Comentários","value":4},{"name":"Não Classificado","value":0.0}],"name":"2025/01/29"},{"data":[{"name":"Positivo","value":0.0},{"name":"Negativo","value":0.0},{"name":"Neutro","value":0.0},{"name":"Total de Comentários","value":0},{"name":"Não Classificado","value":0.0}],"name":"2025/01/30"}],"name":"Ladrão de Chuchu"}],"total_results":[{"data":[{"name":"Positivo","value":20.0},{"name":"Negativo","value":0.0},{"name":"Neutro","value":80.0},{"name":"Total de Comentários","value":5},{"name":"Não Classificado","value":0.0}],"name":"Ladrão de Chuchu"}],"video_views":{"avg_time_watched":{"value":0},"avg_time_watched_perc":{"value":0.0},"total_videos":{"value":0},"total_videos_perc":{"value":0.0},"unique_video_views":{"value":0},"unique_video_views_perc":{"value":0.0},"views":{"value":0},"views_perc":{"value":0.0}}}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Visualizações no tempo
Esse endpoint traz informações sobre a quantidade de visualizações de diferentes tipos de posts feitos por uma página. Para saber mais detalhes sobre as métricas e como o cálculo é feito, você pode acessar aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Volume de Interações
Com o endpoint de volume de interações, é possível obter dados relacionados as interações das páginas conectadas nos canais LinkedIn, YouTube, Twitter, Instagram e TikTok, por exemplo volume de interações sobre comentários, curtidas entre outros. Para saber mais acesse a documentação do respectivo canal aqui.
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
last_days_from_now
number
30
Esse campo traz dados de N dias antes de hoje
Atenção: esse filtro sobrescreve o filtro date_range
Lista com a respectiva data e o valor encontrado para métricas relacionadas ao tipo de interação.
Atenção: Para cada canal haverá tipos de interação diferente. Abaixo você encontra exemplos
Data
Campo
Tipo
Descrição
date
Date(aaaa/MM/dd)
Data da respectiva métrica
value
number
Quantidade total da respectiva métrica naquele no referente dia
Linkedin
Para o canal Linkedin você terá acesso ao volume de interações referente à curtidas, comentários, visualizações de vídeos e compartilhamentos das publicações. Para saber mais sobre essa métrica você pode acessar a documentação aqui
Abaixo um exemplo em json da resposta.
Corpo da resposta em json
{"from_cache":false,"results":[{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Curtidas"},{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Comentários"},{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Visualizações de Vídeos"},{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Compartilhamentos"}]}
YouTube
Para o canal YouTube você terá acesso ao volume de interações referente à curtidas, comentários e visualizações de vídeos das publicações. Para saber mais sobre essa métrica você pode acessar a documentação aqui. Abaixo um exemplo em json da resposta.
Corpo da resposta em json
{"from_cache":false,"results":[{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Curtidas"},{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Comentários"},{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Visualizações de Vídeos"}]}
Twitter
Para o canal Twitter você terá acesso ao volume de interações referente à curtidas e compartilhamentos das publicações. Para saber mais sobre essa métrica você pode acessar a documentação aqui. Abaixo um exemplo em json da resposta.
Para o canal Instagram você terá acesso ao volume de interações referente à curtidas, comentários e visualizações de vídeos das publicações. Para saber mais sobre essa métrica você pode acessar a documentação aqui
Abaixo um exemplo em json da resposta.
Corpo da resposta em json
{"from_cache":false,"results":[{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Curtidas"},{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Comentários"},{"data":[{"date":"2025/02/06","value":0},{"date":"2025/02/07","value":0},{"date":"2025/02/08","value":0}],"name":"Visualizações de Vídeos"}]}
TikTok
Para o canal TikTok as coisas mudam um pouco, você terá acesso ao volume de interações referente à curtidas, comentários e visualizações de vídeos das publicações e compartilhamentos. Para saber mais sobre essa métrica você pode acessar a documentação aqui
O page id do TikTok necessário para essa requisição pode ser pego usando esta documentação: Pegar id paginas conectadas
Esse endpoint é funcional apenas para TikTok
Request
curl -H'Content-Type: application/json'\-X GET \'https://api.stilingue.com.br/metricaspro/tiktok/public/{api-token}/{page-id-tiktok}'\-ddate_range=202402040000:202501282359
Parâmetros da requisição
Campo
Tipo
O que retorna
Descrição
Obrigatório
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias apenas. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm. Caso esse parâmetro não seja informado, será considerado 1d.
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Smartcare
Smartcare é a ferramenta que as marcas utilizam para conseguir responder e dar atendimento aos usuários nas redes sociais. Para mais detalhes consulte nossa documentação aqui
Relatório
Esse endpoint traz dados relativos ao Smartcare, como: casos, conversas, interações e histórico de troca de status. Dados relativos ao histórico de atendimento. Para saber mais detalhes sobre as métricas e como o cálculo é feito você pode acessar aqui.
Esse endpoint traz informações do menu onde há como exportar o relatório do Smartcare. Na tela do Smartcare, clique no menu 🟰 e em seguida em relatório
O endpoint processa muitos dados, então é esperado uma demora se o range de data do relatório for muito grande. Recomendamos como boa prática fazerem a importação dos dados por dia e diariamente. Caso seja necessário prazos maiores, quebrar em dias as requisições para obter melhores resultados.
Caso alguma propriedade não tenha valor, ela não será exibida ao invés de aparecer com valor nulo. Modificando a estrutura da reposta não aparecendo no retorno.
Possuirá todas as mudanças de status feitas dentro da plataforma nas conversas exportadas/td>
Case
Campo
Tipo
Descrição
initAt
number
Data de início de um caso. Pode ser a data da primeira interação ou quando não houver uma interação no momento da exportação (reabertura de conversa), seria a primeira mudança de status daquele caso.
endAt
number
Data de fechamento de um caso. Essa data se refere à mudança de status para Fechado ou Ignorado daquele caso que compreende o fechamento dele
caseId
string
ID do respectivo case no Smartcare, ele é composto pelo ID da conversa _numero do caso dentro da exportação
Objeto contendo informações da página proprietária conectada ao Warroom
timeToFirstAnswer
number
Tempo até a primeira resposta em segundos. Tempo que levou para ser realizada a primeira mudança de status para respondido. As regras considera o calendário configurado no Warroom. Caso a conversa tenha sido fechada sem que haja mudança de status para respondido, será considerado o SLA de fechamento.
timeToClose
number
Tempo até o fechamento em segundos. Somatório dos tempos de todas as mudanças de status da conversa, ou seja, quanto tempo passou desde que o caso foi aberto até o momento de seu fechamento. Esse tempo considera as regras de calendários cadastrados no Warroom
status
string
Status do caso no momento da exportação
firstAnswerConfiguredSlaTimeSeconds
number
SLA Configurado na primeira resposta em segundos. Esse tempo se equivale à mesma configuração da primeira mudança de status para respondido ou fechado
firstAnswerIsInsideSlaTime
boolean
Primeira resposta dentro do SLA. Identificador se o tempo da primeira resposta está dentro do SLA configurado para primeira resposta
interactionType
string
Tipo de interação. Os valores possíveis são: Comentário, Menção, Comentário em menção, Publicação de visitante, Comentário em publicação de visitante, Avaliação, Comentário em avaliação.
Conversations
Campo
Tipo
Descrição
initAt
number
Data e hora da primeira interação dessa conversa no período filtrado
endAt
number
Data e hora da última mudança de status dentro do período filtrado, caso essa mudança seja para o status Fechado ou Ignorado. Caso não tenha nenhuma mudança de status para essa conversa no intervalo ou a última mudança esteja indo para um status diferente de Fechado ou Ignorado, este campo ficará vazio
Objeto contendo informações da página proprietária conectada ao Warroom
timeToFirstAnswer
number
SLA em segundos da primeira mudança de status para Respondido ou Fechado dentro do período filtrado.
Importante: Uma mudança de status de primeira resposta pode ocorrer a partir dos status Pendente, Aberto ou Em espera.
timeToClose
number
Soma dos SLAs de todas as mudanças de status da conversa caso pelo menos uma delas seja mudança para Fechado ou Ignorado
status
string
Indica o status atual da conversa
firstAnswerConfiguredSlaTimeSeconds
number
Apresenta o tempo de SLA onde essa mudança de status poderá ser comparada. Para mais informações e limitações desse campo, consulte a descrição no campo Tempo de SLA configurado, em Mudanças de Status
firstAnswerIsInsideSlaTime
boolean
Valor booleano que identifica se o tempo da primeira resposta está dentro do SLA configurado para a primeira resposta
interactionType
string
Tipo de interação. Os valores possíveis são: Comentário, Menção, Comentário em menção, Publicação de visitante, Comentário em publicação de visitante, Avaliação, Comentário em avaliação, Inbox
interactionsSize
number
Apresenta o volume total de interações (proprietárias e não proprietárias) com o ID da conversa, independente do prazo em que a interação foi feita
Interactions
Campo
Tipo
Descrição
postedAt
number
Data em que a interação foi feita
processedAt
number
Data e hora em que a interação foi processada e coletada e entrou no painel do Warroom
pid
string
Identificador único da interação
channel
string
Canal da interação
postUrl
string
URL da interação. Em alguns casos essa URL pode direcionar para a publicação e não ao comentário de uma publicação
conversationId
string
ID da conversa que essa interação faz parte. Uma interação pode estar presente em mais de uma conversa. Ex: Twitter toda interação pode dar início a uma nova conversa e ser parte de outra.
Lista com nome das tags classificadas na interação
themes
List<string>
Lista com nome dos temas classificados na interação
interactionType
string
Tipo de interação. Os valores possíveis são: Comentário, Menção, Comentário em menção, Publicação de visitante, Comentário em publicação de visitante, Avaliação, Comentário em avaliação.
fromPromoted
boolean
Indica se a interação faz parte de uma publicação impulsionada
conversationIds
List<string>
Lista com todos os IDs de conversas que a interação faz parte
StatusesChanges
Campo
Tipo
Descrição
createdAt
number
Data e hora em que a mudança de status foi feita
caseInitAt
number
Data e hora em que o caso dessa mudança de status foi iniciado. Se uma mudança de status aconteceu em um caso que não possui nenhuma interação no período filtrado, esse campo estará vazio
caseId
string
ID do caso em que essa mudança de status faz parte. Se uma mudança de status aconteceu em um caso que não possui nenhuma interação no período filtrado, esse campo estará vazio
channel
string
Canal da conversa em que foi feito a mudança de status
Objeto contendo informações da página proprietária conectada ao Warroom
oldValue
string
Valor do status anterior à mudança de status
newValue
string
Valor atribuído à conversa com essa mudança de status
timeToStatusChange
number
Tempo até a mudança de status em segundos. Tempo que levou para ser realizada a mudança de status. O cálculo desse campo segue as regras dos calendários configurados no Warroom e seguem as mesmas regras de mudança de status.
configuredSlaTimeSeconds
number
Tempo de SLA configurado em segundos, essa mudança de status poderá ser comparada. Caso a interação tenha sido roteada utilizando o sistema de roteamento, o SLA configurado no roteamento será retornado nesse campo. Caso não seja uma interação roteada pegará o tempo de SLA da configuração geral da pesquisa.
insideSlaTime
boolean
Dentro do SLA configurado, que compara o campo slaTimeSeconds com o campo configuredSlaTimeSeconds para falar se a mudança de status está dentro do tempo de SLA configurado.
interactionType
string
Tipo de interação. Os valores possíveis são: Comentário, Menção, Comentário em menção, Publicação de visitante, Comentário em publicação de visitante, Avaliação, Comentário em avaliação.
Page
Campo
Tipo
Descrição
page.id
string
ID da página proprietária cadastrada no Warroom
page.name
string
Nome da página proprietária cadastrada no Warroom
User
Campo
Tipo
Descrição
user.id
string
ID do autor usuário da rede social que criou a interação
user.name
string
Nome do autor, username do usuário da rede social que criou a interação
user.gender
string
Gênero do autor da rede social que criou a interação
Operator
Campo
Tipo
Descrição
operator.id
string
ID do operador do Smartcare realizou a ação
operator.name
string
Nome do operador do Smartcare realizou a ação. Caso um operador mude de nome estaremos retornando o valor antigo nas publicações antigas
Corpo da resposta em json
{"cases":[{"caseId":"aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4NDE0NTg0NjQ4MjcyOTU6MzQwMjgyMzY2ODQxNzEwMzAxMjQ0Mjc2MDMxNTUxMDkxMDM1ODA0_1","channel":"Instagram","conversationId":"aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4NDE0NTg0NjQ4MjcyOTU6MzQwMjgyMzY2ODQxNzEwMzAxMjQ0Mjc2MDMxNTUxMDkxMDM1ODA0","endAt":1741232745173,"firstAnswerConfiguredSlaTimeSeconds":600,"firstAnswerIsInsideSlaTime":true,"initAt":1741016620000,"interactionType":"Inbox","page":{"id":"58458364827","name":"Coruja Testadora"},"status":"Fechado","timeToClose":65960,"timeToFirstAnswer":77},{"caseId":"1896628799510610107_1","channel":"Twitter","conversationId":"1896628799510610107","endAt":1742384304193,"initAt":1741026518000,"interactionType":"Menção","page":{"id":"803233102378188801","name":"Ladrão de Chuchu"},"status":"Ignorado","timeToClose":0},{"caseId":"1896631373139759286_1","channel":"Twitter","conversationId":"1896631373139759286","endAt":1742384303175,"initAt":1741027131000,"interactionType":"Menção","page":{"id":"803233102378188801","name":"Ladrão de Chuchu"},"status":"Ignorado","timeToClose":0},{"caseId":"1896633477933805749_1","channel":"Twitter","conversationId":"1896633477933805749","endAt":1742384303176,"initAt":1741027633000,"interactionType":"Menção","page":{"id":"803233102378188801","name":"Ladrão de Chuchu"},"status":"Ignorado","timeToClose":0}],"conversations":[{"channel":"Instagram","conversationId":"aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4NDE0NTg0NjQ4MjcyOTU6MzQwMjgyMzY2ODQxNzEwMzAxMjQ0Mjc2MDMxNTUxMDkxMDM1ODA0","endAt":1741232745173,"firstAnswerConfiguredSlaTimeSeconds":600,"firstAnswerIsInsideSlaTime":true,"initAt":1741016620000,"interactionType":"Inbox","interactionsSize":2,"page":{"id":"58458364827","name":"Coruja Testadora"},"status":"Fechado","timeToClose":65960,"timeToFirstAnswer":77},{"channel":"Twitter","conversationId":"1896628799510610107","endAt":1742384304193,"initAt":1741026518000,"interactionType":"Menção","interactionsSize":1,"page":{"id":"803233102378188801","name":"Ladrão de Chuchu"},"status":"Ignorado","timeToClose":0},{"channel":"Twitter","conversationId":"1896631373139759286","endAt":1742384303175,"initAt":1741027131000,"interactionType":"Menção","interactionsSize":1,"page":{"id":"803233102378188801","name":"Ladrão de Chuchu"},"status":"Ignorado","timeToClose":0},{"channel":"Twitter","conversationId":"1896633477933805749","endAt":1742384303176,"initAt":1741027633000,"interactionType":"Menção","interactionsSize":1,"page":{"id":"803233102378188801","name":"Ladrão de Chuchu"},"status":"Ignorado","timeToClose":0}],"interactions":[{"belongsToSacCall":true,"caseId":"aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4NDE0NTg0NjQ4MjcyOTU6MzQwMjgyMzY2ODQxNzEwMzAxMjQ0Mjc2MDMxNTUxMDkxMDM1ODA0_1","channel":"Instagram","conversationId":"aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4NDE0NTg0NjQ4MjcyOTU6MzQwMjgyMzY2ODQxNzEwMzAxMjQ0Mjc2MDMxNTUxMDkxMDM1ODA0","conversationStatus":"Fechado","delay":6.287037037037037e-05,"duplicated":false,"fromPromoted":false,"groups":[],"hashtags":[],"hiddenByUser":false,"interactionType":"Inbox","isHidden":false,"normalizedUpdatedAt":"202503211710","operatorName":"","originalChannel":"Instagram","outsideDateRange":false,"page":{"id":"58458364827","name":"Coruja Testadora"},"pid":"aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDU4NDY0ODI3Mjk1OjM0MDI4MjM2Njg0MTcxMDMwMTI0NDI3NjAzMTU1MTA5MTAzNTgwNDozMjExNjA4ODAyNzI2MTQ4NDY0MTA2ODI5MTAxNjYyMjA4MAZDZD","polarity":"Neutro","postUrl":"","postedAt":1741016620000,"processedAt":1741016625432,"proprietary":false,"reaction":{},"root":false,"rootId":"aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDU4NDY0ODI3Mjk1OjM0MDI4MjM2Njg0MTcxMDMwMTI0NDI3NjAzMTU1MTA5MTAzNTgwNDozMTI4MTQwMjU2MjkyMzI1NTU2NTc3ODk4MjE4NDk0MzYxNgZDZD","text":"Oi corujinha","themes":["AAteeeeemasssss"],"updatedAt":1742577041689,"user":{"crmUserId":"","id":"6551450764874436","name":"_imbrunaf","username":"_imbrunaf"},"verified":false},{"belongsToSacCall":true,"caseId":"aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4NDE0NTg0NjQ4MjcyOTU6MzQwMjgyMzY2ODQxNzEwMzAxMjQ0Mjc2MDMxNTUxMDkxMDM1ODA0_1","channel":"Instagram","conversationId":"aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4NDE0NTg0NjQ4MjcyOTU6MzQwMjgyMzY2ODQxNzEwMzAxMjQ0Mjc2MDMxNTUxMDkxMDM1ODA0","conversationStatus":"Fechado","delay":2.496527777777778e-05,"duplicated":false,"fromPromoted":false,"groups":[],"hashtags":[],"hiddenByUser":false,"interactionType":"Inbox","isHidden":false,"normalizedUpdatedAt":"202503211710","operatorName":"Bruna Freitas","originalChannel":"Instagram","outsideDateRange":false,"page":{"id":"58458364827","name":"Coruja Testadora"},"pid":"aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDU4NDY0ODI3Mjk1OjM0MDI4MjM2Njg0MTcxMDMwMTI0NDI3NjAzMTU1MTA5MTAzNTgwNDozMjExNjA4OTQzODU5NDI1ODk0NDcwNzc0MTk1ODAxMjkyOAZDZD","polarity":"Neutro","postUrl":"","postedAt":1741016697000,"processedAt":1741016699157,"proprietary":true,"reaction":{},"root":false,"rootId":"aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDU4NDY0ODI3Mjk1OjM0MDI4MjM2Njg0MTcxMDMwMTI0NDI3NjAzMTU1MTA5MTAzNTgwNDozMTI4MTQwMjU2MjkyMzI1NTU2NTc3ODk4MjE4NDk0MzYxNgZDZD","tags":["ticket inserido"],"text":"Oi bru, tudo bem?\ntestando aqui","updatedAt":1742577041689,"user":{"crmUserId":"","followers":7,"id":"58458364827","name":"coruja_testadora","username":"coruja_testadora"},"verified":false},{"belongsToSacCall":true,"caseId":"1896628799510610107_1","channel":"Twitter","conversationId":"1896628799510610107","conversationStatus":"Ignorado","delay":0.0011347569444444445,"duplicated":false,"fromPromoted":false,"groups":[],"hashtags":[],"hiddenByUser":false,"interactionType":"Menção","isHidden":false,"normalizedMetricsUpdatedAt":"202504021341","normalizedUpdatedAt":"202503191138","operatorName":"","originalChannel":"Twitter","outsideDateRange":false,"page":{"id":"803233102378188801","name":"Ladrão de Chuchu"},"pid":"1896628799510610107","polarity":"Positivo","postUrl":"https://twitter.com/corazoncito64/status/1896628799510610107","postedAt":1741026518000,"processedAt":1741026616043,"proprietary":false,"reaction":{},"root":true,"rootId":"1896628799510610107","text":"🇺🇸 Mark Cuban Presale Is Live!\n\n1️⃣ More information: hhttps://x.com/mcuban/status/1896611878014705938/likes \n2️⃣ Check your eligibility on page listed.\n\n☑️ Eligible users: @apam2 @JMcanerin @lizardo_estiven @pocketfundation @Veraruiz17 @LadraoDeChuchu @mohamaddaka1\n\n🏆 GDLWJ","updatedAt":1742384304239,"user":{"crmUserId":"","gender":"Mulher","id":"1446574831","name":"jimena arellano ","username":"corazoncito64"},"verified":false},{"belongsToSacCall":true,"caseId":"1896631373139759286_1","channel":"Twitter","conversationId":"1896631373139759286","conversationStatus":"Ignorado","delay":0.008095891203703704,"duplicated":false,"fromPromoted":false,"groups":[],"hashtags":[],"hiddenByUser":false,"interactionType":"Menção","isHidden":false,"normalizedMetricsUpdatedAt":"202504021341","normalizedUpdatedAt":"202503191138","operatorName":"","originalChannel":"Twitter","outsideDateRange":false,"page":{"id":"803233102378188801","name":"Ladrão de Chuchu"},"pid":"1896631373139759286","polarity":"Positivo","postUrl":"https://twitter.com/adam_dachis/status/1896631373139759286","postedAt":1741027131000,"processedAt":1741027830485,"proprietary":false,"reaction":{},"root":true,"rootId":"1896631373139759286","text":"🇺🇸 Mark Cuban Presale Is Live!\n\n1️⃣ More information: https://t.co/AV7SGwHgCI \n2️⃣ Check your eligibility on page listed.\n\n☑️ Eligible users: @apam2 @JMcanerin @lizardo_estiven @pocketfundation @Veraruiz17 @LadraoDeChuchu @mohamaddaka1\n\n🏆 XAtMF","updatedAt":1742384303705,"user":{"crmUserId":"","followers":1,"gender":"Homem","id":"1730424163","name":"adam.dachis","username":"adam_dachis"},"verified":false},{"belongsToSacCall":true,"caseId":"1896633477933805749_1","channel":"Twitter","conversationId":"1896633477933805749","conversationStatus":"Ignorado","delay":0.0022860185185185184,"duplicated":false,"fromPromoted":false,"groups":[],"hashtags":[],"hiddenByUser":false,"interactionType":"Menção","isHidden":false,"normalizedMetricsUpdatedAt":"202504021341","normalizedUpdatedAt":"202503191138","operatorName":"","originalChannel":"Twitter","outsideDateRange":false,"page":{"id":"803233102378188801","name":"Ladrão de Chuchu"},"pid":"1896633477933805749","polarity":"Positivo","postUrl":"https://twitter.com/miekevanes/status/1896633477933805749","postedAt":1741027633000,"processedAt":1741027830512,"proprietary":false,"reaction":{},"root":true,"rootId":"1896633477933805749","text":"🇺🇸 Mark Cuban Presale Is Live!\n\n1️⃣ More information: https://t.co/InBAaU66tR \n2️⃣ Check your eligibility on page listed.\n\n☑️ Eligible users: @JMcanerin @lizardo_estiven @pocketfundation @Veraruiz17 @LadraoDeChuchu @mohamaddaka1 @fuaadAbdalla\n\n🏆 j1ylB","updatedAt":1742384303704,"user":{"crmUserId":"","followers":1,"id":"488835788","name":"mieke","username":"miekevanes"},"verified":false}],"statusesChanges":[{"calendarId":"5114369981546496","channel":"Facebook","commentId":"573824358993095_992892222174299","configuredSlaTimeSeconds":600,"conversationId":"573824358993095_992892222174299","createdAt":1740987318766,"endingStatus":true,"firstAnswer":false,"id":"67c55bb627c91369f100d4e7","insideSlaTime":false,"interactionType":"Comentário","newValue":"Fechado","oldValue":"Respondido","operator":{"id":"3","name":"Stilingue Fechamento Automatico"},"page":{"id":"112020565173096","name":"Coruja Testadora"},"relativePostedAt":1740771280129,"relativeProcessedAt":1740771280129,"timeToStatusChange":1580},{"calendarId":"5114369981546496","channel":"Facebook","commentId":"573824358993095_2967508190077696","configuredSlaTimeSeconds":600,"conversationId":"573824358993095_2967508190077696","createdAt":1740987679176,"endingStatus":true,"firstAnswer":false,"id":"67c55d1f27c91369f100d4ff","insideSlaTime":false,"interactionType":"Comentário","newValue":"Fechado","oldValue":"Respondido","operator":{"id":"3","name":"Stilingue Fechamento Automatico"},"page":{"id":"112020565173096","name":"Coruja Testadora"},"relativePostedAt":1740771676492,"relativeProcessedAt":1740771676492,"timeToStatusChange":1184},{"calendarId":"5114369981546496","caseId":"aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4NDE0NTg0NjQ4MjcyOTU6MzQwMjgyMzY2ODQxNzEwMzAxMjQ0Mjc2MDMxNTUxMDkxMDM1ODA0_1","caseInitAt":1741016620000,"channel":"Instagram","commentId":"aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDU4NDY0ODI3Mjk1OjM0MDI4MjM2Njg0MTcxMDMwMTI0NDI3NjAzMTU1MTA5MTAzNTgwNDozMTI4MTQwMjU2MjkyMzI1NTU2NTc3ODk4MjE4NDk0MzYxNgZDZD","configuredSlaTimeSeconds":600,"conversationId":"aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4NDE0NTg0NjQ4MjcyOTU6MzQwMjgyMzY2ODQxNzEwMzAxMjQ0Mjc2MDMxNTUxMDkxMDM1ODA0","createdAt":1741016697261,"endingStatus":false,"firstAnswer":true,"id":"67c5ce79befb293f629a9ecb","insideSlaTime":true,"interactionType":"Inbox","newValue":"Respondido","oldValue":"Pendente","operator":{"id":"6682381132759040","name":"Bruna Freitas"},"page":{"id":"58458364827","name":"Coruja Testadora"},"relativePostedAt":1741016620000,"relativeProcessedAt":1741016625432,"timeToStatusChange":77}]}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
ID da página conectada. Os IDs podem ser encontrados em Get pages
Não
sac_type
string
inbox
Tipo de interação da publicação (para filtros de conversa), podem ser posts, comentarios, inbox, postvisitantes, comentariosvisitantes, reviews, comentariosreview, mentions e comentariosmentions
Não
status
string
Ignorado
Status da conversa da publicação (para filtros de conversa), podem ser Ignorado, Pendente, Aberto, Em Espera, Respondido, Fechado.
Não
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
limit
number
100
Total de publicações retornadas (máximo 1000)
Não
offset
number
50
Paginação, número de publicações para pular
Não
pids
number
987654321
IDs das publicações para serem filtradas
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
sentiment
integer
-1
Filtrar por sentimento (-1: negativo, 0: neutro, 1: positivo)
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
annotated
boolean
false
Filtra publicações que tiveram anotações realizadas
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
Contagem de Conversas e Interações do Filtro
Os dados retornados desse endpoint são métricas relacionadas a contagem de conversas e interações dado determinado filtro, junto com os dados das interações. Para acessar a interface no Warrom que veem esses dados, abaixo imagem onde você consegue ver. Após acessar o Smartcare através do painel principal do Warrom. Na página inicial do Smartcare, basta clicar nesse botão para ver as métricas daquele filtro aplicado.
Token de autenticação necessário para acessar os dados
Sim
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm.
Sim
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no icone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
ID da página conectada. Os IDs podem ser encontrados em Get pages
Sim
filters
string
5db1f0b6e8e474001551580d
Aceita um filtro codificado para facilitar a configuração de muitos parâmetros. Os filtros codificados não precisam ser enviados novamente como parâmetros na requisição.
Para gerar um filtro, acesse o Warroom > Clique no ícone de filtro e selecione a aba (Filtro de publicações ou Filtro de conversas) > configure os parâmetros > copie, da URL do navegador, o valor do parâmetro filters, que será atualizado com código do filtro. Exemplo:
Tipo de interação da publicação (para filtros de conversa), podem ser posts, comentarios, inbox, postvisitantes, comentariosvisitantes, reviews, comentariosreview, mentions e comentariosmentions
Não
status
string
Ignorado
Status da conversa da publicação (para filtros de conversa), podem ser Ignorado, Pendente, Aberto, Em Espera, Respondido, Fechado.
Não
date_range
string
7d ou 202401010000:202401072359
Intervalo de datas que precisa ser retornado os dados no formato Nd ou AAAAMMDDHHmm:AAAAMMDDHHmm, d nesse exemplo representa dias. Utilizando formato Nd, é limitado a no máximo 30d ou seja, caso informado 50d, os posts serão apenas dos últimos 30 dias. Para prazos maiores, utilize o formato AAAAMMDDHHmm:AAAAMMDDHHmm, limitados a 3 meses. Caso esse parâmetro não seja informado, será considerado 1d.
Não
limit
number
100
Total de publicações retornadas (máximo 1000)
Não
offset
number
50
Paginação, número de publicações para pular
Não
pids
number
987654321
IDs das publicações para serem filtradas
Não
uids
number
987654321
IDs de usuários para serem filtrados
Não
themes
string
TemaX
Temas da pesquisa para serem filtrados. Separar múltiplos valores usando dois pontos. Temas podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
tags
string
Tag1
Tags da pesquisa para serem filtradas. Separar múltiplas valores usando dois pontos. Tags podem ser encontradas ao acessar a área de editar pesquisa no Warroom
Não
genders
string
homem
Filtrar publicações pelo gênero do autor. Separar múltiplos valores usando dois pontos.
Os valores possíveis são:
Homem, Mulher, Marca
Não
sentiment
integer
-1
Filtrar por sentimento (-1: negativo, 0: neutro, 1: positivo)
Não
langs
string
pt
Filtrar pelo idioma. Os valores possíveis são:
pt, en, es
Não
annotated
boolean
false
Filtra publicações que tiveram anotações realizadas
{"code":200,"data":{"execution_time_millis":89,"next_id_offset":13,"next_offset":20,"posts":[{"AAA_score":0.01,"_id":"m_SFZiD9AmmbpgnLtG5K9o8zXAQmKeHmzoJASeqtuS3PNM_sab7nSg8LwQpDFCpqujS9YRglI638aLfX95Jzztwg_FacebookInbox","authors":[],"channel":"Inbox do Facebook","comments":0,"contact_reasons":[],"crawled_at":1735830635828,"critical_level":0,"customer_info":{"attachments":"[{\"attachment_type\":\"profile\",\"media_type\":\"USER\",\"type\":\"image/jpeg\",\"name\":\"post_user_image_url\",\"id\":\"8496661233771790\",\"storage_id\":\"facebook/profile/8496661233771790/8496661233771790\"}]","gender":"Homem","name":"Vicente Costa","post_user_image_url":"https://storage.googleapis.com/usersstilingue/facebook/profile/8496661233771790/8496661233771790?GoogleAccessId=storage-manager@cloudstorage-220220.iam.gserviceaccount.com&Expires=1742841883&Signature=LSgrY8CVWelz19qvOxYMlJ6xxu1ZOPD0OQpCCjwW7Hqqvvegy%2F6Y2mSPZF0WRC%2FQz4N3TBhmDDv7A4rtC0uogpCTSYH3XCCh2HWI3qZrpwitI9xULSIRVPopaywR6rLoAuqjz29C70ewBAlskjZt7TJd4JMQbvgUxDW9OMjMWawbfaE4LxBhts6%2B5onNrAf9w3FlnL%2FJla5l%2FmH%2FitS6bKIZPKZv%2FbrENZ%2BW0he%2Ba2%2BQRBX6kJG2rrKMq9jU5WigllusxxQMKWIX6xQRUhxqKXo8fIh4i3kR0UcGzfBBgftC63kSncSK4giID2PizA2i43L%2BCSLJDx7GT0mNtM2Sng%3D%3D","profile_picture":"https://storage.googleapis.com/usersstilingue/facebook/profile/8496661233771790/8496661233771790?GoogleAccessId=storage-manager@cloudstorage-220220.iam.gserviceaccount.com&Expires=1742841883&Signature=LSgrY8CVWelz19qvOxYMlJ6xxu1ZOPD0OQpCCjwW7Hqqvvegy%2F6Y2mSPZF0WRC%2FQz4N3TBhmDDv7A4rtC0uogpCTSYH3XCCh2HWI3qZrpwitI9xULSIRVPopaywR6rLoAuqjz29C70ewBAlskjZt7TJd4JMQbvgUxDW9OMjMWawbfaE4LxBhts6%2B5onNrAf9w3FlnL%2FJla5l%2FmH%2FitS6bKIZPKZv%2FbrENZ%2BW0he%2Ba2%2BQRBX6kJG2rrKMq9jU5WigllusxxQMKWIX6xQRUhxqKXo8fIh4i3kR0UcGzfBBgftC63kSncSK4giID2PizA2i43L%2BCSLJDx7GT0mNtM2Sng%3D%3D","uid":"8496661233771790","user_image_url":"https://platform-lookaside.fbsbx.com/platform/profilepic/?eai=AXFZCM8z_V4JsC-qXrBSQWgKgZLyqjF0gnQi6uAfgpSph5NojbyxwKVFjdA9V_BYvLLCpWAZXRMa&psid=8496661233771790&height=50&width=50&ext=1738422125&hash=AbaXxYlP4eU5DWCPB4VV6o3X","user_url":"","username":""},"dislikes":0,"emotion":"","favorability":[],"favorite":false,"fb_critical_level":0,"features":[],"followers":4,"footage":0,"from_integration":false,"gender":"","group_polarity":[],"groups":[],"hashtags":[],"hidden_by_user":false,"hot":2476.71313,"hot_post":false,"impact":0,"interacted_page_id":"108629115449345","interactions":0,"interests":[],"is_dynamic_post":false,"is_root":false,"lang":"pt","likes":0,"location":"","long_posted_at":1735830629000,"long_updated_at":1736046638268,"max_shared_followers":0,"max_shared_show_dossier":false,"mentions":[],"metrics_updated_at":"02/01/2025 12:10","name":"Folks Sti Página","nlp_text_hash":"8f41133062db2849741760e0fd72fdf06d7d51001d7a563763b4c6c8b956624a","operator_id":"6266196513783808","operator_name":"Wellington Evangelista","order_by":"date_desc","page_comment":true,"page_id":"108629115449345","pages":["108629115449345"],"pid":"m_SFZiD9AmmbpgnLtG5K9o8zXAQmKeHmzoJASeqtuS3PNM_sab7nSg8LwQpDFCpqujS9YRglI638aLfX95Jzztwg","post_url":"https://pt-br.facebook.com//108629115449345/inbox/588924014086517/?section=messages","post_user_image_url":"https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/323774423_3471397176470615_6134550035869976545_n.jpg?stp=c31.0.1290.1290a_cp0_dst-jpg_s50x50_tt6&_nc_cat=104&ccb=1-7&_nc_sid=fe756c&_nc_ohc=5HfsEvn5aMIQ7kNvgHX8kWh&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&edm=AJdBtusEAAAA&_nc_gid=AC4JFsSHRByPzpWhPBItRf9&oh=00_AYCZS1jcrUQY8HAMX-f78K4wwreNYIejmCLT0i2aoPZE2g&oe=677C615A","posted_at":"02/01/2025 12:10","primary_channel":"Facebook","reactions":0,"receiver":{"email":"[email protected]","id":"8496661233771790","image_url":"https://platform-lookaside.fbsbx.com/platform/profilepic/?eai=AXEcNgUJcwNgNGVwm5nyJ5FSNfq-LYDB0mrNCx0Pmzd2piJdPFH5Khip41MDEOiN7D__EiZLZe8f&psid=8496661233771790&height=50&width=50&ext=1738422631&hash=AbZpC-wvLuFrCYVxc-rMONw8","name":"Vicente Costa"},"replied":false,"replier":"6266196513783808","replier_name":"Wellington Evangelista","reply_pid":"m_SFZiD9AmmbpgnLtG5K9o8zXAQmKeHmzoJASeqtuS3PNM_sab7nSg8LwQpDFCpqujS9YRglI638aLfX95Jzztwg","root_id":"m_xzp9EmqSRNdqAR_BmGBCezXAQmKeHmzoJASeqtuS3PNE_ZQs5YbuD0qakIFSwmfDpDaw0R2GEekmG8pfP7usFg","sac_call_id":"t_2884298781743977","sac_type":"Inbox","sentiment":3,"shall_use_receiver":true,"shares":0,"spam":false,"spokesman":[],"status":"Fechado","tags":[],"talk_id":"t_2884298781743977","text":"respondendo após o <u>bot</u>","theme_polarity":[],"themes":[],"thread_finished":false,"title":"","to":["Vicente Costa"],"type":"post","uid":"108629115449345","update_time_ago":"2 meses atrás","user_image_url":"https://scontent-atl3-2.xx.fbcdn.net/v/t39.30808-1/323774423_3471397176470615_6134550035869976545_n.jpg?stp=c31.0.1290.1290a_cp0_dst-jpg_s50x50_tt6&_nc_cat=104&ccb=1-7&_nc_sid=fe756c&_nc_ohc=5HfsEvn5aMIQ7kNvgHX8kWh&_nc_zt=24&_nc_ht=scontent-atl3-2.xx&edm=AJdBtusEAAAA&_nc_gid=AC4JFsSHRByPzpWhPBItRf9&oh=00_AYCZS1jcrUQY8HAMX-f78K4wwreNYIejmCLT0i2aoPZE2g&oe=677C615A","user_url":"https://www.facebook.com/108629115449345","username":"","valoration":0.0,"verified":false,"videoplays":0}],"previous_date_millis_offset":1735830629000,"previous_id_offset":"67d86de8ee2b452758f13f82"},"status":"OK"}
FAQ
Ainda não temos dúvidas para esse tópico, faça sua pergunta aqui.
