Introdução

Esse é o Stilingue Docs!

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

Publicações

Retorna as publicações encontradas no Mural de publicações do Warroom.

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.
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/publicacoes/{api-token}' \
      -d date_range=30 \
      -d limit=20 \
      -d removed=false \
      -d channels=Facebook%3AInstagram \
      -d uids=148775728483392%3A17841401681785247 \
      -d pids=17903382759089121%3A18053256691954432 \
      -d types=Image \
      -d genders=Marca \
      -d devices=mobile \
      -d langs=pt \
      -d annotated=true \
      -d order_by=date_asc

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	30	Esse campo traz dados do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	Não
channels	string	Twitter:Instagram:Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: Twitter, Instagram, InstagramComments, Facebook, FacebookComments, YouTube, YouTubeComments, News, Blogs, Linkedin, Tiktok	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
order_by	string	date_desc	Ordem na qual as publicações aparecem. Os valores possíveis são: date_desc, date_asc, updated_asc, updated_desc, hot, interactions, likes, shares, comments, followers, influence	Não
search_by	string	publication_id	Esse campo indica como fazer a pesquisa de um determinado PID informado no campo 'pids', se deve considerar como 'id da publicação' ou 'id da conversa'. Ao usar esse campo, os campos 'pids' e 'filters' tornam-se obrigatórios. Valores disponíveis são: publication_id, conversation_id . No momento essa funcionalidade está habilitado para funcionar apenas com um único id informado, ou seja, apenas um pid e um filter_id deve ser informado para conseguir aplicar essa funcionalidade corretamente. Importante, o filter_id informado não deve conter os pids, eles devem ser informados separadamente no respectivo campo, se não ele será considerado no filtro ao invés do valor no campo pids.	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
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: posts, comentarios, inbox, postvisitantes, comentariosvisitantes, reviews, comentariosreview, mentions, comentariosmentions Atenção: se o parâmetro filters for referente à um "Filtro de conversa", esse parâmetro se torna obrigatório!	Leia a descrição
status	string	Respondido	Status da conversa do post. Os valores possíveis são: Ignorado, Pendente, Aberto, Em Espera, Respondido, Fechado Atenção: se o parâmetro filters for referente à um "Filtro de conversa", esse parâmetro se torna obrigatório!	Leia a descrição

Corpo da resposta

Campo	Tipo	O que retorna	Descrição	Obrigatório
limit	number	número inteiro positivo	limite atual enviado como parâmetro	sim
next_offset	number	número inteiro positivo	total restante disponível para próximo offset	sim
offset	number	número inteiro positivo	offset atual	sim
request_time_millis	number	número inteiro positivo	tempo total do processamento da request em milissegundos	sim
posts	List Post	Lista de posts. Pode ser vazia	Lista de posts	sim

Post

Campo	Tipo	O que retorna	Descrição	Obrigatório
AAA_score	number	Número float	Pontuação proprietária da STILINGUE que indica a relevância de usuários com potencial influenciador.	sim
anonymous_user	boolean	true, false ou null	Se o usuário é anônimo	não
attachments	List<attachment>	Lista de objetos. Pode ser uma lista vazia.	Anexos de um post: vídeos, imagens, etc.	sim
channel	List<string>	Lista de strings	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`	sim
is_dynamic_post	boolean	true ou false	Se o post é dinâmico	sim
is_hidden	boolean	true ou false	Se o post é privado	sim
is_root	boolean	true, false ou null	Verifica se é a mensagem principal	não
lang	string		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
processed_by_performance	boolean	true, false ou null	Indica se a publicação é proprietária ou não	sim
reaction_angry	number	Número inteiro positivo ou null	Número de reações "grr" (exclusivo Facebook)	não
reaction_haha	number	Número inteiro positivo ou null	Número de reações "haha" (exclusivo Facebook)	não
reaction_like	number	Número inteiro positivo ou null	Número de reações "gostei" (exclusivo Facebook)	não
reaction_love	number	Número inteiro positivo ou null	Número de reações "amei" (exclusivo Facebook)	não
reaction_pride	number	Número inteiro positivo ou null	Número de reações "orgulho" (exclusivo Facebook)	não
reaction_sad	number	Número inteiro positivo ou null	Número de reações "triste" (exclusivo Facebook)	não
reaction_thankful	number	Número inteiro positivo ou null	Número de reações "força" (exclusivo Facebook)	não
reaction_wow	number	Número inteiro positivo ou null	Número de reações "uau" (exclusivo Facebook)	não
reaction_total	number	Número inteiro positivo ou null	Número total de reações (exclusivo Facebook)	não
reactions	number	Número inteiro positivo ou null	Número de reações à publicação	não
receiver	Objeto	receiver	Remetente da mensagem	sim
replier	string	string ou null	Dados de quem respondeu a conversa	não
replier_name	string	string ou null	Nome de quem respondeu a conversa	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
root_id	string	string ou null	ID do post principal, a publicação root	não
sac_call_id	string	string ou null	ID interno Stilingue da interação principal da conversa	não
sac_type	string	string ou null	Tipo da conversa. Os valores possíveis são: posts, comentarios, inbox, postvisitantes, comentariosvisitantes, reviews, comentariosreview, mentions, comentariosmentions	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
talk_id	string	string ou null	ID da conversa	não
text	string		Conteúdo de texto do post	sim
text_append	string	string ou null	Informação adicional do post ou sobre a interação. Exemplo de caso de comentário do Youtube: "Comentado em: Nome do video X";	não
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
to	string	string ou null	Destinatário da mensagem (inbox)	não
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
url_content	string	URL ou null	Armazena a URL direta do video associado ao post. *Disponível quando type é `video`	não
user_image_url	string	URL ou null	URL da foto de perfil da conta	não
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
name	string	string	Nome do anexo. Ex: "facebook_image"	não
size	number	número inteiro positivo	Tamanho em bytes do anexo	não
attachment_type	string	string	Tipo do anexo	não
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
type	string	string	MIME Type do anexo. Descrição detalhada	não
url	string	string	URL da mídia anexada	não

Receiver

Campo	Tipo	O que retorna	Descrição	Obrigatório
id	string	ID	ID do remetente	não
email	string	Email	Email do remetente	não
image_url	string	URL	URL da imagem do remetente	não
name	string	string	Nome do remetente	não

Corpo da resposta em json

{
  "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
}

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.

Warroom Visão Geral

Limitações

Esse endpoint retorna apenas dados para listening não funcionando para dados proprietários.
Alguns componentes da área de visão geral não são apresentados nesse endpoint, mas são apresentados em outros. Abaixo segue um mapeamento:
- Publicações no tempo: Publicações no tempo
- Distribuição por Temas: Sentimento por temas
- Distribuição por Grupos: Sentimento por grupos
- Distribuição por Regiões:Sentimento por regiões
- Distribuição por Buscas: Sentimento por buscas
- Distribuição por Tags: Sentimento por tags
- Distribuição por HashTags: Sentimento por hashtags
- Distribuição por Domínios: Sentimento por domínios
- Distribuição por Links: Sentimento por links
- Distribuição por Termos: Sentimento por termos

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/visao_geral/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	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
}

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.

Warroom Publicações no Tempo

Limitações

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.

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/linechart/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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`	não

Corpo da resposta

Campo	Tipo	Descrição
`data`	Array de Data	Contém os dados gerais de total de posts e as métricas diárias.
`request_time_millis`	`number`	Tempo total em milissegundos que a consulta levou para ser processada.

Data

Campo	Tipo	Exemplo	Descrição
`total_posts`	`number`	731929	Quantidade total de posts acumulados na consulta.
`data_por_dia`	Array de DataPorDia	-	Dados diários de posts analisados com data e quantidade.

DataPorDia

Campo	Tipo	Exemplo	Descrição
`data`	`string`	`"2024/12/06 00:00"`	Data correspondente ao registro (formato `YYYY/MM/DD HH:mm`).
`quantidade`	`number`	10640	Quantidade de posts analisados no dia especificado.

Corpo da resposta em json

{
  "data": [
    ["total_posts", 731929],
    [
      ["2024/12/06 00:00", 10640],
      ["2024/12/07 00:00", 9002],
      ["2024/12/08 00:00", 8431],
      ["2024/12/09 00:00", 7923],
      ["2024/12/10 00:00", 5156],
      ["2024/12/11 00:00", 4302],
      ["2024/12/12 00:00", 6530],
      ["2024/12/13 00:00", 14026],
      ["2024/12/14 00:00", 7339]
    ]
  ],
  "request_time_millis": 1543
}

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.

Warroom Sentimento por temas

Limitações

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.

Request

curl -X 'GET' \
   'https://api.stilingue.com.br/wrapi/sentimento_temas/{api-token}?date_range=2d&limit=20' \
   -H 'accept: application/json'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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`	não

Corpo da resposta

Campo	Tipo	Descrição
data	Dicionário de Data	Objeto contendo dados de sentimento por canal
request_time_millis	number	Tempo total que demorou a consulta
total_posts	number	Total de posts (publicações).

Data

Campo	Valores possíveis	Tipo	Descrição
nome do canal	Bluesky, Comentários em Artigos, Comentários no Facebook, Facebook, Instagram, Portais, Reclame Aqui, Twitter, all	Array de métricas	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
}

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.

Warroom Sentimento por Grupos

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/sentimento_grupos/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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
total	number	Quantidade total de posts para o grupo definido.
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": "RockinRio",
                "negative": 4378,
                "neutral": 3745,
                "not_classified": 0,
                "positive": 15420,
                "total": 23543,
                "total_polarity_classified": 23543
            },
        ],
        "Instagram": [
            {
                "channel": "Instagram",
                "name": "RockinRio",
                "negative": 2344,
                "neutral": 1578,
                "not_classified": 0,
                "positive": 17186,
                "total": 21108,
                "total_polarity_classified": 21108
            },
        ],
        "all": [
            {
                "channel": "all",
                "name": "RockinRio",
                "negative": 6722,
                "neutral": 5323,
                "not_classified": 0,
                "positive": 32606,
                "total": 44651,
                "total_polarity_classified": 44651
            },
        ]
    },
    "request_time_millis": 1680,
    "total_posts": 987971
}

Sentimento por Regiões

O endpoint traz dados do sentimento (positivo, negativo e neutro) das publicações separado por região. Para mais detalhes, clique aqui.

sentimento by region

Sentimento por região

Limitações

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.
- 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	Esse campo traz dados do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	Não
channels	string	Twitter:Instagram:Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: Twitter, Instagram, InstagramComments, Facebook, FacebookComments, YouTube, YouTubeComments, News, Blogs, Linkedin	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
order_by	string	date_desc	Ordem na qual as publicações aparecem. Os valores possíveis são: date_desc, date_asc, hot, interactions, likes, shares, comments, followers, influence	Não
removed	boolean	false	Retorna apenas publicações apagadas (o padrão é false)	Não

Corpo da resposta

Campo	Tipo	Descrição
data	[Dict]	dados sobre sentimento de uma região
total_posts	number	Total de posts (publicações).

Dict

Campo	Tipo	Descrição
key:`nome da região`	List<[Região]>	dados sobre sentimento de uma região

Região

Campo	Tipo	Descrição
name	string	nome da região
negative	number	total de publicações classificadas como negativas
neutral	number	total de publicações classificadas como neutras
positive	number	total de publicações classificadas como positivas
total	number	Quantidade total de posts para a região definida.
total_classified	number	total de publicações classificadas

Corpo da resposta em json

{
  "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
}

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..

Warroom Sentimento por Buscas

- É retornado um campo data, que contém um dicionário para cada canal. Dentro de cada canal, há uma lista de dicionários com as Buscas e seus respectivos valores de sentimentos. Além disso, dentro de data é retornado um campo All, que consiste em uma lista de dicionários. Cada dicionário representa uma Busca, e os valores de sentimentos correspondem à soma total dos sentimentos de todos os canais. - O comportamento do gráfico de Distribuição por Buscas tem relação com a classificação feita no gráfico de Sentimento por Termos. No caso de Distribuição por Buscas, os termos (individuais) são considerados. Isso faz com que os termos que não aparecem em Distribuição por Termos sejam incluídos na Distribuição por Buscas. Portanto, é natural que esse gráfico tenha um volume maior em relação às palavras.

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/sentimento_buscas/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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
total	number	Quantidade total de posts para a busca 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": "um",
        "negative": 5927,
        "neutral": 996,
        "not_classified": 0,
        "positive": 15670,
        "total": 22593,
        "total_polarity_classified": 22593
      },
      {
        "channel": "Facebook",
        "name": "show",
        "negative": 2219,
        "neutral": 1081,
        "not_classified": 0,
        "positive": 8693,
        "total": 11993,
        "total_polarity_classified": 11993
      },
      {
        "channel": "Facebook",
        "name": "aviao",
        "negative": 5012,
        "neutral": 708,
        "not_classified": 0,
        "positive": 1157,
        "total": 6877,
        "total_polarity_classified": 6877
      }
    ],
    "Instagram": [
      {
        "channel": "Instagram",
        "name": "novo",
        "negative": 2368,
        "neutral": 503,
        "not_classified": 0,
        "positive": 27907,
        "total": 30778,
        "total_polarity_classified": 30778
      },
      {
        "channel": "Instagram",
        "name": "um",
        "negative": 2717,
        "neutral": 361,
        "not_classified": 0,
        "positive": 18773,
        "total": 21851,
        "total_polarity_classified": 21851
      }
    ],
    "all": [
      {
        "channel": "all",
        "name": "um",
        "negative": 8644,
        "neutral": 1357,
        "not_classified": 0,
        "positive": 34443,
        "total": 44444,
        "total_polarity_classified": 44444
      },
      {
        "channel": "all",
        "name": "show",
        "negative": 2219,
        "neutral": 1081,
        "not_classified": 0,
        "positive": 8693,
        "total": 11993,
        "total_polarity_classified": 11993
      },
      {
        "channel": "all",
        "name": "aviao",
        "negative": 5012,
        "neutral": 708,
        "not_classified": 0,
        "positive": 1157,
        "total": 6877,
        "total_polarity_classified": 6877
      },
      {
        "channel": "all",
        "name": "novo",
        "negative": 2368,
        "neutral": 503,
        "not_classified": 0,
        "positive": 27907,
        "total": 30778,
        "total_polarity_classified": 30778
      }
    ]
  },
  "request_time_millis": 1788,
  "total_posts": 884102
}

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.

Warroom Sentimento por Tags

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/sentimento_tags/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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
}

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

Warroom Sentimento por HashTags

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/sentimento_hashtags/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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.
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": "anonovo",
        "negative": 28,
        "neutral": 0,
        "not_classified": 0,
        "positive": 1372,
        "total": 1400,
        "total_polarity_classified": 1400
      },
      {
        "channel": "Facebook",
        "name": "noticias",
        "negative": 442,
        "neutral": 137,
        "not_classified": 0,
        "positive": 551,
        "total": 1130,
        "total_polarity_classified": 1130
      },
      {
        "channel": "Facebook",
        "name": "felizanonovo",
        "negative": 2,
        "neutral": 0,
        "not_classified": 0,
        "positive": 854,
        "total": 856,
        "total_polarity_classified": 856
      }
    ],
    "Instagram": [
      {
        "channel": "Instagram",
        "name": "afazenda",
        "negative": 875,
        "neutral": 668,
        "not_classified": 0,
        "positive": 861,
        "total": 2404,
        "total_polarity_classified": 2404
      },
      {
        "channel": "Instagram",
        "name": "felizanonovo",
        "negative": 8,
        "neutral": 0,
        "not_classified": 0,
        "positive": 1615,
        "total": 1623,
        "total_polarity_classified": 1623
      }
    ],
    "all": [
      {
        "channel": "all",
        "name": "anonovo",
        "negative": 28,
        "neutral": 0,
        "not_classified": 0,
        "positive": 1372,
        "total": 1400,
        "total_polarity_classified": 1400
      },
      {
        "channel": "all",
        "name": "noticias",
        "negative": 442,
        "neutral": 137,
        "not_classified": 0,
        "positive": 551,
        "total": 1130,
        "total_polarity_classified": 1130
      },
      {
        "channel": "all",
        "name": "felizanonovo",
        "negative": 10,
        "neutral": 0,
        "not_classified": 0,
        "positive": 2469,
        "total": 2479,
        "total_polarity_classified": 2479
      },
      {
        "channel": "all",
        "name": "afazenda",
        "negative": 875,
        "neutral": 668,
        "not_classified": 0,
        "positive": 861,
        "total": 2404,
        "total_polarity_classified": 2404
      }
    ]
  },
  "request_time_millis": 1788,
  "total_posts": 884102
}

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.

Warroom Sentimento por domínios

* É retornado um campo data, que contém um dicionário para cada canal. Dentro de cada canal, há uma lista de dicionários com os domínios e seus respectivos valores de sentimentos. Além disso, dentro de data é retornado um campo All, que consiste em uma lista de dicionários. Cada dicionário representa um domínio, e os valores de sentimentos correspondem à soma total dos sentimentos de todos os canais.
- Na documentação do Warroom é destacado que em alguns momentos o gráfico de Distribuição por domínios pode exibir a mensagem de “Não Classificados”. Quando isso ocorrer, significa que as publicações coletadas não contém domínios. Essa situação ocorre com mais frequência em filtros com tipos de publicações onde os canais não incentivam ou não permitem o compartilhamento de links. Link para documentação

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/sentimento_dominios/{api-token}?date_range=2d' \
  -H 'accept: */*'

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 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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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.
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": "bit.ly",
        "negative": 332,
        "neutral": 204,
        "not_classified": 0,
        "positive": 848,
        "total": 1384,
        "total_polarity_classified": 1384
      },
      {
        "channel": "Facebook",
        "name": "glo.bo",
        "negative": 149,
        "neutral": 48,
        "not_classified": 0,
        "positive": 137,
        "total": 334,
        "total_polarity_classified": 334
      }
    ],
    "Instagram": [
      {
        "channel": "Instagram",
        "name": "Não Classificados",
        "negative": 8029,
        "neutral": 3590,
        "not_classified": 0,
        "positive": 50670,
        "total": 62289,
        "total_polarity_classified": 62289
      }
    ],
    "all": [
      {
        "channel": "all",
        "name": "bit.ly",
        "negative": 332,
        "neutral": 204,
        "not_classified": 0,
        "positive": 848,
        "total": 1384,
        "total_polarity_classified": 1384
      },
      {
        "channel": "all",
        "name": "glo.bo",
        "negative": 149,
        "neutral": 48,
        "not_classified": 0,
        "positive": 137,
        "total": 334,
        "total_polarity_classified": 334
      },
      {
        "channel": "all",
        "name": "Não Classificados",
        "negative": 8029,
        "neutral": 3590,
        "not_classified": 0,
        "positive": 50670,
        "total": 62289,
        "total_polarity_classified": 62289
      }
    ]
  },
  "request_time_millis": 1788,
  "total_posts": 884102
}

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.

Warroom Sentimento por Links

* É retornado um campo data, que contém um dicionário para cada canal. Dentro de cada canal, há uma lista de dicionários com os links e seus respectivos valores de sentimentos. Além disso, dentro de data é retornado um campo All, que consiste em uma lista de dicionários. Cada dicionário representa um link, e os valores de sentimentos correspondem à soma total dos sentimentos de todos os canais.
- Na documentação do Warroom é destacado que em alguns momentos o gráfico de Distribuição por Links pode exibir a mensagem de “Não Classificados”. Quando isso ocorrer, significa que as publicações coletadas não contém links. Essa situação ocorre com mais frequência em filtros com tipos de publicações onde os canais não incentivam ou não permitem o compartilhamento de links.

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/sentimento_links/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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
total	number	Quantidade total de posts para o link definido.
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": "metropoles.com",
        "negative": 116,
        "neutral": 3,
        "not_classified": 0,
        "positive": 57,
        "total": 176,
        "total_polarity_classified": 176
      },
      {
        "channel": "Facebook",
        "name": "PlayPlus.com",
        "negative": 17,
        "neutral": 47,
        "not_classified": 0,
        "positive": 91,
        "total": 155,
        "total_polarity_classified": 155
      },
      {
        "channel": "Facebook",
        "name": "WWW.VIVIANFESTAS.COM.BR",
        "negative": 58,
        "neutral": 1,
        "not_classified": 0,
        "positive": 87,
        "total": 146,
        "total_polarity_classified": 146
      }
    ],
    "Instagram": [
      {
        "channel": "Instagram",
        "name": "Não Classificados",
        "negative": 8029,
        "neutral": 3590,
        "not_classified": 0,
        "positive": 50670,
        "total": 62289,
        "total_polarity_classified": 62289
      }
    ],
    "all": [
      {
        "channel": "all",
        "name": "metropoles.com",
        "negative": 116,
        "neutral": 3,
        "not_classified": 0,
        "positive": 57,
        "total": 176,
        "total_polarity_classified": 176
      },
      {
        "channel": "all",
        "name": "PlayPlus.com",
        "negative": 17,
        "neutral": 47,
        "not_classified": 0,
        "positive": 91,
        "total": 155,
        "total_polarity_classified": 155
      },
      {
        "channel": "all",
        "name": "WWW.VIVIANFESTAS.COM.BR",
        "negative": 58,
        "neutral": 1,
        "not_classified": 0,
        "positive": 87,
        "total": 146,
        "total_polarity_classified": 146
      },
      {
        "channel": "all",
        "name": "Não Classificados",
        "negative": 8029,
        "neutral": 3590,
        "not_classified": 0,
        "positive": 50670,
        "total": 62289,
        "total_polarity_classified": 62289
      }
    ]
  },
  "request_time_millis": 1788,
  "total_posts": 884102
}

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.

Warroom Sentimento por Termos.

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 POST \
      'https://api.stilingue.com.br/wrapi/estatisticas_termos/{api-token}' \
      -d date_range=7d \
      -d limit=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	Esse campo traz dados do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	Não
channels	string	Twitter:Instagram:Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: Twitter, Instagram, InstagramComments, Facebook, FacebookComments, YouTube, YouTubeComments, News, Blogs, Linkedin	Não
uids	string	149775728483392:17841401681785347	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)	Não

Corpo da resposta

Campo	Tipo	Descrição
data	channels	dados da api
total_posts	number	Total de posts (publicações).

Response

Campo	Tipo	Descrição
data	channels	dados da api
total_posts	number	Total de posts (publicações).

Channel

Campo	Tipo	Descrição
<`canal`>	List<themes>	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.
all	List<themes>	Estatísticas de todos os canais agrupados juntos.

Theme

Campo	Tipo	Descrição
absorbed_names	List<string>	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
}

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.

Influenciadores Ranking AAA

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/top_influenciadores/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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
influencers_list	Dicionário de Lista de Influenciadores	Objeto contendo dados dos influenciadores encontrados no gráfico de ranking AAA
request_time_millis	number	Tempo total que demorou a consulta

Lista de Influenciadores

Campo	Tipo	Descrição
afinity_normalized	number	Pontuação interna de afinidade normalizada para o Warroom
afinity_score	number	Pontuação interna de afinidade
assertiviness_score	number	Soma da viralidade dos posts / LOG_10 da quantidade de seguidores
channel	string	Canal onde se encontra a página do influenciador em questão
followers	number	Quantidade de seguidores que o influenciador possui
followers_score	number	Pontuação interna que pontua os seguidores e o quanto são influenciados, o score aumenta se eles compartilham, comentam, curtem, etc.
groups	list	Grupos nos quais as publicações do influenciador foram classificadas.
is_verified	booleano	Informa se o perfil é verificado.
name	string	Nome do perfil do influenciador.
occupation	string	Interesse dos influenciadores.
position	number	Posição atual do perfil no ranking.
posts_count	number	Quantidade de publicações encontradas do influenciador.
ranking_3as	number	Ranking AAA
ranking_harmonic_mean	number	Ranking AAA
reach_normalized	number	Alcance normalizado
reach_score	number	Raiz quadrada do número de followers
uid	string	ID do influenciador
url	string	URL da página do influenciador
username	string	Nome do usuário da página do influenciador
virality_score	number	Pontuação interna que indica o quanto o usuário "viraliza" com os posts
viralization_normalized	number	Atratividade normalizada

Corpo da resposta em json

{
  "influencers_list": [
    {
      "afinity_normalized": 0.9985276467723682,
      "afinity_score": 3.83799428915828,
      "assertiviness_score": 1310643.2747305783,
      "channel": "Instagram",
      "followers": 24583050,
      "followers_score": 49166100.0,
      "groups": [
        "Grupo tste B2 olhando_849029",
        "RockinRio_3084711",
        "testanyyy_6383307",
        "Chuchu comment_1955677",
        "[test]_6906480",
        "TENT POC Cézar Menções_1433000",
        "Concorrente B_5102770"
      ],
      "is_verified": false,
      "name": "Alfinetei",
      "occupation": "",
      "position": 0,
      "posts_count": 62.0,
      "ranking_3as": 0.746011234496696,
      "ranking_harmonic_mean": 0.746011234496696,
      "reach_normalized": 0.7322356476823586,
      "reach_score": 7011.854248342588,
      "uid": "17841401681785247",
      "url": "https://www.instagram.com/alfinetei",
      "username": "alfinetei",
      "virality_score": 10081030.0,
      "viralization_normalized": 0.5678389008434728
    },
    {
      "afinity_normalized": 0.4935127880230555,
      "afinity_score": 1.8772558615093626,
      "assertiviness_score": 2326006.3792993813,
      "channel": "Instagram",
      "followers": 12932967,
      "followers_score": 25865934.0,
      "groups": ["RockinRio_3084711", "Concorrente A_7466018"],
      "is_verified": false,
      "name": "Corinthians",
      "occupation": "",
      "position": 0,
      "posts_count": 92.0,
      "ranking_3as": 0.6410608439435995,
      "ranking_harmonic_mean": 0.6410608439435995,
      "reach_normalized": 0.5338255327398043,
      "reach_score": 5085.856270088647,
      "uid": "17841401449488648",
      "url": "https://www.instagram.com/corinthians",
      "username": "corinthians",
      "virality_score": 17242053.0,
      "viralization_normalized": 1.0
    }
  ],
  "influencers_static": false
}

Ranking AAA

Retorna o Ranking AAA de influencia do Warroom. Para entender os detalhes e como é calculado, click aqui.

Ranking AAA de influencia

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.
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}' \
      -d date_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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	Não
channels	string	Twitter:Instagram:Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: Twitter, Instagram, InstagramComments, Facebook, FacebookComments, YouTube, YouTubeComments, News, Blogs, Linkedin	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. 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: date_desc, date_asc, hot, interactions, likes, shares, comments, followers, influence	Não
removed	boolean	false	Retorna apenas publicações apagadas (o padrão é false)	Não

Corpo da resposta

Campo	Tipo	O que retorna	Descrição	Obrigatório
data	List<channel>	Lista de objetos do tipo `channel`	Retorna uma lista de objetos, onde cada canal possui uma lista de influenciadores associados.	sim

Channel

Campo	Tipo	O que retorna	Descrição	Obrigatório
channel	string	nome do canal	Retorna o nome do canal ao qual a lista de influenciadores está associada.	sim
influencers	List<influencer>	Lista de influenciadores.	Pode ser vazia.	sim

Influencer

Campo	Tipo	O que retorna	Descrição	Obrigatório
afinity_normalized	string	valor positivo	Pontuação interna de afinidade normalizada para o Warroom	sim
afinity_score	number	valor positivo	Pontuação interna de afinidade	sim
assertiviness_score	number	valor positivo	Soma da viralidade dos posts / LOG_10 da quantidade de seguidores	sim
channel	string	string	Canal do influencer. Util para `channel: "Geral"`	sim
facebook_type	string	string	Disponível quando o canal e Facebook. Os valores possíveis são: `page, user`	sim
followers	number	valor positivo inteiro	Quantidade de seguidores	sim
followers_score	number		Pontuação interna que pontua os seguidores e o quanto são influenciados, o score aumenta se eles compartilham, comentam, curtem, etc.	sim
gender	string	string	Gênero do influencer. Os valores possíveis são: `Homem, Mulher, Marca`	sim
groups	List<string>	Lista de strings. Pode ser vazia.	Grupos da pesquisa em que mais publica	sim
interacted_page_id	string	ID	ID da página influencer. Disponível apenas para canal `Facebook`	não
is_verified	boolean	true ou false	Informa se o perfil é verificado.	sim
name	string		Nome do influencer	sim
occupation	string	string	Ocupação do influencer. Pode ser string vazia.	sim
position	number	valor positivo inteiro	Posição do influenciador no ranking.	sim
posts_count	number	Valor positivo	Quantidade de posts do influencer no intervalo de tempo	sim
profile_picture	string	URL	URL da imagem do perfil	sim
ranking_3as	number	Valor positivo	Ranking AAA	sim
reach_normalized	number	número positivo	Pontuação de alcance do usuário normalizada para o Warroom	sim
reach_score	number	número positivo	Pontuação interna de alcance do usuário	sim
uid	string	ID	ID do perfil	não
url	string	URL	URL do perfil	sim
username	string	string	Nome de usuário único	sim
virality_score	number	número positivo	Pontuação interna que indica o quanto o usuário "viraliza" com os posts	sim
viralization_normalized	number		Pontuação que indica o quanto o usuário "viraliza" com os posts normalizada para o Warroom	sim

Corpo da resposta em json

{
  "data": [
    {
      "channel": "Geral",
      "influencers": [
         {
            "afinity_normalized": 0.9463811728567596,
            "afinity_score": 12.764828861867926,
            "assertiviness_score": 3439235.6281827353,
            "channel": "Instagram",
            "followers": 12924659,
            "followers_score": 25849318.0,
            "groups": [
                "Grupo1"
            ],
            "is_verified": false,
            "name": "Corinthians",
            "occupation": "",
            "position": 0,
            "posts_count": 183.0,
            "profile_picture": "url",
            "ranking_3as": 0.7328776168178424,
            "ranking_harmonic_mean": 0.7328776168178424,
            "reach_normalized": 0.41593769594242413,
            "reach_score": 5084.222457760872,
            "uid": "17841401449488648",
            "url": "https://www.instagram.com/corinthians",
            "username": "corinthians",
            "virality_score": 25493159.0,
            "viralization_normalized": 1.0
          }
      ]
    }
  ]
}

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

curl --location 'https://api.stilingue.com.br/wrapi/manchetes/{api-token}?date_range=2d' \
--header 'accept: */*'

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
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

Campo	Tipo	O que retorna	Descrição
data	List<manchete>	valores positivos	descrição explicando brevemente o que é esse campo

Campo	Tipo	Descrição
available_time	number	-
channel	string	Nome do canal onde a manchete foi compartilhada
published_at	string	Data em que a manchete foi publicada
real_weight	number	-
sentiment	number	Sentimento geral daquela manchete, sendo: 0(neutro), 1(positivo), -1(negativo)
title	string	Titulo da manchete compartilhada
uid	string	Identificação do usuário que publicou a manchete
user	string	Nome do usuário que publicou a manchete
weight	number	-

{
  "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
}

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.

Warroom Visão Geral

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/onde/{api-token}?date_range=2d' \
  -H 'accept: */*'

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	10	Esse campo traz dados do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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

Corpo da resposta

Campo	Tipo	Descrição
cities_table	List <Cities>	Lista de estados e cidades e a quantidade de posts.
data	List <Coordinates>	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
}

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

press mural

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.

curl --location 'https://api.stilingue.com.br/wrapi/imprensa/{api-token}' \
--header 'accept: */*'

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. Caso esse parâmetro não seja informado, será considerado 1d.	Não
last_days	number	30	Esse campo traz dados do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	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
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: date_desc, date_asc, hot, interactions, likes, shares, comments, followers, influence	Não
removed	boolean	false	Retorna apenas publicações apagadas (o padrão é false)	Não

Corpo da resposta

Campo	Tipo	O que retorna	Descrição	Obrigatório
limit	number	número inteiro positivo	Limite atual enviado como parâmetro	sim
next_offset	number	número inteiro positivo	Total restante disponível para próximo offset	sim
offset	number	número inteiro positivo	Offset atual	sim
request_time_millis	number	número inteiro positivo	Tempo total do processamento da request em milissegundos	sim
posts	List<post>	Lista de posts. Pode ser vazia	Lista de posts	sim

Post

Campo	Tipo	O que retorna	Descrição	Obrigatório
AAA_score	number	Número float	Pontuação proprietária da STILINGUE que indica a relevância de usuários com potencial influenciador.	sim
attachments	List<attachment>	Lista de objetos. Pode ser uma lista vazia.	Anexos de um post: vídeos, imagens, etc.	sim
channel	List<string>	Lista de strings	Canal origem do post. Os valores possíveis são: Portais, News, Blogs	sim
comments	number	Número inteiro positivo	Número de comentários do post	sim
computer_vision	Objeto	Objeto	Retorna informações quando encontra uma imagem com texto e seu conteúdo.	não
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
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
summary_text	string	string ou null	Conteúdo html do texto da 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`	sim
is_dynamic_post	boolean	true ou false	Se o post é dinâmico	sim
is_hidden	boolean	true ou false	Se o post é privado	sim
is_root	boolean	true, false ou null	Verifica se é a mensagem principal	não
lang	string		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
}

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}}' \
    -d date_range=30d \
    -d removed=false \
    -d channels=Facebook%3AInstagram \
    -d genders=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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	Não
channels	string	Twitter:Instagram:Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: Twitter, Instagram, InstagramComments, Facebook, FacebookComments, YouTube, YouTubeComments, News, Blogs, Linkedin	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
order_by	string	date_desc	Ordem na qual as publicações aparecem. Os valores possíveis são: date_desc, date_asc, hot, interactions, likes, shares, comments, followers, influence	Não
removed	boolean	false	Retorna apenas publicações apagadas (o padrão é false)	Não

Corpo da resposta

Campo	Tipo	O que retorna	Descrição	Obrigatório
day_posts	number	500	Total de posts de hoje	sim
month_posts	number	2000	Total de posts do mês	sim
total_known_posts	number	5000	Total de posts que foram classificados em algum grupo	sim
total_names	number	30	Total de grupos	sim
total_posts	number	10000	Total de posts no intervalo de data	sim
total_themes	number	40	Total de temas no intervalo de data	sim
groups	List<[string, number, number]>	[["Geral", 2000, 20]]	Lista de tuplas que seguem a estrutura `[nome, total de posts no intervalo nesse grupo, % em relação ao total geral]`	sim
themes	List<[string, number, number]>	[["Política", 1000, 10]]	Lista de tuplas que seguem a estrutura `[nome, total de posts no intervalo nesse tema, % em relação ao total geral]`	sim

Corpo da resposta em json

{
    "day_posts": 8309,
    "month_posts": 938611,
    "request_time_millis": 5345,
    "groups": [
      [ "Grupo1", 9959, 20.5 ]
    ],
    "themes": [
      [ "Tema1", 2000, 19.99998 ]
    ],
    "total_known_posts": 721423,
    "total_names": 721426,
    "total_posts": 721422,
    "total_themes": 566341,
    "week_posts": 235359
}

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

Request

curl --location 'https://api.stilingue.com.br/wrapi/quando/{api-token}?date_range=10d' \
--header 'accept: */*'

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	30	Esse campo traz dados do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	Não
channels	string	Twitter:Instagram:Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: Twitter, Instagram, InstagramComments, Facebook, FacebookComments, YouTube, YouTubeComments, News, Blogs, Linkedin	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
removed	boolean	false	Retorna apenas publicações apagadas (o padrão é false)	Não

Corpo da resposta

Campo	Tipo	Descrição
byday	List<info>	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
byhour	List<info>	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
bymonth	List<info>	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
byweekday	List<info>	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.
id	string	Nome da propriedade que os dados pertencem.
name	string	Mesmo valor de id.

Corpo da resposta em json

{
  "byday": [
    {
      "data": [
        0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 18385, 18017, 25425, 29449, 30480, 31924,
        24509, 46, 403, 4942, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
      ],
      "id": "Positivo",
      "name": "Positivo"
    },
    {
      "data": [
        0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 15654, 14605, 18258, 24645, 29277, 28753,
        21121, 50, 329, 4241, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
      ],
      "id": "Negativo",
      "name": "Negativo"
    },
    {
      "data": [
        0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 4670, 4667, 5642, 8336, 9739, 10261, 7803,
        83, 321, 1740, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
      ],
      "id": "Neutro",
      "name": "Neutro"
    },
    {
      "data": [
        0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0,
        0, 0, 0, 0, 0, 0, 0
      ],
      "id": "N\u00e3o Classificado",
      "name": "N\u00e3o Classificado"
    }
  ],
  "byday_categories": [
    1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21,
    22, 23, 24, 25, 26, 27, 28, 29, 30, 31
  ],
  "byday_linechart": [
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 8.0, 10.0, 15.0, 8.0, 2.0, 5.0, 7.0, -2.0,
    8.0, 7.0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
  ],
  "byday_reach_linechart": [
    0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 408094324, 436942267, 570171809, 673276372,
    729237797, 646699415, 544673239, 1082365, 6164234, 196394101, 0, 0, 0, 0, 0,
    0, 0, 0, 0, 0, 0
  ],
  "byhour": [
    {
      "data": [
        5210, 3685, 2414, 1963, 1733, 2525, 3595, 5453, 8032, 10058, 11623,
        12492, 13430, 11547, 10618, 10403, 10117, 10342, 9976, 9003, 8469, 8427,
        6359, 6106
      ],
      "id": "Positivo",
      "name": "Positivo"
    },
    {
      "data": [
        5509, 3647, 2516, 1826, 1659, 2093, 3282, 5143, 7158, 8271, 9248, 9793,
        10829, 9542, 8823, 8139, 8165, 8353, 8267, 7752, 7284, 7354, 6081, 6199
      ],
      "id": "Negativo",
      "name": "Negativo"
    },
    {
      "data": [
        2061, 1445, 926, 652, 504, 547, 900, 1483, 1999, 2504, 2918, 3048, 3670,
        3300, 2802, 2655, 2594, 2641, 2899, 2729, 3161, 2639, 2455, 2730
      ],
      "id": "Neutro",
      "name": "Neutro"
    },
    {
      "data": [
        0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0
      ],
      "id": "N\u00e3o Classificado",
      "name": "N\u00e3o Classificado"
    }
  ],
  "byhour_categories": [
    "0h",
    "1h",
    "2h",
    "3h",
    "4h",
    "5h",
    "6h",
    "7h",
    "8h",
    "9h",
    "10h",
    "11h",
    "12h",
    "13h",
    "14h",
    "15h",
    "16h",
    "17h",
    "18h",
    "19h",
    "20h",
    "21h",
    "22h",
    "23h"
  ],
  "byhour_linechart": [
    -2.0, 1.0, -1.0, 4.0, 2.0, 9.0, 5.0, 3.0, 6.0, 9.0, 10.0, 11.0, 10.0, 9.0,
    9.0, 11.0, 10.0, 10.0, 9.0, 7.0, 7.0, 6.0, 2.0, -0.0
  ],
  "byhour_reach_linechart": [
    101793432, 119545491, 88945173, 97218926, 87964152, 80269263, 108123111,
    171701156, 227673820, 281735355, 345882723, 386723771, 494897836, 403492441,
    336957807, 358667530, 355536124, 318610791, 347925082, 370114898, 286925897,
    221889811, 227022220, 171188087
  ],
  "bymonth": [
    {
      "data": [183580, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
      "id": "Positivo",
      "name": "Positivo"
    },
    {
      "data": [156933, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
      "id": "Negativo",
      "name": "Negativo"
    },
    {
      "data": [53262, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
      "id": "Neutro",
      "name": "Neutro"
    },
    {
      "data": [0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
      "id": "N\u00e3o Classificado",
      "name": "N\u00e3o Classificado"
    }
  ],
  "bymonth_categories": [
    "Janeiro",
    "Fevereiro",
    "Mar\u00e7o",
    "Abril",
    "Maio",
    "Junho",
    "Julho",
    "Agosto",
    "Setembro",
    "Outubro",
    "Novembro",
    "Dezembro"
  ],
  "bymonth_linechart": [7.0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
  "bymonth_reach_linechart": [1649555953, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0],
  "byweekday": [
    {
      "data": [18420, 30367, 29449, 30480, 31924, 24509, 18431],
      "id": "Positivo",
      "name": "Positivo"
    },
    {
      "data": [14934, 22499, 24645, 29277, 28753, 21121, 15704],
      "id": "Negativo",
      "name": "Negativo"
    },
    {
      "data": [4988, 7382, 8336, 9739, 10261, 7803, 4753],
      "id": "Neutro",
      "name": "Neutro"
    },
    {
      "data": [0, 0, 0, 0, 0, 0, 0],
      "id": "N\u00e3o Classificado",
      "name": "N\u00e3o Classificado"
    }
  ],
  "byweekday_categories": [
    "Domingo",
    "Segunda",
    "Ter\u00e7a",
    "Quarta",
    "Quinta",
    "Sexta",
    "S\u00e1bado"
  ],
  "byweekday_linechart": [10.0, 14.0, 8.0, 2.0, 5.0, 7.0, 8.0],
  "byweekday_reach_linechart": [
    439758498, 644574709, 673276372, 729237797, 646699415, 544673239, 408633172
  ],
  "total_posts": 393775
}

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..

Ranking Evolutivo

Limitações

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.

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/ranking_evolutivo/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	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
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.
themes	Lista lincada de Themes	Lista de objetos que inclui o nome do grupo, sua posição e quantidade de publicações diárias.
themes_count	number	Quantidade de grupos retornados que são visíveis no gráfico.
time_interval	string	Maneira que os dados foram agrupados, sendo que para a API é apenas por dia.
title_chart	string	Número do painel.
total_posts	number	Quantidade de posts coletados considerado na amostra.

Themes

Campo	Tipo	Descrição
data	Lista lincada de Data	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
}

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

Temas e Tópicos

Limitações

No gráfico é possível escolher visualizar os termos citados entre grupos e temas, no entanto, na API é possível apenas obter os dados para grupos.

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/temasetopicos/{api-token}?date_range=2d' \
  -H 'accept: */*'

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
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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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
groups	Lista lincada de Groups	Lista que contém os grupos com seus respectivos termos e polaridades.
polarities	Lista lincada de Polarities	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.

Groups

Campo	Tipo	Descrição
groups	Lista lincada de Groups interno	Lista de objetos que inclui o termo coletado para cada grupo correspondente, juntamente com seu respectivo peso.
label	String	Nome do grupo correspondente
polarities	Lista lincada de Polarities	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
}

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.

Warroom Termos correlacionados

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/wrapi/termos/{api-token}?date_range=2d' \
  -H 'accept: */*'

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

Corpo da resposta

Campo	Tipo	Descrição
children	Lista lincada de Children	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.
data	Objeto do tipo Data	Objeto contendo dados estatísticos de um determinado termo.
id	number	Esse id sempre será 0, pois indica que é o nó pai de todos, o nó root da correlação.
name	string	Esse name sempre será `todos`, pois indica o inicio de todas as análises filtradas na consulta feita.
request_time_ms	number	Indica tempo total que levou para fazer a consulta.
total_posts	number	Quantidade total de posts com termos analisados.
type	string	Tipo de consulta feita, sempre será `Query`.

Children

Campo	Tipo	Descrição
children	Lista lincada de Children	Objeto contendo estrutura de termos correlacionados com estatísticas, neste caso um termo correlacionado.
data	Objeto do tipo Data	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.

Corpo da resposta em json

{
  "children": [
    {
      "children": [
        {
          "children": [
            {
              "children": [],
              "data": {
                "acceleration": 0.0,
                "mentions": 3.0,
                "negative": 1,
                "neutral": 0,
                "normalized_acceleration": 1.0,
                "normalized_mentions": 1.2670422692493433,
                "positive": 2,
                "sentiment": 0,
                "total_posts": 3
              },
              "id": 3,
              "name": "QGdoPOP",
              "type": "Term"
            },
            {
              "children": [],
              "data": {
                "acceleration": 0.0,
                "mentions": 3.0,
                "negative": 1,
                "neutral": 0,
                "normalized_acceleration": 1.0,
                "normalized_mentions": 1.2670422692493433,
                "positive": 2,
                "sentiment": 0,
                "total_posts": 3
              },
              "id": 4,
              "name": "AcervoCharts",
              "type": "Term"
            }
          ],
          "data": {
            "acceleration": -1.0,
            "mentions": 80.0,
            "negative": 30,
            "neutral": 5,
            "normalized_acceleration": 0.1,
            "normalized_mentions": 3.429522838623827,
            "positive": 45,
            "sentiment": 0,
            "total_posts": 80
          },
          "id": 1,
          "name": "RISOS",
          "type": "Term"
        },
        {
          "children": [
            {
              "children": [],
              "data": {
                "acceleration": 0.0,
                "mentions": 8.0,
                "negative": 2,
                "neutral": 0,
                "normalized_acceleration": 1.0,
                "normalized_mentions": 1.9130235490997354,
                "positive": 6,
                "sentiment": 0,
                "total_posts": 8
              },
              "id": 33,
              "name": "Whopedr",
              "type": "Term"
            },
            {
              "children": [],
              "data": {
                "acceleration": 0.0,
                "mentions": 4.0,
                "negative": 0,
                "neutral": 0,
                "normalized_acceleration": 1.0,
                "normalized_mentions": 1.4565117745498677,
                "positive": 4,
                "sentiment": 0,
                "total_posts": 4
              },
              "id": 34,
              "name": "EnsaiosDaAnitta",
              "type": "Term"
            }
          ],
          "data": {
            "acceleration": -1.0,
            "mentions": 45.0,
            "negative": 13,
            "neutral": 2,
            "normalized_acceleration": 0.1,
            "normalized_mentions": 3.0505838280227784,
            "positive": 30,
            "sentiment": 0,
            "total_posts": 45
          },
          "id": 2,
          "name": "Anitta",
          "type": "Term"
        }
      ],
      "data": {
        "acceleration": -1.0,
        "mentions": 1297.0,
        "negative": 377,
        "neutral": 86,
        "normalized_acceleration": 0.1,
        "normalized_mentions": 5.264259487512781,
        "positive": 834,
        "sentiment": 0,
        "total_posts": 1296
      },
      "id": 1,
      "name": "Show",
      "type": "Term"
    }
  ],
  "coreferences": {
    "Agenda": ["AGENDA", "Agenda"],
    "Anitta": ["ANITTA", "Anitta"],
    "Aviao": ["Aviao", "AVIAO"]
  },
  "data": {
    "acceleration": -0.999540018399264,
    "mentions": 18093.0,
    "negative": 6925,
    "neutral": 1918,
    "normalized_acceleration": 0.0004599816007360147,
    "normalized_mentions": 7.0,
    "positive": 9250,
    "sentiment": 1,
    "total_posts": 18093
  },
  "id": 0,
  "name": "Todos",
  "request_time_ms": 2633,
  "total_posts": 18093,
  "type": "Query"
}

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.

Warroom - Publicações

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.
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}' \
      -d date_range=202402040000:202501282359 \
      -d limit=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 n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	Não
channel	string	instagram	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: twitter, instagram, facebook, tiktok, youtube, news, blogs, linkedin	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
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: date_desc, date_asc, hot, interactions, likes, shares, comments, followers, influence	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
fanpages	string	987654321	IDs das páginas proprietárias conectadas. Separar múltiplos valores usando dois pontos. Os IDs podem ser encontrados em /pages/getpages/{api-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: posts, comentarios, inbox, postvisitantes, comentariosvisitantes, reviews, comentariosreview, mentions, comentariosmentions Atenção: se o parâmetro filters for referente à um "Filtro de conversa", esse parâmetro se torna obrigatório!	Leia a descrição
status	string	Respondido	Status da conversa do post. Os valores possíveis são: Ignorado, Pendente, Aberto, Em Espera, Respondido, Fechado Atenção: se o parâmetro filters for referente à um "Filtro de conversa", esse parâmetro se torna obrigatório!	Leia a descrição

Corpo da resposta

Campo	Tipo	O que retorna	Descrição	Obrigatório
limit	number	número inteiro positivo	Limite atual enviado como parâmetro	sim
next_offset	number	número inteiro positivo	Total restante disponível para próximo offset	sim
offset	number	número inteiro positivo	Offset atual	sim
total_posts	number	número inteiro positivo	Total de posts (publicações).	sim
total_posts_filtered	number	número inteiro positivo	Total de posts (publicações) filtrados	sim
page_info	Page info proprietário	objeto	Informações da página	sim
posts	list<post>	lista de posts. Pode ser vazia	Lista de posts	sim

Post proprietário

Campo	Tipo	O que retorna	Descrição	Obrigatório
AAA_score	number	Número float	Pontuação proprietária da STILINGUE que indica a relevância de usuários com potencial influenciador.	sim
anonymous_user	boolean	true, false ou null	Se o usuário é anônimo	não
attachments	List< Anexo proprietário >	Lista de objetos. Pode ser uma lista vazia.	Anexos de um post: vídeos, imagens, etc.	sim
channel	string		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.	sim
comments	number	Número inteiro positivo	Número de comentários do post	sim
comments_answers	Resposta a comentários	objeto	Objeto com total de comentários e respostas	sim
comments_polarities	Sentimento comentário	objeto	Objeto com informações de sentimento dos comentários	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
cvtags	list<string>	Lista de strings	Armazena tags associadas ao post (mas é diferente de hashtags)	não
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_impressions	number	11	Número de impressões no Facebook	sim
fb_pid	string	"18049890541950243"	ID do post no Facebook	não
fb_reach	number	14	Número de alcance no Facebook	não
fb_uid	string	"17841457108652818"	ID do autor no Facebook	não
features	List<string>	["FEED"]	Campo interno usado para auxiliar no processamento. Os valores possíveis são: `FEED, REELS`	não
followers	number	21	Quantidade de seguidores da página/autor	sim
gender	string	Valor em string, string vazia 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	2453.984362509439	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
ig_pid	string	"3496992623145473920"	ID do post no Instagram	não
image_url	string	string ou null	URL da imagem do post	não
integration_name	string	?	Nome da integração que originou a publicação	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	9	Quantidade total de interações no post (soma comentários, curtidas, compartilhamentos, etc)	não
interests	List<string>	["Tecnologia"]	Interesses do autor do post. Exemplo: `Tecnologia & Computação,Mídia / Impresso,Imprensa Social`	sim
is_dynamic_post	boolean	true ou false	Se o post é dinâmico	sim
kpi_engagement	number	9	Quantidade total de interações no post (soma comentários, curtidas, compartilhamentos, etc)	não
kpi_saved	number	0	Quantidade total de salvamentos no post	não
is_hidden	boolean	true, false ou null	Se o post é privado	não
is_root	boolean	true, false ou null	Verifica se é a mensagem principal	não
lang	string	other	Idioma do post. Os valores possíveis são: `pt, en, es, other`	sim
likes	number	2	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	1731094027000	Data de postagem do post em formato UNIX milissegundos	não
long_updated_at	number	1734120168483	Data da última alteração do post em formato UNIX milissegundos	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>	[]	Nome dos usuários mencionados no post	não
metrics_updated_at	string	"08/12/2024 16:27"	Última vez que as métricas do post foram atualizadas	sim
name	string	folks.sti	Nome do autor do post	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	"57062551623"		ID da página proprietária conectada que fez o post	sim
pages	List<string>	["57062551623"]	ID da página. Usado para filtrar posts de uma página específica	sim
pid	string	"3496992623145473920_57062551623"	ID do post	sim
post_id	string	"3496992623145473920_57062551623"	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	"08/11/2024 16:27"	Data da postagem	sim
primary_channel	string	Instagram	Canal onde a publicação foi feita	sim
processed_by_performance	boolean	true, false ou null	Indica se a publicação é proprietária ou não	sim
reaction_angry	number	Número inteiro positivo ou null	Número de reações "grr" (exclusivo Facebook)	não
reaction_haha	number	Número inteiro positivo ou null	Número de reações "haha" (exclusivo Facebook)	não
reaction_like	number	Número inteiro positivo ou null	Número de reações "gostei" (exclusivo Facebook)	não
reaction_love	number	Número inteiro positivo ou null	Número de reações "amei" (exclusivo Facebook)	não
reaction_pride	number	Número inteiro positivo ou null	Número de reações "orgulho" (exclusivo Facebook)	não
reaction_sad	number	Número inteiro positivo ou null	Número de reações "triste" (exclusivo Facebook)	não
reaction_thankful	number	Número inteiro positivo ou null	Número de reações "força" (exclusivo Facebook)	não
reaction_wow	number	Número inteiro positivo ou null	Número de reações "uau" (exclusivo Facebook)	não
reaction_total	number	Número inteiro positivo ou null	Número total de reações (exclusivo Facebook)	não
reactions	number	Número inteiro positivo ou null	Número de reações à publicação	não
receiver	Objeto	Remetente	Remetente da mensagem	sim
reclame_aqui	Objeto	{}	Dados usados pelo Reclame Aqui	não
replier	string	string ou null	Dados de quem respondeu a conversa	não
replier_name	string	string ou null	Nome de quem respondeu a conversa	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
root_id	string	string ou null	ID do post principal, a publicação root	não
sac_call_id	string	string ou null	ID interno Stilingue da interação principal da conversa	não
sac_type	string	string ou null	Tipo da conversa. Os valores possíveis são: posts, comentarios, inbox, postvisitantes, comentariosvisitantes, reviews, comentariosreview, mentions, comentariosmentions	não
same_text	number	Número inteiro	Quantidade de posts que possuem o mesmo texto que o post atual	não
same_text_posts	List<string>	Lista de strings	Lista de identificadores de posts que possuem o mesmo texto que o post atual	não
same_user_posts	List<string>	Lista de strings	Lista de identificadores de posts que foram feitos pelo mesmo usuário que o post atual	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	Pendente	Status da conversa. Os valores possíveis são: `Ignorado, Pendente, Aberto, Em Espera, Respondido, Fechado`	sim
tags	List<string>	["Não respondido"]	Lista de tags da conversa	sim
talk_id	string	string ou null	ID da conversa	não
text	string		Conteúdo de texto do post	sim
text_append	string	string ou null	Informação adicional do post ou sobre a interação. Exemplo de caso de comentário do YouTube: "Comentado em: Nome do video X";	não
text_header	string		Texto de cabeçalho do post	não
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
to	string	string ou null	Destinatário da mensagem (inbox)	não
type	string		Tipo da publicação. Os valores possíveis são: `video, image, carrossel (exclusivo Instagram), post`	não
uid	string	"57062551623"	ID do usuário/autor do post	sim
update_time_ago	string	"2 meses atrás	Indica há quanto tempo o post foi editado.	sim
url_content	string	URL ou null	Armazena a URL direta do video associado ao post. *Disponível quando type é `video`	não
user_image_url	string	URL ou null	URL da foto de perfil da conta	não
user_url	string	string ou null	URL da conta que fez o post	não
username	string	string ou null	Nome do autor do 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

Page info proprietário

Campo	Tipo	O que retorna	Descrição	Obrigatório
name	string		nome da página	sim
profile_pic	string	URL	URL da imagem do perfil. Necessário fazer decode de caracteres	sim

Anexo proprietário

Campo	Tipo	O que retorna	Descrição	Obrigatório
attachment_type	string	post	Tipo do anexo	Sim
futureStorageUrl	object	{}	Ele representa uma operação assíncrona que, quando concluída, fornecerá uma URL de armazenamento como uma string.	Não
id	string	3496992623145473920_57062551623	ID do anexo	Sim
media_type	string	IMAGE	Tipo de mídia anexada na publicação	Sim
storage_url	string	https://scontent-atl3-3.cdninstagram.com/v/t51.29350-15/465985527_431124599790799_2459034636778829527_n.heic	URL da mídia anexada na Storage	Sim
successfulFromStorage	boolean	true	Valida se a URL da imagem foi obtida	Sim
type	string	image/jpeg	Tipo do arquivo anexado	Sim
url	string	https://scontent-atl3-3.cdninstagram.com/v/t51.29350-15/465985527_431124599790799_2459034636778829527_n.heic	URL da mídia anexada	Sim

Resposta a comentários

Campo	Tipo	O que retorna	Descrição	Obrigatório
answered	number	3	Número de comentários respondidos pela página	Sim
total	number	25	Número de comentários com resposta	Sim

Sentimento comentário

Campo	Tipo	O que retorna	Descrição	Obrigatório
negative	number	10.344827586206897	Porcentagem de comentários negativos	Sim
neutral	number	62.06896551724138	Porcentagem de comentários neutros	Sim
positive	number	27.586206896551722	Porcentagem de comentários positivos	Sim

Remetente

Campo	Tipo	O que retorna	Descrição	Obrigatório
email	string	null	Email do remetente de inbox	Não
id	string	null	ID do remetente de inbox	Não
image_url	string	null	URL da imagem do remetente de inbox	Não
name	string	null	Nome do remetente de inbox	Não

Corpo da resposta em json

{
    "limit": 1,
    "next_offset": 2,
    "offset": 1,
    "page_info": {
            "name": "FolksSti",
            "profile_pic": "https%3A%2F%2Fscontent-gru1-1.xx.fbcdn.net%2Fv%2Ft39.30808-1%2F323774423_3471397176470615_6134550035869976545_n.jpg%3Fstp%3Dc1.0.50.50a_cp0_dst-jpg_p50x50%26_nc_cat%3D104%26ccb%3D1-7%26_nc_sid%3D5fac6f%26_nc_eui2%3DAeHbSHcGwjWFaImUHvqfyt6BFhImDSuskdgWEiYNK6yR2HvrloLepn-NDZiQg91vOERnzhdUlrf8V2HOKGjv56rR%26_nc_ohc%3DU3aO1A6bwPwAX-4a9wJ%26_nc_ht%3Dscontent-gru1-1.xx%26edm%3DAJdBtusEAAAA%26oh%3D00_AfDRnPA85AkpyrerNzONlcFzF15LIEHZYfOjXdJZJheKBQ%26oe%3D6525D85A"
        },
    "posts": [
            {
                "AAA_score": 0.01,
                "anonymous_user": null,
                "attachments": [
                    {
                        "attachment_type": "post",
                        "futureStorageUrl": {},
                        "id": "3496992623145473920_57062551623",
                        "media_type": "IMAGE",
                        "storage_url": "https://scontent-atl3-3.cdninstagram.com/v/t51.29350-15/465985527_431124599790799_2459034636778829527_n.heic?stp=dst-jpg_tt6&_nc_cat=109&ccb=1-7&_nc_sid=18de74&_nc_ohc=TM2CszYoOtIQ7kNvgGj1COt&_nc_zt=23&_nc_ht=scontent-atl3-3.cdninstagram.com&edm=AEQ6tj4EAAAA&_nc_gid=AuYkHBUG0xVXrCPtSd8TzDV&oh=00_AYA1YBbPTPvCaQ32l1aOFKfL_fMjibXRvsmYJkaPXayamQ&oe=675BA5EA",
                        "successfulFromStorage": true,
                        "type": "image/jpeg",
                        "url": "https://scontent-atl3-3.cdninstagram.com/v/t51.29350-15/465985527_431124599790799_2459034636778829527_n.heic?stp=dst-jpg_tt6&_nc_cat=109&ccb=1-7&_nc_sid=18de74&_nc_ohc=TM2CszYoOtIQ7kNvgGj1COt&_nc_zt=23&_nc_ht=scontent-atl3-3.cdninstagram.com&edm=AEQ6tj4EAAAA&_nc_gid=AuYkHBUG0xVXrCPtSd8TzDV&oh=00_AYA1YBbPTPvCaQ32l1aOFKfL_fMjibXRvsmYJkaPXayamQ&oe=675BA5EA"
                    }
                ],
                "channel": "Instagram",
                "comments": 7,
                "comments_answers": {
                        "answered": 3,
                        "total": 25
                    },
                "comments_polarities": {
                        "negative": 10.344827586206897,
                        "neutral": 62.06896551724138,
                        "positive": 27.586206896551722
                    },
                "contact_reasons": [],
                "crawled_at": "08/11/2024 19:32",
                "critical_level": 0,
                "cvtags": [],
                "dislikes": 0,
                "emotion": "",
                "favorite": false,
                "fb_impressions": 14,
                "fb_pid": "18049890541950243",
                "fb_reach": 11,
                "fb_uid": "17841457108652818",
                "features": ["FEED"],
                "followers": 21,
                "gender": "",
                "groups": [],
                "hashtags": ["#testeblipsti2024"],
                "hidden_by_user": false,
                "hot": 2453.984362509439,
                "hot_post": false,
                "ig_pid": "3496992623145473920",
                "image_url": "https://scontent-atl3-3.cdninstagram.com/v/t51.29350-15/465985527_431124599790799_2459034636778829527_n.heic?stp=dst-jpg_tt6&_nc_cat=109&ccb=1-7&_nc_sid=18de74&_nc_ohc=TM2CszYoOtIQ7kNvgGj1COt&_nc_zt=23&_nc_ht=scontent-atl3-3.cdninstagram.com&edm=AEQ6tj4EAAAA&_nc_gid=AuYkHBUG0xVXrCPtSd8TzDV&oh=00_AYA1YBbPTPvCaQ32l1aOFKfL_fMjibXRvsmYJkaPXayamQ&oe=675BA5EA",
                "integration_name": null,
                "interacted_page_id": null,
                "interacted_page_name": null,
                "interactions": 9,
                "interests": [],
                "is_dynamic_post": false,
                "is_hidden": null,
                "is_root": false,
                "kpi_engagement": 9,
                "kpi_saved": 0,
                "lang": "other",
                "likes": 2,
                "location": "",
                "long_posted_at": 1731094027000,
                "long_updated_at": 1734120168483,
                "machine_learning": null,
                "mentions": [],
                "metrics_updated_at": "08/12/2024 16:27",
                "name": "folks.sti",
                "operator_id": null,
                "operator_name": null,
                "page_comment": true,
                "page_id": "57062551623",
                "pages": ["57062551623"],
                "pid": "3496992623145473920_57062551623",
                "post_id": "3496992623145473920_57062551623",
                "post_url": "https://www.instagram.com/p/DCH0ENMv1eA/",
                "post_user_image_url": "https://scontent-cdg4-2.xx.fbcdn.net/v/t51.2885-15/322037340_484126733794866_6808773236313896962_n.jpg?_nc_cat=109&ccb=1-7&_nc_sid=7d201b&_nc_ohc=W2YMqTuOd2oQ7kNvgF0MZzy&_nc_zt=23&_nc_ht=scontent-cdg4-2.xx&edm=AM6HXa8EAAAA&oh=00_AYDF4NnuMR20QiJ6b8_QJRgNyOJ1R_GZJzt2Xd7l26PN1Q&oe=6783514D",
                "posted_at": "08/11/2024 16:27",
                "primary_channel": "Instagram",
                "raw_posted_at": {
                        "$date": "2024-11-08T19:27:07Z"
                    },
                "reaction_angry": null,
                "reaction_haha": null,
                "reaction_like": 2,
                "reaction_love": null,
                "reaction_pride": null,
                "reaction_sad": null,
                "reaction_thankful": null,
                "reaction_total": 2,
                "reaction_wow": null,
                "reactions": 2,
                "receiver": {
                        "email": null,
                        "id": null,
                        "image_url": null,
                        "name": null
                    },
                "reclame_aqui": null,
                "replier": null,
                "replier_name": null,
                "reply_pid": "3496992623145473920_57062551623",
                "root_id": "3496992623145473920_57062551623",
                "sac_call_id": "3496992623145473920_57062551623",
                "sac_type": "Post",
                "same_text": null,
                "same_text_posts": null,
                "same_user_posts": null,
                "sentiment": 3,
                "shares": 0,
                "spam": false,
                "status": "Pendente",
                "tags": ["não respondido Agent"],
                "talk_id": null,
                "text": "#testeblipsti2024",
                "text_append": null,
                "text_header": null,
                "themes": [],
                "title": "",
                "to": null,
                "type": "image",
                "uid": "57062551623",
                "update_time_ago": "2 meses atrás",
                "url_content": null,
                "user_image_url": "",
                "user_url": "https://instagram.com/folks.sti",
                "username": "folks.sti",
                "verified": false,
                "videoplays": 0
            },
        ],
    "total_posts": 5,
    "total_posts_filtered": 5
}

Get pages

Este endpoint traz informações de todas as páginas proprietárias conectadas ao Warroom.

curl --location 'https://api.stilingue.com.br/pages/getpages/{api-token}'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
api-token	number	123456	Token de autenticação necessário para acessar os dados	Sim

Response

Campo	Tipo	Descrição
message	List<Page>	Lista contendo dados das páginas proprietárias conectadas
status	string	Status do tipo de dado coletado

Page

Campo	Tipo	Descrição
channel	string	Nome da rede social
id	string	ID daquela página conectada
username	string	Nome de usuário naquela rede social

Corpo da resposta em json

{
  "message": [
    {
      "channel": "TikTok",
      "id": "XXXXXXXX",
      "username": "minhaPaginaTiktok"
    },
    {
      "channel": "Facebook",
      "id": "XXXXXXXX",
      "username": "minhaPaginaFacebook"
    }
  ],
  "status": "DATA"
}

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.

Warroom - Alcance no tempo

Request

curl --location 'https://api.stilingue.com.br/metricaspro/instagram/alcancetempo/{api-token}/{page_id}'

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. 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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	Não

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Informa se os dados estão vindo de um cache
results	List<Type>	Lista contendo objeto com uma determinada métrica com dias e respectivos valores daquele dia.

Type

Campo	Tipo	Descrição
name	string	Nome da métrica
carousels	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à visualização de carrossel
dark_posts	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à dark posts (ads)
posts	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à visualização de posts
reels	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à visualização de reels
stories	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à visualização de stories

Data

Campo	Tipo	Descrição
date	Date(aaaa/MM/dd)	Data da respectiva métrica
value	number	Quantidade total da respectiva métrica no referente dia

Corpo da resposta em json

{
  "from_cache": false,
  "results": [
    {
      "carousels": [
        {
          "date": "2025/03/06",
          "value": 522
        },
        {
          "date": "2025/03/07",
          "value": 855
        }
      ],
      "dark_posts": [
        {
          "date": "2025/03/06",
          "value": 44
        },
        {
          "date": "2025/03/07",
          "value": 885
        }
      ],
      "name": "reaches",
      "posts": [
        {
          "date": "2025/03/06",
          "value": 4666
        },
        {
          "date": "2025/03/07",
          "value": 9988
        }
      ],
      "reels": [
        {
          "date": "2025/03/06",
          "value": 40572
        },
        {
          "date": "2025/03/07",
          "value": 8855
        }
      ],
      "stories": [
        {
          "date": "2025/03/06",
          "value": 666
        },
        {
          "date": "2025/03/07",
          "value": 899
        }
      ]
    }
  ]
}

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.

Comentários do Linkedin

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/metricaspro/linkedin/comentarios/{token}/{page_id}?date_range=2d' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	123456	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.	Não

Corpo da resposta

Campo	Tipo	Descrição
access_token	string	Token de acesso para autenticação.
from_cache	boolean	Indica se os dados vieram do cache.
limit	number	Quantidade máxima de posts retornados.
next_offset	number	Próximo deslocamento para paginação.
offset	number	Deslocamento atual dos dados.
page_info	Page Info	Informações sobre a página do usuário.
total_posts	number	Total de posts (publicações).

Objeto Page Info

Campo	Tipo	Descrição
name	string	Nome da página.
profile_pic	string	URL da foto do perfil.

Objeto Post

Campo	Tipo	Descrição
_id	string	Identificador único do post.
answered	boolean	Indica se o post foi respondido.
channel	string	Canal onde o post foi publicado.
children	list<Comments>	Lista com informações do comentário.

Objeto Comment

Campo	Tipo	Descrição
_id	string	Identificador único do comentário.
channel	string	Canal onde o comentário foi postado.
comments	number	Quantidade de comentários.
followers	number	Número de seguidores do usuário.
hot	number	Popularidade do post.
lang	string	Idioma do comentário.
likes	number	Número de curtidas no comentário.
posted_at	string	Data e hora em que o comentário foi postado.
post_url	string	URL do post original.
post_user_image_url	string	URL da imagem do usuário do post.
status	string	Status do comentário.
text	string	Conteúdo do comentário.
update_time_ago	string	Indica há quanto tempo o post foi editado.
user_comments	number	Quantidade de comentários feitos pelo usuário.
user_image_url	string	URL da imagem do usuário.
user_url	string	Perfil do usuário no LinkedIn.

Corpo da resposta em json

{
  "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
}

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

Request

curl --location 'https://api.stilingue.com.br/metricaspro/facebook/compararfanpages/{api-token}/{page-id}?fanpages={page-id-1}%3A{page-id-2}'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
fanpages	string	Pageid1:PageId2	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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	Não

Corpo da resposta

Campo	Tipo	Descrição
comparative_response	Comparative	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'
fans_data	Fans	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'
interactions	Interaction	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.
posts_data	Interaction	Mesmas informações do campo interactions, considere utilizar o campo interactions ao invés desse.

Comparative

Campo	Tipo	Descrição
results	List<Metrics>	Uma lista de métricas, onde cada objeto dessa lista representa uma página do Facebook

Metrics

Campo	Tipo	Descrição
fan_increment_rate	Score	Taxa de incremento de fãs é a porcentagem de fãs que cresceram em relação ao último mês
fans	Score	Quantidade total de fãs da página
interaction_rate	Score	Taxa de interação, calculada pela fórmula: (total de interações / quantidade de publicações) X (1 / número de fãs).
interaction_rate_weighted	Score	Taxa de interação ponderada, calculada pela fórmula: (compartilhamentos x 2 + comentários x 1,5 + curtidas) / número de publicações / número de fãs.
name	string	Nome da página do Facebook
posts_amount	Score	Quantidade total de posts públicos no período informado, não inclui dark posts
response_rate	Score	Taxa de resposta é a porcentagem de respostas das questões dos usuários postadas na página (não inclui comentários)
total_interactions	Score	Total de interações é: quantidade de likes + comentários + compartilhamentos.

Score

Campo	Tipo	Descrição
aceleration	number	Taxa de aceleração usada para cálculo
value	number	Quantidade que o valor representa resultante do cálculo final
value_normalized	number	Valor utilizado para cálculo

Fans

Campo	Tipo	Descrição
results	List<Info>	Uma lista de métricas, onde cada objeto dessa lista representa uma página do Facebook

Info

Campo	Tipo	Descrição
data	List<Data>	Uma lista de objetos, onde cada objeto representa um dia do mês junto com seu respectivo total daquele dia.
name	string	Nome da página no Facebook

Data

Campo	Tipo	Descrição
date	string	Uma data de um dia do mês para representar um determinado período. No formato: aaaa/MM/dd
value	number	Valor total da métrica para um determinado dia

Interaction

Campo	Tipo	Descrição
results	List<Amount>	Uma lista de métricas, onde cada objeto dessa lista representa uma página do Facebook

Amount

Campo	Tipo	Descrição
amount_interactions	List<Data>	Uma lista de objetos, onde cada objeto representa um dia do mês junto com seu respectivo total daquele dia.
amount_posts	List<Data>	Uma lista de objetos, onde cada objeto representa um dia do mês junto com seu respectivo total daquele dia.
name	string	Nome da página no Facebook

Corpo da resposta em json

{
  "comparative_response": {
    "results": [
      {
        "fan_increment_rate": {
          "aceleration": 0,
          "value": 0.0,
          "value_normalized": 0
        },
        "fans": {
          "aceleration": 0,
          "value": 3,
          "value_normalized": 0
        },
        "interaction_rate": {
          "aceleration": 0,
          "value": 0.6666666666666666,
          "value_normalized": 100
        },
        "interaction_rate_weighted": {
          "aceleration": 0,
          "value": 0.5,
          "value_normalized": 100
        },
        "name": "Capivaria Mística",
        "posts_amount": {
          "aceleration": 0,
          "value": 1,
          "value_normalized": 0
        },
        "response_rate": {
          "aceleration": 0,
          "value": 100.0,
          "value_normalized": 100
        },
        "total_interactions": {
          "aceleration": 0,
          "value": 2,
          "value_normalized": 100
        }
      }
    ]
  },
  "fans_data": {
    "results": [
      {
        "data": [
          {
            "date": "2024/01/01",
            "value": 100
          },
          {
            "date": "2024/01/02",
            "value": 45
          }
        ],
        "name": "Capivaria Mística"
      }
    ]
  },
  "interactions": {
    "results": [
      {
        "amount_interactions": [
          {
            "date": "2024/01/01",
            "value": 0
          },
          {
            "date": "2024/01/02",
            "value": 0
          }
        ],
        "amount_posts": [
          {
            "date": "2024/01/01",
            "value": 22
          },
          {
            "date": "2024/01/02",
            "value": 233
          }
        ],
        "name": "Capivaria Mística"
      }
    ]
  },
  "posts_data": {
    "results": [
      {
        "amount_interactions": [
          {
            "date": "2024/01/01",
            "value": 0
          },
          {
            "date": "2024/01/02",
            "value": 0
          }
        ],
        "name": "Capivaria Mística"
      }
    ]
  },
  "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
    }
  }
}

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.

Warroom - Evolução da Base de Fãs

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/{channel}/fanbase/{token}/{page_id}?date_range=2d' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	123456	Token de autenticação necessário para acessar os dados	Sim
channels	string	Twitter:Instagram:Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: twitter, instagram, instagramComments, facebook, facebookComments, youTube, youTubeComments, News, blogs, linkedin	Não
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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	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
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
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	Esse campo traz dados do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	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: date_desc, date_asc, hot, interactions, likes, shares, comments, followers, influence	Não
removed	boolean	false	Retorna apenas publicações apagadas (o padrão é false)	Não

Corpo da resposta

Campo	Tipo	Descrição
results	List<Evolutions>	Lista de métricas coletadas durante o período analisado.
request_parameters	Parâmetros de Requisição	Detalhes sobre a requisição feita para obter os dados.

Evolutions

Campo	Tipo	Descrição
name	string	Label para índice da evolução.
data	List<Counter>	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
}

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.

Impressões e Publicações do Instagram

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/metricaspro/instagram/imprecoestempo/{token}/{page_id}?date_range=2d' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	123456	Token de autenticação necessário para acessar os dados	Sim
channels	string	Instagram	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: twitter, instagram, instagramComments, facebook, facebookComments, youTube, youTubeComments, News, blogs, linkedin	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

Corpo da resposta

Campo	Tipo	Descrição
name	string	Nome da métrica coletada.
carousels	List<Counter>	Quantidade de impressões em carrosséis.
dark_posts	List<Counter>	Quantidade de impressões em dark posts.
posts	List<Counter>	Quantidade de impressões em posts.
reels	List<Counter>	Quantidade de impressões em reels.
stories	List<Counter>	Quantidade de impressões em stories.

Objeto Counter

Campo	Tipo	Descrição
date	Date	Data da métrica registrada.
value	number	Quantidade registrada na data correspondente.

Corpo da resposta em json

{
  "from_cache": false,
  "results": [
    {
      "carousels": [
        {
          "date": "2025/02/03",
          "value": 5481
        },
        {
          "date": "2025/02/04",
          "value": 8460
        }
      ],
      "dark_posts": [
        {
          "date": "2025/02/03",
          "value": 0
        }
      ],
      "name": "impressions",
      "posts": [
        {
          "date": "2025/02/03",
          "value": 0
        },
        {
          "date": "2025/02/04",
          "value": 0
        }
      ],
      "reels": [
        {
          "date": "2025/02/03",
          "value": 0
        },
        {
          "date": "2025/02/04",
          "value": 0
        }
      ],
      "stories": [
        {
          "date": "2025/02/03",
          "value": 0
        },
        {
          "date": "2025/02/04",
          "value": 12878
        }
      ]
    }
  ]
}

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.

Warroom - Impressões orgânicas

Request

curl --location 'https://api.stilingue.com.br/metricaspro/facebook/impressoesorganicas/{api-token}/{page-id}'

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. 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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	Não

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Informa se os dados estão vindo de um cache
results	List	Lista contendo objeto com sua respectiva métrica e data de análise

Result

Campo	Tipo	Descrição
data	List	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"
    }
  ]
}

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.

Warroom - Impressões pagas

Request

curl --location 'https://api.stilingue.com.br/metricaspro/facebook/impressoespagas/{api-token}/{page-id}'

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. 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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	Não

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Informa se os dados estão vindo de um cache
results	List	Lista contendo objeto com sua respectiva métrica e data de análise

Result

Campo	Tipo	Descrição
data	List	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"
    }
  ]
}

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
Para saber mais, clique aqui

Request

 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.	Não

Corpo da resposta

Campo	Tipo	O que retorna	Descrição	Obrigatório
from_cache	boolean	true	Se o resultado foi obtido do cache	sim
results	List<Interaction data>	Lista	Lista de dados	sim

Interaction data

Campo	Tipo	O que retorna	Descrição	Obrigatório
carousels	List<Chart value>	[]	Lista de dados de interações para carrosséis por dia.	Sim
posts	List<Chart value>	[]	Lista de dados de interações para posts por dia.	Sim
reels	List<Chart value>	[]	Lista de dados de interações para reels por dia.	Sim
stories	List<Chart value>	[]	Lista de dados de interações para stories por dia.	Sim
dark_posts	List<Chart value>	[]	Lista de dados de interações para dark posts por dia.	Sim
name	string	exits, replies, taps_forward, taps_back	Tipo da interação. Os valores possíveis são: `exits` (Ações de sair) `replies` (Respostas) `taps_forward` (Ações de avançar) `taps_back` (Ações de voltar)	Sim

Chart value

Campo	Tipo	O que retorna	Descrição	Obrigatório
date	string	2025/02/05	Data referente ao dado retornado	sim
value	number	10	Total de interações	sim

Corpo da resposta em json

{
  "from_cache": false,
  "results": [
    {
      "carousels": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "dark_posts": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "name": "exits",
      "posts": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "reels": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "stories": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ]
    },
    {
      "carousels": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "dark_posts": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "name": "taps_forward",
      "posts": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "reels": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "stories": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ]
    },
    {
      "carousels": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "dark_posts": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "name": "taps_back",
      "posts": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "reels": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "stories": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ]
    },
    {
      "carousels": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "dark_posts": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "name": "replies",
      "posts": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "reels": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ],
      "stories": [
        {
          "date": "2025/02/27",
          "value": 0
        }
      ]
    }
  ]
}

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}' \
      -d date_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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. 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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	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
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: posts, comentarios, inbox, postvisitantes, comentariosvisitantes, reviews, comentariosreview, mentions, comentariosmentions Atenção: se o parâmetro filters for referente à um "Filtro de conversa", esse parâmetro se torna obrigatório!	Leia a descrição

Corpo da resposta

Campo	Tipo	O que retorna	Descrição	Obrigatório
from_cache	boolean	true	Se o resultado foi obtido do cache	sim
results	List< interaction_data >	Lista	Lista de dados de diferentes interações como Reações, Comentários e Compartilhamentos	sim
video_views	page_info	Lista de posts. Pode ser vazia	Lista de posts	sim

interaction_data

Campo	Tipo	O que retorna	Descrição	Obrigatório
data	List<chart_value>	Lista	Lista de dados de interações por dia	sim
name	string	-	Tipo da interação. Pode ser `Reações, Comentários ou Compartilhamentos`	sim

Chart value

Campo	Tipo	O que retorna	Descrição	Obrigatório
date	string	2025/02/05	Data referente ao dado retornado	sim
value	number	10	Total de interações	sim

video_views

Campo	Tipo	O que retorna	Descrição	Obrigatório
avg_time_watched	number	{ value: number }	Tempo médio de visualização.	sim
avg_time_watched_perc	number	{ value: number }	Variação do tempo médio de visualização em percentagem.	sim
total_videos	number	{ value: number }	Total de vídeos publicados.	sim
total_videos_perc	number	{ value: number }	Variação do total de vídeos publicados em percentagem.	sim
unique_video_views	number	{ value: number }	Visualizações únicas do vídeo.	sim
unique_video_views_perc	number	{ value: number }	Variação de visualizações únicas do vídeo em percentagem.	sim
views	number	{ value: number }	Total de visualizações.	sim
views_perc	number	{ value: number }	Variação do total de visualizações em percentagem.	sim

Corpo da resposta em json

{
  "from_cache": true,
  "results": [
    {
      "data": [
        {
          "date": "2024/02/12",
          "value": 0
        }
      ],
      "name": "Reações"
    },
    {
      "data": [
        {
          "date": "2024/02/12",
          "value": 0
        }
      ],
      "name": "Comentários"
    },
    {
      "data": [
        {
          "date": "2024/02/12",
          "value": 0
        }
      ],
      "name": "Compartilhamentos"
    }
  ],
  "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
    }
  }
}

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.

Campanha page likes - resultados

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/metricaspro/facebook/pagelikes/{token}/{page_id}?date_range=2d' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	123456	Token de autenticação necessário para acessar os dados	Sim
channels	string	Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: twitter, instagram, instagramComments, facebook, facebookComments, youTube, youTubeComments, News, blogs, linkedin	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

Corpo da resposta

Campo	Tipo	Descrição
results	List<Evolutions>	Lista de métricas coletadas durante o período analisado.
from_cache	boolean	Indica se os dados foram obtidos do cache.

Objeto Evolutions

Campo	Tipo	Descrição
name	string	Nome da métrica.
data	List<Counter> \| Object	Dados da métrica, podendo ser uma lista de valores diários ou um valor médio.

Objeto Counter

Campo	Tipo	Descrição
date	Date	Data de ingresso do novo seguidor.
value	number	Quantidade de novos seguidores adquiridos.

Corpo da resposta em json

{
  "from_cache": false,
  "results": [
    {
      "data": [
        {
          "date": "2025/02/03",
          "value": 0
        },
        {
          "date": "2025/02/04",
          "value": 0
        }
      ],
      "name": "Novos Fãs (Pagos)"
    },
    {
      "data": {
        "value": 0
      },
      "name": "Média Novos Fãs (Pagos)"
    },
    {
      "data": [
        {
          "date": "2025/02/03",
          "value": 0
        },
        {
          "date": "2025/02/04",
          "value": 2
        }
      ],
      "name": "Novos Fãs (Orgânicos)"
    },
    {
      "data": {
        "value": 1.1612903225806452
      },
      "name": "Média Novos Fãs (Orgânicos)"
    },
    {
      "data": {
        "value": 1.1612903225806452
      },
      "name": "Média Novos Fãs"
    }
  ]
}

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.

Warroom - Posts pagos e orgânicos

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/facebook/organicosxpagos/{token}/{page_id}?date_range=2d' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	123456	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

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Indica se os dados foram carregados do cache.
results	List	Lista de métricas coletadas durante o período analisado.
video_views	VideoViews	Dados relacionados às visualizações de vídeo.

Objeto Result

Campo	Tipo	Descrição
name	string	Nome da métrica coletada.
data	List	Lista contendo os valores da métrica ao longo do tempo.

Objeto Date

Campo	Tipo	Descrição
date	string	Data correspondente ao valor da métrica (Formato: YYYY/MM/DD).
value	number	Valor da métrica para a data especificada.

Objeto VideoViews

Campo	Tipo	Descrição
avg_time_watched	number	Tempo médio assistido em segundos.
avg_time_watched_perc	number	Porcentagem média do vídeo assistida.
total_videos	number	Total de vídeos analisados.
total_videos_perc	number	Porcentagem de vídeos assistidos em relação ao total disponível.
unique_video_views	number	Quantidade de visualizações únicas de vídeo.
unique_video_views_perc	number	Porcentagem de visualizações únicas em relação ao total de visualizações.
views	number	Total de visualizações de vídeo.
views_perc	number	Porcentagem de visualizações em relação ao total disponível.

Corpo da resposta em json

{
  "from_cache": false,
  "results": [
    {
      "data": [
        {
          "date": "2023/11/01",
          "value": 959
        },
        {
          "date": "2023/11/02",
          "value": 0
        },
        {
          "date": "2023/11/03",
          "value": 0
        },
        {
          "date": "2023/11/04",
          "value": 0
        },
        {
          "date": "2023/11/05",
          "value": 0
        },
        {
          "date": "2023/11/06",
          "value": 0
        },
        {
          "date": "2023/11/07",
          "value": 0
        },
        {
          "date": "2023/11/08",
          "value": 0
        },
        {
          "date": "2023/11/09",
          "value": 0
        },
        {
          "date": "2023/11/10",
          "value": 0
        },
        {
          "date": "2023/11/11",
          "value": 0
        },
        {
          "date": "2023/11/12",
          "value": 0
        },
        {
          "date": "2023/11/13",
          "value": 0
        },
        {
          "date": "2023/11/14",
          "value": 0
        },
        {
          "date": "2023/11/15",
          "value": 0
        },
        {
          "date": "2023/11/16",
          "value": 0
        },
        {
          "date": "2023/11/17",
          "value": 0
        },
        {
          "date": "2023/11/18",
          "value": 0
        },
        {
          "date": "2023/11/19",
          "value": 0
        },
        {
          "date": "2023/11/20",
          "value": 0
        },
        {
          "date": "2023/11/21",
          "value": 0
        },
        {
          "date": "2023/11/22",
          "value": 3897
        },
        {
          "date": "2023/11/23",
          "value": 560
        },
        {
          "date": "2023/11/24",
          "value": 0
        },
        {
          "date": "2023/11/25",
          "value": 0
        },
        {
          "date": "2023/11/26",
          "value": 0
        },
        {
          "date": "2023/11/27",
          "value": 60
        },
        {
          "date": "2023/11/28",
          "value": 0
        },
        {
          "date": "2023/11/29",
          "value": 0
        },
        {
          "date": "2023/11/30",
          "value": 47
        }
      ],
      "name": "Impressões orgânicas"
    },
    {
      "data": [
        {
          "date": "2023/11/01",
          "value": 16503943
        },
        {
          "date": "2023/11/02",
          "value": 0
        },
        {
          "date": "2023/11/03",
          "value": 0
        },
        {
          "date": "2023/11/04",
          "value": 0
        },
        {
          "date": "2023/11/05",
          "value": 0
        },
        {
          "date": "2023/11/06",
          "value": 0
        },
        {
          "date": "2023/11/07",
          "value": 0
        },
        {
          "date": "2023/11/08",
          "value": 0
        },
        {
          "date": "2023/11/09",
          "value": 0
        },
        {
          "date": "2023/11/10",
          "value": 0
        },
        {
          "date": "2023/11/11",
          "value": 0
        },
        {
          "date": "2023/11/12",
          "value": 0
        },
        {
          "date": "2023/11/13",
          "value": 0
        },
        {
          "date": "2023/11/14",
          "value": 0
        },
        {
          "date": "2023/11/15",
          "value": 0
        },
        {
          "date": "2023/11/16",
          "value": 0
        },
        {
          "date": "2023/11/17",
          "value": 0
        },
        {
          "date": "2023/11/18",
          "value": 0
        },
        {
          "date": "2023/11/19",
          "value": 0
        },
        {
          "date": "2023/11/20",
          "value": 0
        },
        {
          "date": "2023/11/21",
          "value": 0
        },
        {
          "date": "2023/11/22",
          "value": 0
        },
        {
          "date": "2023/11/23",
          "value": 0
        },
        {
          "date": "2023/11/24",
          "value": 0
        },
        {
          "date": "2023/11/25",
          "value": 0
        },
        {
          "date": "2023/11/26",
          "value": 0
        },
        {
          "date": "2023/11/27",
          "value": 6493023
        },
        {
          "date": "2023/11/28",
          "value": 0
        },
        {
          "date": "2023/11/29",
          "value": 0
        },
        {
          "date": "2023/11/30",
          "value": 4207939
        }
      ],
      "name": "Impressões pagas"
    }
  ],
  "video_views": {
    "avg_time_watched": {
      "value": 137627
    },
    "avg_time_watched_perc": {
      "value": 0
    },
    "total_videos": {
      "value": 34
    },
    "total_videos_perc": {
      "value": 0
    },
    "unique_video_views": {
      "value": 2767839
    },
    "unique_video_views_perc": {
      "value": 0
    },
    "views": {
      "value": 4538649
    },
    "views_perc": {
      "value": 0
    }
  }
}

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.

Warroom - Publicações X Interações

Request

curl --location 'https://api.stilingue.com.br/metricaspro/{channel}/volumepubint/{api-token}/{page-id}?date_range=10d'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
channel	string	instagram	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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range e não é válido para o canal TikTok	Não

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Informa se os dados estão vindo de um cache
results	List<Result>	Lista contendo objeto com sua respectiva métrica e data de análise

Result

Campo	Tipo	Descrição
data	List<Data>	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/03/01",
          "value": 6588
        },
        {
          "date": "2025/03/02",
          "value": 4458
        }
      ],
      "name": "Interações"
    },
    {
      "data": [
        {
          "date": "2025/03/01",
          "value": 2
        },
        {
          "date": "2025/03/02",
          "value": 1
        }
      ],
      "name": "Publicações"
    }
  ]
}

TikTok

Para TikTok o retorno muda um pouco e para saber detalhes específicos, consulte aqui.

Corpo da resposta

Campo	Tipo	Descrição
axes	List<Axe>	Lista contendo o objeto contendo os dados de data da respectiva métrica.
points	List<Points>	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.
name	string	Nome da determinada métrica.

Corpo da resposta em json

{
  "axes": [
    {
      "label": "posted_at",
      "values": [1749351600000, 1749438000000, 1749524400000]
    }
  ],
  "points": [
    {
      "data": [0, 614, 144],
      "name": "engagement"
    },
    {
      "data": [0, 1, 5],
      "name": "posts"
    }
  ]
}

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.

Warroom - Taxa de interações

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/metricaspro/facebook/taxainteracoes/{token}/{page_id}?date_range=2d' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	123456	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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	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
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
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	Esse campo traz dados do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	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: date_desc, date_asc, hot, interactions, likes, shares, comments, followers, influence	Não
removed	boolean	false	Retorna apenas publicações apagadas (o padrão é false)	Não

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Indica se os dados foram obtidos do cache.
results	List	Lista de métricas coletadas durante o período analisado.
video_views	VideoViews	Métricas relacionadas às visualizações de vídeos.

Objeto Evolutions

Campo	Tipo	Descrição
name	string	Nome da métrica coletada.
data	List	Lista de valores associados à métrica.

Objeto Counter

Campo	Tipo	Descrição
date	Date	Data associada à métrica.
value	number	Valor da métrica para a data correspondente.

Objeto VideoViews

Campo	Tipo	Descrição
avg_time_watched	number	Tempo médio assistido (em segundos).
avg_time_watched_perc	number	Variação percentual do tempo médio assistido.
total_videos	number	Total de vídeos analisados.
total_videos_perc	number	Variação percentual do total de vídeos.
unique_video_views	number	Total de visualizações únicas de vídeos.
unique_video_views_perc	number	Variação percentual das visualizações únicas.
views	number	Total de visualizações de vídeos.
views_perc	number	Variação percentual do total de visualizações.

Corpo da resposta em json

{
  "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
    }
  }
}

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.

Warroom - Alcance x Índice de engajamento

Request

curl --location 'https://api.stilingue.com.br/metricaspro/facebook/reach/{api-token}/{page-id}'

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. 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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	Não

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Informa se os dados estão vindo de um cache
results	List<Result>	Lista contendo objeto com sua respectiva métrica e data de análise

Result

Campo	Tipo	Descrição
data	List<Data>	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"
    }
  ]
}

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.

Warroom - Publicações ativadas

Request

curl --location 'https://api.stilingue.com.br/metricaspro/facebook/viewclickctr/{api-token}/{page-id}'

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. 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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	Não

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Informa se os dados estão vindo de um cache
results	List<Result>	Lista contendo objeto com sua respectiva métrica e data de análise

Result

Campo	Tipo	Descrição
data	List<Data>	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": "Impressões"
    },
    {
      "data": [
        {
          "date": "2025/02/18",
          "value": 0
        }
      ],
      "name": "Cliques"
    },
    {
      "data": [
        {
          "date": "2025/02/18",
          "value": 0.0
        }
      ],
      "name": "CTR"
    }
  ]
}

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.

Warroom Visão Geral de Métricas proprietárias

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/metricaspro/{channel}/visaogeral/{api-token}/{page-id}?date_range=2d' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	6209835379982336	Token da API	sim
channel	string	facebook, instagram, linkedin, youtube, twitter, tiktok	Nome da rede social que deseja buscar os dados	sim
page_id	string	803233102378188801	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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	não

Facebook

Corpo da resposta

Campo	Tipo	Descrição
digital_score	Pontuação Digital	Objeto que contém detalhes sobre a pontuação digital encontrada no Warroom.
engagement	Engajamento	Objeto que contém detalhes sobre o engajamento da página.
followers	Seguidores	Contém detalhes sobre os seguidores da página conectada.
impressions	Impressões	Contém detalhes sobre as impressões da página conectada.
interactions	Interações	Interações realizadas nas publicações.
posts	Posts	Contém dados sobre a quantidade de publicações.
reach	Alcance	Contém dados sobre o alcance das publicações
video_views	Visualizações de vídeos	Contém dados sobre os videos da página conectada.

Objeto Geral

Campo	Tipo	Descrição
details	number	Contém o valor utilizado para demonstrar a variação do resultado em relação ao período anterior.
name	string	Nome do campo que poderá ser encontrado na tela do Warroom.
type	string	Pode conter valores de up, down e stand, indicando se a variação do valor aumentou, diminuiu ou manteve.
value	number	Contém o valor referente ao campo.

Pontuação Digital

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
organic	Objeto Geral	Contém os dados de pontuação digital para publicações orgânicas
paid	Objeto Geral	Contém os dados de pontuação digital para publicações pagas

Engajamento

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
rate	Objeto Geral	Contém os dados para o Índice de Engajamento
paid	Objeto Geral	Contém os dados para os Usuários Engajados

Seguidores

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
total	Objeto Geral	Contém os dados para o Total de Seguidores

Impressões

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
total	Objeto Geral	Contém os dados para o as impressões das publicações

Interações

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
comments	Objeto Geral	Contém os dados para a quantidade de comentários nas publicações
likes	Objeto Geral	Contém os dados para a quantidade de curtidas nas publicações
reaction_angry	Objeto Geral	Contém os dados para a quantidade de reações "Grr" nas publicações
reaction_haha	Objeto Geral	Contém os dados para a quantidade de reações "Haha" nas publicações
reaction_like	Objeto Geral	Contém os dados para a quantidade de reações "Curtir" nas publicações
reaction_love	Objeto Geral	Contém os dados para a quantidade de reações "Amei" nas publicações
reaction_others	Objeto Geral	Contém os dados para a quantidade de reações temporárias como por exemplo "Orgulho" e "Gratidão" nas publicações
reaction_sad	Objeto Geral	Contém os dados para a quantidade de reações "Triste" nas publicações
reaction_total	Objeto Geral	Contém os dados para a quantidade Total de reações nas publicações
reaction_wow	Objeto Geral	Contém os dados para a quantidade de reações "Uau" nas publicações
reactions	Objeto Geral	Contém os dados para a quantidade Total de reações nas publicações
shares	Objeto Geral	Contém os dados para a quantidade de compartilhamento nas publicações
total	Objeto Geral	Contém os dados para a quantidade de interações nas publicações

Posts

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
dark_posts	Objeto Geral	Contém os dados de publicações Dark Posts.
timeline	Objeto Geral	Contém os dados de publicações da timeline.
total	Objeto Geral	Contém os dados de todas as publicações

Alcance

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
average	Objeto Geral	Contém os dados para o alcance médio.
total	Objeto Geral	Contém os dados para o alcance total.

Visualizações de vídeos

Campo	Tipo	Descrição
avg_time_watched	number	Tempo médio de visualização.
avg_time_watched_perc	number	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.

Corpo da resposta

Campo	Tipo	Descrição
engagement	Engajamento	Objeto que contém detalhes sobre o engajamento da página.
followers	Seguidores	Contém detalhes sobre os seguidores da página conectada.
impressions	Impressões Instagram	Contém detalhes sobre as impressões da página conectada.
interactions	Interações Instagram	Interações realizadas nas publicações.
reels	Reels	Objeto que contém detalhes sobre os reels encontrado no Warroom.
posts	Posts Instagram	Contém dados sobre a quantidade de publicações.
reach	Alcance Instagram	Contém dados sobre o alcance das publicações
stories	Stories	Contém dados sobre os videos da página conectada.

Impressões Instagram

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
dark_posts	Objeto Geral	Média de impressões por publicações para Dark Posts.
stories	Objeto Geral	Média de impressões por publicações para Stories.
timeline	Objeto Geral	Média de impressões por publicações para timeline.
total	Objeto Geral	Média de impressões totais por publicações.

Interações Instagram

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
comments	Objeto Geral	Contém os dados para a quantidade de comentários nas publicações
likes	Objeto Geral	Contém os dados para a quantidade de curtidas nas publicações
shares	Objeto Geral	Contém os dados para a quantidade de compartilhamento nas publicações
saves	Objeto Geral	Contém os dados para a quantidade de salvos nas publicações
total	Objeto Geral	Contém os dados para a quantidade de interações nas publicações
views	Objeto Geral	Contém os dados para a quantidade de visualizações em vídeos.

Posts Instagram

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
dark_posts	Objeto Geral	Contém os dados de publicações Dark Posts.
timeline	Objeto Geral	Contém os dados de publicações da timeline.
stories	Objeto Geral	Contém os dados de publicações dos Stories.
total	Objeto Geral	Contém os dados de todas as publicações

Alcance Instagram

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
dark_posts	Objeto Geral	Contém os dados para o alcance de Dark Posts.
stories	Objeto Geral	Contém os dados para o alcance de Stories.
timeline	Objeto Geral	Contém os dados para o alcance de publicações da timeline.
total	Objeto Geral	Contém os dados para o alcance total.

Reels

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
comments	Objeto Geral	Contém dados sobre a quantidade de comentários nos reels.
likes	Objeto Geral	Contém dados sobre a quantidade de curtidas nos reels.
saved	Objeto Geral	Contém dados sobre a quantidade de salvos nos reels.
total	Objeto Geral	Contém os dados para o alcance total.

Stories

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
exits	Objeto Geral	Contém dados sobre a quantidade de saídas dos stories.
impressions	Objeto Geral	Contém dados sobre a quantidade de impressões nos stories.
replies	Objeto Geral	Contém dados sobre a quantidade de respostas nos stories.
taps_back	Objeto Geral	Contém dados sobre a quantidade de toques de retorno nos stories.
taps_forward	Objeto Geral	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.

Corpo da resposta

Campo	Tipo	Descrição
followers	Seguidores	Contém detalhes sobre os seguidores da página conectada.
interactions	Interações Linkedin YouTube Twitter	Interações realizadas nas publicações.
posts	Posts Linkedin YouTube Twitter	Contém dados sobre a quantidade de publicações.

Interações Linkedin YouTube Twitter

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
comments	Objeto Geral	Contém os dados para a quantidade de comentários nas publicações
likes	Objeto Geral	Contém os dados para a quantidade de curtidas nas publicações
shares	Objeto Geral	Contém os dados para a quantidade de compartilhamento nas publicações
total	Objeto Geral	Contém os dados para a quantidade de interações nas publicações
views	Objeto Geral	Contém os dados para a quantidade de visualizações em vídeos.

Posts Linkedin YouTube Twitter

Campo	Tipo	Descrição
name	String	Nome do campo que pode ser encontrado na tela do Warroom.
total	Objeto Geral	Contém os dados de todas as publicações

Corpo da resposta em json

{
  "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.

Corpo da resposta

Campo	Tipo	Descrição
posts	Total	Quantidade total de publicações realizadas pela conta dentro do período selecionado.
likes	Total	Número de curtidas nas publicações, dentro do período selecionado.
comments	Total	Número de comentários feitos nas publicações no período selecionado.
shares	Total	Quantidade de vezes em que as publicações foram compartilhadas pelos usuários, dentro do período selecionado.
views	Dicionário<Total, Média>	Nessa área é possível visualizar o total de Interações que uma publicação recebeu no período selecionado.
reach	Dicionário<Total, Média>	Aqui contém os dados de alcance. Mais detalhes você pode consultar aqui
engagement	Total	Contém o valor do total de interações, que corresponde à soma de todas as métricas de interações. Mais detalhes você pode consultar aqui
engagement_rate	Média	Esse dado corresponde ao índice de engajamento. Mais detalhes você pode consultar aqui
avg_time_watched	Média	Soma do tempo de reprodução dos vídeos. Mais detalhes você pode consultar aqui
total_watched_time	Dicionário<Total, Média>	Soma do tempo de reprodução dos vídeos de todas as publicações. Mais detalhes você pode consultar aqui
full_video_watched_rate	Média	Soma das visualizações que assistiram todo o vídeo. Mais detalhes você pode consultar aqui

Total

Campo	Tipo	Descrição
value	number	Quantidade total de uma determinada métrica no período escolhido.
variation	number	Valor percentual de uma determinada métrica no período escolhido.
type	Os valores possíveis são: UP, DOWN	Quando UP significa que está positivo, quando DOWN significa negativo em relação ao período escolhido.

Média

Campo	Tipo	Descrição
value	number	Quantidade média de uma determinada métrica no período escolhido.
variation	number	Valor percentual da média de uma determinada métrica no período escolhido.
type	Os valores possíveis são: UP, DOWN	Quando UP significa que está positivo, quando DOWN significa negativo em relação ao período escolhido.

Corpo da resposta em JSON

{
  "posts": {
    "total": {
      "value": 12.0,
      "variation": 100.0,
      "type": "UP"
    }
  },
  "likes": {
    "total": {
      "value": 535.0,
      "variation": 74.59639126305792,
      "type": "DOWN"
    }
  },
  "comments": {
    "total": {
      "value": 64.0,
      "variation": 73.44398340248962,
      "type": "DOWN"
    }
  },
  "shares": {
    "total": {
      "value": 15.0,
      "variation": 89.5104895104895,
      "type": "DOWN"
    }
  },
  "views": {
    "total": {
      "value": 9307.0,
      "variation": 65.70112400958172,
      "type": "DOWN"
    },
    "average": {
      "value": 775.5833333333334,
      "variation": 82.85056200479085,
      "type": "DOWN"
    }
  },
  "reach": {
    "total": {
      "value": 7787.0,
      "variation": 62.533679753656656,
      "type": "DOWN"
    },
    "average": {
      "value": 648.9166666666666,
      "variation": 81.26683987682834,
      "type": "DOWN"
    }
  },
  "engagement": {
    "total": {
      "value": 9921.0,
      "variation": 66.51139240506329,
      "type": "DOWN"
    }
  },
  "engagement_rate": {
    "average": {
      "value": 8.302781820513284,
      "variation": 3.082868430280188,
      "type": "DOWN"
    }
  },
  "avg_time_watched": {
    "average": {
      "value": 4.458333333333333,
      "variation": 38.99657977812903,
      "type": "DOWN"
    }
  },
  "total_watched_time": {
    "total": {
      "value": 45149.0,
      "variation": 85.06192078506886,
      "type": "DOWN"
    },
    "average": {
      "value": 3762.4166666666665,
      "variation": 92.53096039253445,
      "type": "DOWN"
    }
  },
  "full_video_watched_rate": {
    "average": {
      "value": 7.200833247043192,
      "variation": 189.57774025473074,
      "type": "UP"
    }
  }
}

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

Request

curl --location 'https://api.stilingue.com.br/metricaspro/facebook/visaogeral_sentimento/{api-token}/{page-id}?fanpages={page-id-1}%3A{page-id-2}'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
fanpages	string	Pageid1:PageId2	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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	Não

Corpo da resposta

Campo	Tipo	Descrição
results	Results	São os dados de sentimento por dia e para cada fanpage
total_results	Total Results	São os dados para o total de sentimentos dos comentários para cada fanpage

Results

Campo	Tipo	Descrição
data	List<Data Results>	Contém os dados para os sentimentos dos comentários para cada fanpage
name	String	Nome da página conectada

Total Results

Campo	Tipo	Descrição
data	List<Data Total Results>	Contém os dados para o total de sentimentos dos comentários para cada fanpage.
name	String	Nome da página conectada

Data Total Results

Campo	Tipo	Descrição
data	List<Data Geral>	Contém os dados para o total de sentimentos dos comentários para cada fanpage.
name	String	Nome da página conectada

Data Results

Campo	Tipo	Descrição
data	List<Data Geral>	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
    }
  }
}

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.

Warroom - Publicações ativadas

Request

curl --location 'https://api.stilingue.com.br/metricaspro/instagram/viewstempo/{api-token}/{page_id}'

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. 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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	Não

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Informa se os dados estão vindo de um cache
results	List<Type>	Lista contendo objeto com uma determinada métrica com dias e respectivos valores daquele dia.

Type

Campo	Tipo	Descrição
name	string	Nome da métrica
carousels	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à visualização de carrossel
dark_posts	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à dark posts (ads)
posts	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à visualização de posts
reels	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à visualização de reels
stories	List<Data>	Lista com a respectiva data e o valor encontrado para métricas relacionadas à visualização de stories

Data

Campo	Tipo	Descrição
date	Date(aaaa/MM/dd)	Data da respectiva métrica
value	number	Quantidade total da respectiva métrica no referente dia

Corpo da resposta em json

{
  "from_cache": false,
  "results": [
    {
      "carousels": [
        {
          "date": "2025/03/06",
          "value": 522
        },
        {
          "date": "2025/03/07",
          "value": 855
        }
      ],
      "dark_posts": [
        {
          "date": "2025/03/06",
          "value": 44
        },
        {
          "date": "2025/03/07",
          "value": 885
        }
      ],
      "name": "views",
      "posts": [
        {
          "date": "2025/03/06",
          "value": 4666
        },
        {
          "date": "2025/03/07",
          "value": 9988
        }
      ],
      "reels": [
        {
          "date": "2025/03/06",
          "value": 40572
        },
        {
          "date": "2025/03/07",
          "value": 8855
        }
      ],
      "stories": [
        {
          "date": "2025/03/06",
          "value": 666
        },
        {
          "date": "2025/03/07",
          "value": 899
        }
      ]
    }
  ]
}

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.

Warroom - Volume de Interações

Request

curl --location 'https://api.stilingue.com.br/metricaspro/{canal}/volumeinteracoes/{api-token}/{page-id}'

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. 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 do n-ésimo dia anterior a data de hoje. Exemplo: Ao preencher 30, o sistema irá contar 30 dias para trás e trazer dados apenas daquele dia. Atenção: esse filtro sobrescreve o filtro date_range	Não

Corpo da resposta

Campo	Tipo	Descrição
from_cache	boolean	Informa se os dados estão vindo de um cache
results	List<Type>	Lista contendo objeto com uma determinada métrica com dias e respectivos valores daquele dia.

Type

Campo	Tipo	Descrição
name	string	Nome da métrica
data	List<Data>	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

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.

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": "Compartilhamentos"
    }
  ]
}

Instagram

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

Corpo da resposta

Campo	Tipo	Descrição
axes	List<Axe>	Lista contendo o objeto contendo os dados de data da respectiva métrica.
points	List<Points>	Lista contendo objeto com valor da sua respectiva métrica.

Corpo da resposta em json

{
  "axes": [
    {
      "label": "posted_at",
      "values": [1749438000000, 1749524400000, 1749610800000]
    }
  ],
  "points": [
    {
      "data": [5, 1, 0],
      "name": "shares"
    },
    {
      "data": [8, 9, 0],
      "name": "comments"
    },
    {
      "data": [649, 5701, 0],
      "name": "views"
    },
    {
      "data": [68, 112, 0],
      "name": "likes"
    }
  ]
}

Público

Retorna os dados relacionados a página conectada ao Warroom, relacionadas ao público da marca. Para mais detalhes dessa métrica, clique aqui

Para acessar os dados do Warroom que serão retornados, segue a imagem abaixo.

Warroom - Público

Limitações

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}' \
      -d date_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.	Não

Corpo da resposta

Campo	Tipo	Descrição
audience_gender	List<Gênero>	Representa a divisão percentual de cada gênero do público da Marca.
new_followers	number	Número de aumento de seguidores na página proprietária no período selecionado. Dado comparado ao período anterior selecionado.
new_followers_perc	number	Percentual de aumento do seguidores.
profile_views	number	Número de visitas à página proprietária no período selecionado. Dado comparado ao período anterior selecionado.
profile_views_perc	number	Percentual de visitas à página no período anterior.
today_profile_views	number	Número de visitas à página no último dia do período selecionado.
today_profile_views_perc	number	Percentual de visitas ao perfil no período anterior.
total_followers	number	Número total de seguidores na página proprietária no período selecionado. Dado comparado ao período anterior selecionado
total_followers_perc	number	Percentual sobre o total no período anterior.

Gênero

Campo	Tipo	O que retorna	Descrição
name	string	Nome do gênero	Os valores possíveis são: Female, Male, Other
value	number	número inteiro positivo	Percentual de representatividade do total entre os gêneros

Corpo da resposta em json

{
  "total_followers": 50372,
  "total_followers_perc": 0.4927681,
  "new_followers": 1456,
  "new_followers_perc": -8.954035,
  "profile_views": 1903,
  "profile_views_perc": -37.09091,
  "today_profile_views": 0,
  "today_profile_views_perc": -100.0,
  "audience_gender": [
    {
      "name": "Female",
      "value": 0.4000000059604645
    },
    {
      "name": "Male",
      "value": 0.6000000238418579
    },
    {
      "name": "Other",
      "value": 0.0
    }
  ]
}

Page Metrics

Esse endpoint traz dados proprietários adicionais das páginas do Facebook conectadas ao Warroom. Essas métricas são relativas ao desempenho da páginas e está descrita com maiores detalhes na tabela abaixo. Nesse caso até o momento não existe uma visualização dentro do Warroom, futuramente quando aparecer, iremos adicionar aqui um print de onde ela fica.

Se você quiser entender melhor o que cada métrica significa, basta acessar a documentação oficial da Meta, basta pesquisa pelo determinado nome da métrica dentro das tabelas explicativas. Aqui todos os dados são trazidos por dia.

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/metricaspro/facebook/page-metrics/{api-token}/{facebook-page-id}' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Exemplo	Descrição	Obrigatório
api-token	1234567891234567	Token da API	sim
page_id	123456eeeaaa	id da pagina conectada ao Warroom	sim
date_range	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

Corpo da resposta

Campo	Tipo	Descrição
List<Metric>	Metric	Uma lista de objetos, contendo os dados das métricas

Metric

Campo	Tipo	Descrição
List<Date>	Date	Uma lista de objetos, contendo o dia da métrica e o valor da métrica naquele determinado dia.
name	string	Nome da determinada métrica.

Date

Campo	Tipo	Descrição
day	string	Dia e hora de determinada métrica no formato `iso8601`
value	number	Valor da métrica para aquele dia unicamente. Ele não é cumulativo, são valores diários únicos.

Corpo da resposta em JSON

[
  {
    "dates": [
      {
        "day": "2025-07-10T07:00:00Z",
        "value": 0
      },
      {
        "day": "2025-07-11T07:00:00Z",
        "value": 0
      }
    ],
    "name": "page_video_complete_views_30s"
  },
  {
    "dates": [
      {
        "day": "2025-07-10T07:00:00Z",
        "value": 0
      },
      {
        "day": "2025-07-11T07:00:00Z",
        "value": 8
      }
    ],
    "name": "page_views_total"
  },
  {
    "dates": [
      {
        "day": "2025-07-10T07:00:00Z",
        "value": 2
      },
      {
        "day": "2025-07-11T07:00:00Z",
        "value": 0
      }
    ],
    "name": "page_video_views_autoplayed"
  },
  {
    "dates": [
      {
        "day": "2025-07-10T07:00:00Z",
        "value": 0
      },
      {
        "day": "2025-07-11T07:00:00Z",
        "value": 6
      }
    ],
    "name": "page_video_repeat_views"
  },
  {
    "dates": [
      {
        "day": "2025-07-10T07:00:00Z",
        "value": 0
      },
      {
        "day": "2025-07-11T07:00:00Z",
        "value": 5
      }
    ],
    "name": "page_video_views_10s"
  },
  {
    "dates": [
      {
        "day": "2025-07-10T07:00:00Z",
        "value": 2
      },
      {
        "day": "2025-07-11T07:00:00Z",
        "value": 0
      }
    ],
    "name": "page_video_views_click_to_play"
  },
  {
    "dates": [
      {
        "day": "2025-07-10T07:00:00Z",
        "value": 0
      },
      {
        "day": "2025-07-11T07:00:00Z",
        "value": 4
      }
    ],
    "name": "page_video_complete_views_30s_unique"
  },
  {
    "dates": [
      {
        "day": "2025-07-10T07:00:00Z",
        "value": 2
      },
      {
        "day": "2025-07-11T07:00:00Z",
        "value": 1
      }
    ],
    "name": "page_video_views_organic"
  }
]

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

Smartcare - Relatório

Limitações

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.

Request

https://api.stilingue.com.br/calls/report/{api-token}

curl --location 'https://api.stilingue.com.br/calls/report/{api-token}?start_date=10%2F02%2F2025%2000%3A00&end_date=12%2F02%2F2025%2023%3A59&format=json'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
date_range	string	202401010000:202401072359	Intervalo de datas que precisa ser retornado os dados do relatório no formato AAAAMMDDHHmm:AAAAMMDDHHmm	Sim
format	string	json	Tipo de formato desejado do relatório. Os valores possíveis são: `json, xlsx, csv`	Sim

Corpo da resposta

Campo	Tipo	Descrição
cases	List<case>	Possuirá dados dos casos que abrange as interações filtradas. Lembrando que uma conversa poderá possuir mais de um caso
conversations	List<conversations>	Dados relativos as conversas do Smartcare
interactions	List<interactions>	Possuirá as interações que foram feitas dentro do período filtrado
statusesChanges	List<statuseschanges>	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
conversationId	string	ID da plataforma que identifica uma conversa
channel	string	Nome do canal da página
page	Page	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
conversationId	string	ID da conversa
channel	string	Rede social onde a conversa foi realizada
page	Page	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.
caseId	string	ID do caso que essa interação faz parte.
page	Page	Objeto contendo informações da página proprietária conectada ao Warroom
text	string	Texto da interação em UTF-8. Conteúdo da interação em texto
proprietary	boolean	Indica se a interação veio da própria página proprietária
polarity	string	Sentimento classificado na interação. Os valores possíveis são: `Positivo, Neutro, Negativo`
operatorName	string	Nome do operador do Smartcare que respondeu a interação. Caso um operador mude de nome estaremos retornando o valor antigo nas publicações antigas
user	User	Objeto contendo dados do usuário da rede social
tags	List<string>	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
delay	number	Tempo até a coleta

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
operator	Operator	Objeto contendo dados do operador que faz atendimentos no Smartcare
conversationId	string	ID da conversa que foi realizada a mudança de status
page	Page	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.`
calendarId	string	Identificar do Calendário
relativeProcessedAt	number	Data e Hora do Processamento
relativePostedAt	number	Data e Hora da Publicaçã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
user.crmUserId	string	Identificador do Usuário CRM

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
    }
  ]
}

Chamados

Este endpoint público retorna as transições de status e a quantidade de chamados do Smart Care. Ele pode ser consumido por integrações externas, como o Power BI e outros dashboards.

Requisição

O endpoint aceita os métodos GET e POST:

https://api.stilingue.com.br/sac/report/calls_quantity/{api_id}/

curl --location 'https://api.stilingue.com.br/sac/report/calls_quantity/999999999/?filter_id=6a0ccef9efa355ccc2c1389d&date_range=202608170000%3A202608172359&sla_type=post'

Parâmetros da requisição

Campo	Local	Tipo	Exemplo	Descrição	Obrigatório
api_id	Path	string	999999999	API key do cliente.	Sim
filter_id	Query	string	6a0ccef9efa355ccc2c1389d	ID (ObjectId) de um filtro salvo no Smart Care. Este parâmetro é obrigatório, embora a ausência atualmente resulte em HTTP 500.	Sim
date_range	Query	string	202608170000:202608172359	Intervalo no formato AAAAMMDDHHmm:AAAAMMDDHHmm.	Sim
sla_type	Query	string	post	Filtra por tipo de SLA, por exemplo `post` ou `message`.	Não

Corpo da resposta

A resposta contém um objeto por status. Cada objeto possui o total e o percentual correspondente ao período filtrado.

{
  "pending_calls": {"total": 341972, "percentage": 0.0},
  "waiting_calls": {"total": 15, "percentage": 0.56},
  "open_calls": {"total": 9, "percentage": 0.34},
  "replied_calls": {"total": 237, "percentage": 8.88},
  "finished_calls": {"total": 81, "percentage": 3.03},
  "ignored_calls": {"total": 1932, "percentage": 72.36},
  "total_calls": {"total": 396, "percentage": 14.83},
  "current_pending_calls": {"total": 0, "percentage": 0.0}
}

Uso no Power BI

O filter_id deve ser copiado de um filtro salvo no Smart Care, por exemplo, inspecionando as requisições de rede da interface. Para períodos longos, consulte um dia por vez e agregue os resultados no Power Query:

let
  BaseUrl = "https://api.stilingue.com.br/sac/report/calls_quantity/",
  ApiId = "999999999",
  FilterId = "6a0ccef9efa355ccc2c1389d",
  StartDate = #date(2026, 8, 1),
  EndDate = #date(2026, 8, 31),
  DayDates = List.Dates(StartDate, Duration.Days(EndDate - StartDate) + 1, #duration(1, 0, 0, 0)),
  FetchDay = (dateValue) =>
    let
      DateStr = Date.ToTextranslation missing: pt.dateValue, "yyyyMMdd",
      Range = DateStr & "0000:" & DateStr & "2359",
      Url = BaseUrl & ApiId & "?filter_id=" & FilterId & "&date_range=" & Range & "&sla_type=post",
      Response = Json.Documentranslation missing: pt.Web.Contents(Url)
    in
      Response[pending_calls][total],
  DailyResults = List.Transform(DayDates, each FetchDay(_)),
  AggregatedSum = List.Sum(DailyResults)
in
  AggregatedSum

Limitações

Os quatro endpoints públicos de relatório exigem filter_id, que define os canais, tipos de conversação e o tipo de data usado na consulta.
Sem filter_id, o backend pode retornar HTTP 500 (Something went wrong in request processing.). A aplicação consumidora deve sempre enviar o parâmetro.
O tempo aproximado de resposta é de 2 segundos para um dia, de 5 a 10 segundos para sete dias e de aproximadamente 97 segundos para 30 dias.
Períodos superiores a sete dias têm alto risco de exceder o timeout HTTP padrão de 10 segundos. Para o Power BI, use consultas diárias e agregue os resultados no cliente.

TMR Geral

Este endpoint público retorna o Tempo Médio de Resposta (TMR) e as métricas de SLA do Smart Care para o período e filtro informados.

Requisição

O endpoint aceita os métodos GET e POST:

https://api.stilingue.com.br/sac/report/avg_time/{api_id}/

curl --location 'https://api.stilingue.com.br/sac/report/avg_time/999999999/?filter_id=6a0ccef9efa355ccc2c1389d&date_range=202608170000%3A202608172359&sla_type=post'

Parâmetros

Campo	Local	Tipo	Exemplo	Descrição	Obrigatório
api_id	Path	string	999999999	API key do cliente.	Sim
filter_id	Query	string	6a0ccef9efa355ccc2c1389d	ID (ObjectId) de um filtro salvo no Smart Care.	Sim
date_range	Query	string	202608170000:202608172359	Intervalo no formato AAAAMMDDHHmm:AAAAMMDDHHmm.	Sim
sla_type	Query	string	post	Filtra por tipo de SLA, como `post` ou `message`.	Não

Corpo da resposta

{
  "avg_answer_time": {
    "months": 0, "days": 0, "hours": 4, "minutes": 0, "seconds": 33
  },
  "delta_percentage": 485.0,
  "agreed_answer_time": {
    "months": 0, "days": 2, "hours": 0, "minutes": 0, "seconds": 0
  },
  "agreed_delta_percentage": 8.35
}

avg_answer_time é o TMR calculado, enquanto agreed_answer_time representa o tempo de resposta acordado no SLA. Os campos delta_percentage e agreed_delta_percentage retornam os percentuais calculados pelo relatório.

Limitações

filter_id é obrigatório. Sem ele, o backend pode retornar HTTP 500 (Something went wrong in request processing.).
O filtro salvo define os canais, tipos de conversação e o tipo de data considerados no cálculo.
Para períodos superiores a sete dias, faça requisições diárias no cliente para reduzir o risco de timeout. O tempo aproximado é de 2 segundos para um dia, de 5 a 10 segundos para sete dias e de aproximadamente 97 segundos para 30 dias.

Análise de Sentimento

Este endpoint público retorna a distribuição diária de sentimento dos chamados do Smart Care: positivo, negativo, neutro e não classificado.

Requisição

O endpoint aceita os métodos GET e POST:

https://api.stilingue.com.br/sac/report/polarity/{api_id}/

curl --location 'https://api.stilingue.com.br/sac/report/polarity/999999999/?filter_id=6a0ccef9efa355ccc2c1389d&date_range=202608170000%3A202608172359&sla_type=post'

Parâmetros

Campo	Local	Tipo	Exemplo	Descrição	Obrigatório
api_id	Path	string	999999999	API key do cliente.	Sim
filter_id	Query	string	6a0ccef9efa355ccc2c1389d	ID (ObjectId) de um filtro salvo no Smart Care.	Sim
date_range	Query	string	202608170000:202608172359	Intervalo no formato AAAAMMDDHHmm:AAAAMMDDHHmm.	Sim
sla_type	Query	string	post	Filtra por tipo de SLA, como `post` ou `message`.	Não

Corpo da resposta

{
  "data": [
    {
      "date": "2026/08/17",
      "num_calls": {
        "negative": 224,
        "positive": 153,
        "neutral": 290,
        "not_classified": 11
      }
    }
  ]
}

Comportamentos padrão

A consulta aplica automaticamente report_type=not_owner, removendo respostas do proprietário da página, e annotation_spam=false, excluindo itens marcados como spam.

Limitações

filter_id é obrigatório. Sem ele, o backend pode retornar HTTP 500 (Something went wrong in request processing.).
O filtro salvo define os canais, tipos de conversação e o tipo de data considerados na análise.
Para períodos superiores a sete dias, consulte cada dia separadamente no Power BI ou em outra aplicação cliente e agregue os resultados. Períodos de 30 dias podem levar aproximadamente 97 segundos e exceder o timeout HTTP padrão de 10 segundos.

Distribuição por Temas

Este endpoint público retorna o detalhamento dos chamados por Temas e Tópicos, cruzado com a distribuição de sentimento.

Requisição

O endpoint aceita os métodos GET e POST:

https://api.stilingue.com.br/sac/report/themes/{api_id}/

curl --location 'https://api.stilingue.com.br/sac/report/themes/999999999/?filter_id=6a0ccef9efa355ccc2c1389d&date_range=202608170000%3A202608172359&sla_type=post'

Parâmetros

Campo	Local	Tipo	Exemplo	Descrição	Obrigatório
api_id	Path	string	999999999	API key do cliente.	Sim
filter_id	Query	string	6a0ccef9efa355ccc2c1389d	ID (ObjectId) de um filtro salvo no Smart Care.	Sim
date_range	Query	string	202608170000:202608172359	Intervalo no formato AAAAMMDDHHmm:AAAAMMDDHHmm.	Sim
sla_type	Query	string	post	Filtra por tipo de SLA, como `post` ou `message`.	Não

Corpo da resposta

{
  "data": {
    "themes": [
      {
        "name": "T10 - Operações Infraestrutura e Vazamentos",
        "total": 121,
        "positive": 33,
        "negative": 70,
        "neutral": 17,
        "not_classified": 1
      }
    ]
  }
}

Comportamentos padrão

A consulta aplica automaticamente type=themes, report_type=not_owner e annotation_spam=false. Assim, o relatório usa a distribuição por temas, remove respostas do proprietário da página e exclui itens marcados como spam.

Limitações

filter_id é obrigatório. Sem ele, o backend pode retornar HTTP 500 (Something went wrong in request processing.).
O filtro salvo define os canais, tipos de conversação e o tipo de data considerados no relatório.
Para períodos superiores a sete dias, consulte cada dia separadamente no cliente e agregue os resultados. Períodos de 30 dias podem levar aproximadamente 97 segundos e exceder o timeout HTTP padrão de 10 segundos.

Área de autor

Retorna a área de Autor com dados de um usuário.

Conversas SmartCare

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/smartcare/user/{api-token}?date_range=2d' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	123456	Token de autenticação necessário para acessar os dados	Sim
channels	string	Twitter:Instagram:Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: twitter, instagram, instagramComments, facebook, facebookComments, youTube, youTubeComments, News, blogs, linkedin	Sim
uids	number	987654321	IDs de usuários para serem filtrados	Sim
fanpages	string	abc123xyz	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	Não
removed	boolean	false	Filtra publicações removidas ou não	Não

Corpo da resposta

Campo	Tipo	Descrição
code	number	Resultado da requisição.
data	List<Data>	Objeto que contém os dados do usuário.
status	string	Resultado da requisição.

Data

Campo	Tipo	Descrição
channel	string	Canal referente ao perfil do usuário.
custom_fields	Campos customizados	Objeto que contém os dados dos campos customizados na área do autor.
first_interaction	number	Data da sua primeira interação
gender	string	Gênero do usuário que enviou a mensagem.
interacted_page_id	string	ID da página que interagiu
interacted_page_name	string	Nome da página que interagiu
interactions_polarity	List<Interações por Sentimento>	Interações por sentimento
interests	List	Lista com os interesses definidos na área do autor.
last_interaction	number	Data da última interação.
name	string	Nome do usuário
talking_about	number	Métrica descontinuada do Facebook
uid	string	ID do usuário que entrou em contato
user_image_url	string	URL da foto de perfil da conta
user_url	string	URL da conta que fez a publicação.

Interações por Sentimento

Campo	Tipo	Descrição
negative	number	Quantidade de interações negativas
neutral	number	Quantidade de interações neutras
not_classified	number	Quantidade de interações não classificadas
positive	number	Quantidade de interações positivas

Campos Customizados

Campo	Tipo	Descrição
birth_date	string	Data de nascimento
company	string	Nome da Companhia
cpf	string	Número do CPF
custom_user_id	string	ID do usuário
customer_segment	string	Segmento de cliente
email	string	Email do cliente
name	string	Nome do cliente
rg	string	Rg do cliente
telephone	string	Telefone do cliente

Corpo da resposta em json

{
  "code": 200,
  "data": {
    "channel": "Facebook",
    "first_interaction": 202304191102,
    "interacted_page_id": "101457399339198",
    "interacted_page_name": "Capivaria Mística",
    "interactions_polarity": {
      "negative": {
        "percentage": 0.0,
        "total": 0
      },
      "neutral": {
        "percentage": 0.21568627450980393,
        "total": 11
      },
      "not_classified": {
        "percentage": 0.7254901960784313,
        "total": 37
      },
      "positive": {
        "percentage": 0.058823529411764705,
        "total": 3
      }
    },
    "last_interaction": 202501301121,
    "name": "Capivaria Mística",
    "talking_about": 0,
    "uid": "101457399339198",
    "user_image_url": "https://scontent-iad3-1.xx.fbcdn.net/v/t39.30808-1/297601643_102468859238052_9110214877558829230_n.jpg?stp=cp0_dst-jpg_s50x50_tt6&_nc_cat=108&ccb=1-7&_nc_sid=fe756c&_nc_ohc=ZbLYk9U9w6YQ7kNvgHcNqMT&_nc_zt=24&_nc_ht=scontent-iad3-1.xx&edm=ANsyT80EAAAA&_nc_gid=AR5SkGXK0lfRvZgc1KcScf-&oh=00_AYD8LPSBzBql5F0hK6M_f_Rp1z5uRQTP_cmn_wsBR5kueA&oe=67A166B9",
    "user_url": "https://www.facebook.com/101457399339198"
  },
  "status": "OK"
}

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.

Conversas SmartCare

Limitações

Entendermos como contabilizamos as conversas e interações:
Conversas atendidas contabilizam os que possuem status respondido ou fechado
Interações inclui todas conversas e respostas a conversas coletadas

Request

curl --location 'https://api.stilingue.com.br/contador/{api-token}?filters=67d454cd1222fc09e6619834&date_range=202503010000%3A202503262359'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
api-token	number	123456	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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	Sim

Corpo da resposta

Campo	Tipo	Descrição
code	number	Código do status code
count_data	Counter	Objeto contendo a contagem das métricas para o filtro informado
data	Conversas	Objeto contendo os dados das interações, para conferir a documentação completa dele basta clicar aqui
status	string	Status atual da requisição: ERROR ou OK

Counter

Campo	Tipo	Descrição
answered_calls	number	Total de conversas atendidas
not_owner	Totals	Objeto contendo totais de atendimento não proprietário
owner	Totals	Objeto contendo totais de atendimento proprietário
status	Status	Objeto contendo os totais de atendimento por status
total	Totals	Objeto contendo a somatória total de proprietário + não proprietário
updated_at	number	Data e hora da contagem feita

Totals

Campo	Tipo	Descrição
calls	number	Número relativo ao total de conversas
interactions	number	Número relativo ao total de interações

Status

Campo	Tipo	Descrição
answered	number	Total de conversas respondidas
closed	number	Total de conversas fechadas
ignored	number	Total de conversas ignoradas/não tratadas
opened	number	Total de conversas abertas
pending	number	Total de conversas em pendente
waiting	number	Total de conversas em espera

Corpo da resposta em json

{
  "code": 200,
  "count_data": {
    "answered_calls": 17,
    "not_owner": {
      "calls": 88,
      "interactions": 100
    },
    "owner": {
      "calls": 2,
      "interactions": 50
    },
    "status": {
      "answered": 4,
      "closed": 13,
      "ignored": 62,
      "opened": 1,
      "pending": 6,
      "waiting": 4
    },
    "total": {
      "calls": 90,
      "interactions": 150
    },
    "updated_at": 1743010835667
  },
  "data": {
    //Aqui dentro vem os conteúdos das conversas.
  },
  "status": "OK"
}

Conversas

Retorna dados relativos a lista de conversas que fica no menu lateral do SmartCare. Para mais detalhes, clique aqui.

Conversas SmartCare

Request

curl -X 'GET' \
  'https://api.stilingue.com.br/smartcare/conversas/{api-token}?date_range=2d' \
  -H 'accept: */*'

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	123456	Token de autenticação necessário para acessar os dados	Sim
channels	string	Twitter:Instagram:Facebook	Filtra por canais específicos. Separar múltiplos valores utilizando dois pontos. Os valores possíveis são: twitter, instagram, instagramComments, facebook, facebookComments, youTube, youTubeComments, News, blogs, linkedin	Sim
fanpages	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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	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
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	Não
removed	boolean	false	Filtra publicações removidas ou não	Não

Corpo da resposta

Campo	Tipo	Descrição
execution_time_millis	number	Tempo de execução em milissegundos.
next_id_offset	number	Tempo de execução em milissegundos.
next_offset	number	Próxima paginação.
posts	List<Posts>	Lista que contém as conversas encontradas no Smartcare.
previous_date_millis_offset	number	Data anterior da paginação.
previous_id_offset	string	Id anterior da paginação.

Posts

Campo	Tipo	Descrição
AAA_score	number	Pontuação proprietária da STILINGUE que indica a relevância de usuários com potencial influenciador.
_id	string	ID de uma publicação
authors	List	Informações do autor da publicação
channel	string	Canal onde ocorreu a conversa
comments	number	Quantidade de comentários
contact_reasons	List	Motivos de contato associados a conversa.
crawled_at	string	Data em que a publicação foi coletada no formato
critical_level	number	Classificação do nível de criticidade do post
customer_info	List<Customer>	Informações de quem enviou a mensagem
dislikes	string	Número de dislikes da postagem
emotion	string	Não é mais utilizado desde 2018
favorability	List	Sentimento (positivo, negativo ou neutro) de cada canal. Ela se aplica à Imprensa
favorite	boolean	Se a publicação é checada.
fb_critical_level	string	Classificação do nível de criticidade das publicações de Facebook
features	List	Campo interno usado para auxiliar no processamento. Os valores possíveis são: `FEED, REELS`
followers	number	Quantidade de seguidores da página/autor
footage	number	Campo de link de vídeo somente para canal de News
from_integration	boolean	Verifica se tem integração da BoxNet
gender	string	Gênero de quem fez a publicação. Os valores possíveis são: `"" (vazio), Homem, Mulher, Marca`
group_polarity	List	Sentimento de cada grupo em que a publicação foi coletada
groups	List	Lista de grupos da pesquisa que foram associados a publicação
hashtags	List	Lista de hashtags do post
hidden_by_user	boolean	Se a mensagem foi oculta pelo usuário
hot	number	Pontuação interna que indica o quanto a publicação continua repercutindo na rede
hot_post	boolean	Se é uma publicação hot. A publicação é hot se ela estiver entre as 20 publicações mais quentes
impact	number	Mede o impacto da publicação
interacted_page_id	string	ID da página que interagiu com a publicação
interactions	number	Quantidade total de interações no post (soma comentários, curtidas, compartilhamentos, etc)
interests	List	Interesses do autor do post. Exemplo: `Tecnologia & Computação,Mídia / Impresso,Imprensa Social`
is_dynamic_post	boolean	Se o post é dinâmico
is_root	boolean	Verifica se é a mensagem principal
lang	string	Idioma do post. Os valores possíveis são: pt, en, es
likes	number	Número de curtidas no post
location	string	Localização do autor do post
long_posted_at	number	Data de postagem do post em formato UNIX milissegundos. Ex: 1734727140000
long_updated_at	number	Data da última alteração do post em formato UNIX milissegundos. Ex: 1734727140000
max_shared_followers	number	Valor máximo de usuários que compartilharam a publicação
max_shared_show_dossier	boolean	Define se vai mostrar o dossiê do usuário que tem mais seguidores e que compartilhou a publicação
mentions	List	Nome dos usuários mencionados no post
metrics_updated_at	string	Última vez que as métricas do post foram atualizadas. Ex: `22/12/2024 17:23`
name	string	Nome da página ou do usuário
nlp_text_hash	string	Hash gerado do texto que é enviado para o processamento do NLP
operator_id	string	ID do operador que respondeu a conversa no Smartcare
operator_name	string	Nome do operador que respondeu a conversa no Smartcare
order_by	string	Filtragem de ordem
page_comment	boolean	Verifica se a interação ou post foi feito pela página
page_id	string	ID da página proprietária conectada que fez o post
pages	List	ID da página. Usado para filtrar posts de uma página específica
pid	string	ID do post
post_url	string	URL do post raiz
post_user_image_url	string	URL da imagem de perfil página que fez o post
posted_at	string	Data da postagem. Ex: 23/12/2024 10:23
primary_channel	string	Canal onde a publicação foi feita. Os valores possíveis são: `Twitter, Instagram, Facebook, YouTube, News, Blogs, Linkedin`
reactions	number	Número de reações à publicação
receiver	List<Receiver>	Remetente da mensagem
replied	boolean	Verifica se a mensagem foi respondida
replier	string	Dados de quem respondeu a conversa
replier_name	string	Nome de quem respondeu a conversa
reply_pid	string	ID (pid) do post que o post respondeu. *Se um post responde um comentário, o reply_pid será do comentário respondido
root_id	string	ID do post principal, a publicação root
sac_call_id	string	ID interno Stilingue da interação principal da conversa
sac_type	string	Tipo da conversa. Os valores possíveis são: `posts, comentarios, inbox, postvisitantes, comentariosvisitantes, reviews, comentariosreview, mentions, comentariosmentions`
sentiment	number	Valor do sentimento do post.
shall_use_receiver	boolean	Valida se o campo receptor é relevante para uma chamada SAC FEED
shares	number	Número de compartilhamentos da publicação
spam	boolean	Verifica se a mensagem foi selecionada para ser deletada
spokesman	List	Lista de porta-voz de notícias
status	string	Status da conversa. Os valores possíveis são: `Ignorado, Pendente, Aberto, Em Espera, Respondido, Fechado`
tags	List	Lista de tags da conversa
talk_id	string	ID da conversa
text	string	Conteúdo de texto do post
theme_polarity	List	Satisfação do cliente
themes	List	Temas da conversa
thread_finished	boolean	Verifica se a thread foi finalizada
title	string	Título da postagem
to	List	Destinatário da mensagem (inbox)
type	string	Tipo da publicação. Os valores possíveis são: `video, image, carrossel (exclusivo Instagram), post`
uid	string	ID do usuário/autor do post
update_time_ago	string	Indica há quanto tempo o post foi editado.
user_image_url	string	URL da foto de perfil da conta
user_url	string	URL da conta que fez o post
username	string	Nome de usuário da conta que fez o post
valoration	number	Corresponde à Equivalência Publicitária na área de Mural de Imprensa
verified	boolean	Se a conta que fez o post é verificada
videoplays	number	Número de vezes que um vídeo foi executado. *Disponível quando type é video

Receiver

Campo	Tipo	Descrição
email	string	Email do remetente
id	string	ID do remetente
email	string	Email do remetente
image_url	string	URL da imagem do remetente
name	string	Nome do remetente

Customer

Campo	Tipo	Descrição
attachments	List<Attachments>	Anexos sobre o usuário que enviou a mensagem: vídeos, imagens, etc
gender	string	Gênero de quem enviou a mensagem. Os valores possíveis são: `"" (vazio), Homem, Mulher, Marca`
name	string	Nome do usuário que enviou a mensagem
post_user_image_url	string	URL da imagem de perfil
profile_picture	string	URL da imagem de perfil
uid	string	ID do usuário/autor da mensagem
user_image_url	string	URL da foto de perfil da conta

Attachments

Campo	Tipo	Descrição
id	string	ID do anexo
name	string	Nome do anexo. Ex: "facebook_image"
attachment_type	string	Tipo do anexo
media_type	string	Tipo de mídia anexada na publicação. Os valores possíveis são: `IMAGE, VIDEO`
storage_id	string	ID da mídia anexada, na Storage
type	string	MIME Type do anexo. Descrição detalhada

Corpo da resposta em json

{
  "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"
}

Métricas

Retorna os cálculos da média SLA de primeira resposta e Tempo médio de atendimento. Para mais detalhes, clique aqui.

Métricas

Request

     curl -H 'Content-Type: application/json' \
          -X GET \
          'https://api.stilingue.com.br/smartcare/metrics/TOKEN' \
          -d date_range=202507160000%3A202507222359 \
          -d channels=facebooK%2CinstaGram%2Ctwitter%2Cyoutube%2CTikTok%2Clinkedin%2Cgooglemybusiness \
          -d pages=101294901783796%2C101457399339198 \
          -d sac_types=PostComment%2CInbox%2CVisitorPost%2CVisitorComment%2CReview%2CReviewComment%2CMention%2CMentionComment%2CTagged%2CExternalComment

Parâmetros da requisição

Campo	Tipo	Exemplo	Descrição	Obrigatório
token	number	123456	Token de autenticação necessário para acessar os dados	Sim
start_date	string	202401010000	Data de inicio passada na requisição. Padrão YYYYMMDDHHMM	Não
end_date	string	202401010000	Data do fim passada na requisição. Padrão YYYYMMDDHHMM	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
filter_id	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: https://warroom.stilingue.com.br/dashboard/publicacoes/mural/?date_range=30d&filters=5db1f0b6e8e474001551580d	Não
channels	string	twitter,instagram,facebook	Filtra por canais específicos. Separar múltiplos valores utilizando vírgulas. Os valores possíveis são: twitter, instagram, instagramComments, facebook, facebookComments, youTube, youTubeComments, News, blogs, linkedin	Sim
sac_types	List<string>	inbox,reviews	Tipo de interação da publicação (para filtros de conversa). Separar múltiplos valores utilizando vírgulas. Podem ser posts, comentarios, inbox, postvisitantes, comentariosvisitantes, reviews, comentariosreview, mentions e comentariosmentions	Não
pages	List<string>	108629115449345, 108629115449346	Lista de ID de páginas. Usado para filtrar posts de uma ou mais páginas, Separar múltiplos valores utilizando vírgulas. Lista pode ser vazia.	Sim

Corpo da resposta

Campo	Tipo	Descrição
avg_chat_duration	Duration	Tempo médio de atendimento em segundos
avg_first_answer_sla	Duration	Cálculo da média de SLA da primeira resposta em segundos

Duration

Campo	Tipo	Descrição
current_value	number	Valor atual em segundos
previous_value	number	Refere-se ao valor no periodo anterior, exemplo: se o date_range informado for 202501200000:202501302359 o periodo anterior será 202501090000:202501192359

Corpo da resposta em json

{
  "avg_chat_duration": {
    "current_value": 75288,
    "previous_value": 258743
  },
  "avg_first_answer_sla": {
    "current_value": 646,
    "previous_value": 435321
  }
}

FAQ

Pergunta: A API implementa modelo de autenticação / autorização?

Resposta: Sim via api-token.

Pergunta: A API permite a limitação de taxa, de maneira a garantir o uso justo dos serviços baseados em API e recursos contratados?

Resposta: No momento ainda não temos limite de requisições.

Pergunta: O aplicativo armazena chaves de API?

Resposta: Sim, pra servir de validação dos tokens.

Pergunta: O aplicativo suporta a lista de permissões de IP para acesso à API?

Resposta: Não temos limitação de requisição por IP.

Pergunta: Quais colunas representam no relatório os campos caselnitAt e caseId?

Resposta: O campo caseInitAt corresponde a coluna "Hora e Data do Início do Caso".

E o campo caseId corresponde a coluna "ID Caso".

Pergunta: A quantidade de campos que constam no documento de integração é menor que a quantidade de colunas que vem no relatório da Smart. Isso acontece por que?

Resposta: Se o formato escolhido para o retorno da API for XLSX, então são retornados os seguintes campos a mais.

Campo	Descrição
delay	Tempo até a coleta
page.id	ID Página
user.id	ID Autor
user.name	Nome autor
user.crmUserId	ID Usuário CRM
user.gender	Gênero Autor

Configurações Gerais

Pergunta: Existe a possibilidade de obter um ID de conta impessoal para armazenamento seguro (cofre do Data Team)?

Resposta: Não é possível.

Pergunta: O ID do painel é fixo e como podemos obtê-lo?

Resposta: Sim, é fixo. Pode ser obtido na plataforma em Otimizar → Editar pesquisa. O link no navegador exibirá duas sequências de números, uma referente à conta e outra ao painel; por exemplo, em uma URL como https://…/123/456, o 123 é o número da conta e o 456 é o número do painel.

Pergunta: O token da API não aparece na tela ao tentar gerá-lo (bug).

Resposta: A causa mais provável é que apenas usuários Master conseguem gerar o token.

Pergunta: O painel de Benchmarks pode ser consultado via API?

Resposta: Atualmente não há API para a funcionalidade de Benchmark. A sugestão foi enviada ao time de produto.

Uso da API e fluxo de dados

Pergunta: O cliente relatou que a API está sendo usada apenas para tirar uma “fotografia” (extrato) dos dados.

Resposta: Esta não é a experiência esperada. A API funciona como um canal aberto e constante para prover dados em near real-time. Para resolver, o cliente deve programar uma repetição no ciclo de requisições (sugestão: a cada 5 minutos).

Pergunta: É possível obter a atualização dos posts caso ocorra uma revisão da classificação (tag, tema, grupos) no dia seguinte?

Resposta: Atualmente, é necessário fazer uma nova requisição para coletar o post novamente e capturar essas atualizações.

Métricas e discrepâncias

Pergunta: Resultados de impressões e cliques (fb_impressions, fb_clicks) só aparecem para o Facebook, mas outras redes (Instagram, YouTube, LinkedIn) aparecem na coluna channel. Há um campo para impressões/cliques de outras redes?

Resposta:

Impressões: o Instagram tem essa métrica na API.
Cliques: a métrica de cliques não é coletada pela plataforma e, portanto, não está disponível na API STI.

A indisponibilidade de métricas em outras redes costuma ser uma limitação da API da própria rede social, não da API da Stilingue.

Pergunta: É possível coletar dados de ganho de seguidores por dia na API?

Resposta: Existe um endpoint de base de fãs que pode ser útil para isso; veja em Evolução da base de fãs.

Pergunta: Há alguma coluna na API de Publicações Proprietárias que separe dark post de orgânico?

Resposta:

is_ads (boolean): true para post pago (dark post), false para post orgânico.
processed_by_performance (boolean): true para post proprietário, false para post de listening (mar aberto).

Pergunta: Por que existe grande discrepância nos resultados (especialmente comentários no Facebook) entre a API e as páginas das redes sociais? É uma metodologia de mensuração diferente da Stilingue?

Resposta: Discrepâncias são comuns devido a dois fatores:

Janela de atualização: a janela de atualização de métricas da Stilingue é de 30 dias. Interações após esse período não são contabilizadas.
Metodologia de contagem: a STI atribui a interação à data de criação do post, enquanto a rede social atribui à data da interação.

Pergunta: Qual é o contato de suporte para diagnóstico e normalização de discrepâncias de dados?

Resposta: O contato é o próprio Suporte: [email protected] ou [email protected], ou via chat logado na plataforma.

Campos e métricas

Pergunta: Como posso recuperar informações sobre o nome da equipe que fez o atendimento, já que o campo com o nome da equipe não está disponível?

Resposta: Atualmente, a recuperação direta não é possível. A solução alternativa é usar o nome do operador seguido pela equipe para identificar a resposta da equipe, como um sufixo. Exemplo: Operador XPTO - Equipe1.

Pergunta: Qual campo conecta as tabelas Smart Care — Status Changes e Smart Care — Cases?

Resposta: O campo de conexão é conversationId, que se correlaciona ao pid (identificador principal de um post) para este tipo de dado.

Pergunta: O que significam pid e uid?

Resposta: pid é o identificador principal de um post. uid é o identificador principal do usuário que fez o post.

Pergunta: O que é a métrica “Impact Level” e como posso juntá-la a outras tabelas?

Resposta: O “Impact Level” vem do “Alcance potencial”, que por sua vez vem da “Visão geral” (Overview) do Listening. O campo a ser usado como chave para juntar a outras tabelas é request_parameters.universe_id, pois é um identificador único por painel.

Evolução da API

Pergunta: E quanto aos nomes das páginas (pages) que retornam como IDs?

Resposta: Para obter os nomes das páginas, é necessário chamar o endpoint /getpages em uma requisição separada, conforme a documentação.

Pergunta: O que significa “interacted page” versus “page” na seção Listening?

Resposta:

interacted_page_id e interacted_page_name: ID e nome da página que interagiu com a publicação.
page_id: ID da página proprietária conectada que fez a postagem.
pages: ID da página, usado para filtrar posts de uma página específica.

Problemas

Pergunta: O que vem no campo contact_reasons quando não há motivos de contato?

Resposta: É esperado vir um array vazio.

Posts duplicados no painel

Pergunta: Se eu tiver uma página proprietária conectada e fizer um post a partir dessa página, esse post entra no painel como post proprietário. Mas o que acontece se o conteúdo desse post tiver palavras que estão configuradas para serem coletadas no listening também e casar com algum grupo, tema etc, o que deveria acontecer? Posts duplicados? Um no listening e outro proprietário?

Resposta: Não, nesse caso o post proprietário prevalece por ser uma precedência maior que o post em listening. No final terá apenas um post proprietário no painel.

Como funcionam os calendários?

Pergunta: Estamos usando os campos "inside_sla_conversations" (da tabela Smart Care — Alterações de status) e "first_answer_is_inside_sla_time" (da tabela Smart Care — Casos). Esses campos consideram o Calendário comercial (das 9h às 20h)? Os stakeholders informaram que o calendário está configurado em Smart Care > Configurações > Calendários > Calendário Social - SLA SETADO. O calendário deve ser configurado em todos os painéis que utilizamos?

Resposta: Os calendários possuem compatibilidade em duas vias. Você pode criar apenas um calendário e compartilhá-lo entre todos os painéis da mesma conta, mas cada painel também pode ter seu próprio calendário dedicado. No entanto, não é possível compartilhar calendários entre contas, apenas entre painéis da mesma conta.

Qual é a diferença entre os rótulos de canal?

Pergunta: Nos dados de listening, percebemos que há dois tipos de resultado no campo "Channel", por exemplo: "comentários no Instagram" "Instagram"

Resposta: Basicamente, "Instagram" é a publicação principal; "comentários no Instagram" é um canal que identifica apenas os comentários feitos pelos usuários.

Fuso horário da extração de dados

Pergunta: Quando extraímos os dados pela API, eles estão em GMT-0 ou UTC-3?

Resposta: Quando o formato é XLSX, todos os painéis, independentemente de qual sejam, são formatados e retornados no fuso horário UTC-3 (America/Sao_Paulo). Quando o formato de saída é JSON, os dados são retornados em GMT (UTC-0).

Linha do relatório de alterações de status

Pergunta: No endpoint de alterações de status, cada linha representa uma alteração de status, e não uma interação, identificada por um ID (campo ID). Está correto?

Resposta: Sim, está correto.

Valor padrão do limite de requisições

Pergunta: Em relação ao campo "limit", quando ele não é enviado, o valor padrão é 5?

Resposta: Você pode enviá-lo na requisição. O valor máximo é 1000.

Ordenação dos posts

Pergunta: Qual é a ordenação usada para trazer os posts? Data do que é considerado o parâmetro date_range?

Resposta: Sim, o campo utilizado como padrão é a data em que a postagem foi feita. Ou seja o para pegar posts que foram postados no dia 01/09, basta passar a data nesse campo.

Caso queira pegar apenas posts que foram atualizados, basta passar no order_by o valor updated_asc ou updated_desc para trazer pela data de atualização. Ou seja, se quiser pegar um post que foi postado no dia 01/09 mas que foi atualizado no dia 10/09, basta passar a data 10/09 para trazer sua atualização, não sendo necessário ir no dia 01/09 pegar o post atualizado.

Nessas atualizações contam tudo que é possível, métricas, classificação, anotação, tagueamento entre outros.

Faça sua pergunta aqui.