Lista de Campos do Instagram Insights

NOME DO CAMPO	NOME DESCRITIVO	TIPO	DESCRIÇÃO
Action Type (Breakdown)	Tipo de Ação (Detalhamento)	Dimensão	Tipo de ação realizada no detalhamento de métricas.
Age (Breakdown)	Faixa Etária (Detalhamento)	Dimensão	A distribuição etária dos seguidores sobre quem temos dados demográficos. Possíveis valores: M (masculino), F (feminino) ou U (desconhecido). Não inclui dados sobre o dia atual. Essa métrica não está disponível para usuários do Instagram com menos de 100 seguidores. Não é compatível com os parâmetros since e until (date). Métrica alternativa: follower_demographics. Detalhamento: age, gender
City (Breakdown)	Cidade (Detalhamento)	Dimensão	As cidades dos seguidores sobre quem temos dados demográficos. Para métricas demográficas, apenas os 45 resultados de melhor desempenho serão retornados (por exemplo, no caso de audience_city, poderão ser retornadas até 45 cidades com os maiores números de seguidores). Não inclui dados sobre o dia atual. Essa métrica não está disponível para usuários do Instagram com menos de 100 seguidores. Apenas os resultados dos 45 países com os valores mais altos serão retornados. Não é compatível com os parâmetros since e until (date). Métrica alternativa: follower_demographics. Detalhamento: city
Contact Button Type (Breakdown)	Tipo de Botão de Contato (Detalhamento)	Dimensão	Tipo de botão de contato utilizado.
Country (Breakdown)	País (Detalhamento)	Dimensão	Os países dos seguidores sobre quem temos dados demográficos. Para métricas demográficas, apenas os 45 resultados de melhor desempenho serão retornados (por exemplo, no caso de audience_city, poderão ser retornadas até 45 cidades com os maiores números de seguidores). Não inclui dados sobre o dia atual. Essa métrica não está disponível para usuários do Instagram com menos de 100 seguidores. Apenas os resultados dos 45 países com os valores mais altos serão retornados. Não é compatível com os parâmetros since e until (date). Métrica alternativa: follower_demographics. Detalhamento: country
Date	Data	Dimensão	Data associada à métrica ou evento.
Empty Column	Coluna Vazia	Dimensão	Campo vazio usado para espaçamento em queries.
Extraction Date	Data de Extração	Dimensão	Data em que os dados foram extraídos.
Extraction Datetime	Data e Hora de Extração	Dimensão	Data e hora em que os dados foram extraídos.
Follow Type (Breakdown)	Tipo de Seguimento (Detalhamento)	Dimensão	Tipo de relação de seguimento (seguindo/seguidores).
Follower Demographics	Demografia de Seguidores	Dimensão	As características demográficas dos seguidores, incluindo distribuição por país, cidade e gênero. Não é compatível com since nem until. Esse valor não é retornado se o usuário do Instagram tiver menos de 100 seguidores.
Following	Seguindo	Métrica	Número total de contas Este perfil está seguindo
Gender (Breakdown)	Gênero (Detalhamento)	Dimensão	A distribuição gênero dos seguidores sobre quem temos dados demográficos. Possíveis valores: M (masculino), F (feminino) ou U (desconhecido). Não inclui dados sobre o dia atual. Essa métrica não está disponível para usuários do Instagram com menos de 100 seguidores. Não é compatível com os parâmetros since e until (date). Métrica alternativa: follower_demographics. Detalhamento: age, gender
Hour	Hora	Dimensão	Hora associada à métrica ou evento.
Media Account Name	Nome do Perfil	Dimensão	Nome de usuário do perfil associado ao conteúdo.
Media Caption	Legenda do Conteúdo	Dimensão	Legenda de imagens, vídeos ou carrosséis. Limite de 2.200 caracteres, 30 hashtags e 20 menções (@).
Media Comments Count	Contagem de Comentários	Métrica	Número total de comentários no conteúdo.
Media ID	ID da Mídia	Dimensão	Identificador único do conteúdo na API do Instagram.
Media IG ID	ID do Instagram	Dimensão	ID exclusivo associado ao perfil do Instagram.
Media Insights Clips Replays Count	Reproduções de Clips	Métrica	Número total de reproduções de clipes.
Media Insights Comments	Comentários nas Mídias	Métrica	Total de comentários nas mídias publicadas.
Media Insights Follows	Novos Seguidores	Métrica	Número de novos seguidores gerados por determinada mídia ou campanha.
Media Insights IG Reels Aggregated All Plays Count	Total de Reproduções dos Reels	Métrica	Contagem agregada de todas as reproduções dos Reels.
Media Insights IG Reels Avg Watch Time	Tempo Médio de visualização dos Reels	Métrica	Tempo médio que os Reels foram assistidos pelos usuários.
Media Insights IG Reels Video View Total Time	Tempo Total de Visualização dos Reels	Métrica	Tempo total de visualizações dos vídeos no formato Reels.
Media Insights Impressions	Impressões	Métrica	Número total de vezes que o conteúdo foi visualizado, incluindo campanhas pagas.
Media Insights Likes	Curtidas	Métrica	Número de curtidas no conteúdo, incluindo publicações, vídeos e Reels.
Media Insights Navigation	Navegação	Métrica	Dados de navegação relacionados ao conteúdo.
Media Insights Plays	Reproduções	Métrica	Total de reproduções do conteúdo.
Media Insights Profile Activity	Atividade no Perfil	Métrica	Número de interações realizadas no perfil associado ao conteúdo.
Media Insights Profile Visits	Visitas ao Perfil	Métrica	Número de visitas ao perfil do Instagram dentro do período especificado.
Media Insights Reach	Alcance	Métrica	Número total de contas exclusivas que visualizaram o perfil no período especificado. Inclui visualizações orgânicas e de anúncios.
Media Insights Replies	Respostas	Métrica	Número total de respostas às mídias do perfil.
Media Insights Saved	Salvos	Métrica	Número de vezes que a mídia foi salva por usuários.
Media Insights Shares	Compartilhamentos	Métrica	Número total de compartilhamentos das mídias.
Media Insights Total Interactions	Interações Totais	Métrica	Soma total de interações com a mídia, como curtidas, comentários e compartilhamentos.
Media Insights Video Views (Deprecated)	Visualizações de Vídeo (Obsoleto)	Métrica	Número de visualizações de vídeos. (Campo descontinuado).
Media Is Comment Enabled	Comentários Habilitados	Dimensão	Indica se os comentários estão habilitados na mídia.
Media Is Shared To Feed	Compartilhado no Feed	Dimensão	Indica se a mídia foi compartilhada no feed do perfil.
Media Like Count	Contagem de Curtidas	Métrica	Número total de curtidas na mídia.
Media Owner	Proprietário da Mídia	Dimensão	Nome do proprietário ou criador da mídia.
Media Permalink	Permalink da Mídia	Dimensão	URL permanente associada à mídia publicada.
Media Product Type	Tipo de Produto da Mídia	Dimensão	Formato em que a mídia foi publicada: Feed, Story ou Reels.
Media Product Type (Breakdown)	Tipo de Produto (Detalhamento)	Dimensão	Detalhamento por tipo de produto ou mídia.
Media Shortcode	Código Curto da Mídia	Dimensão	Código curto associado à mídia para fácil identificação.
Media Thumbnail URL	URL da Miniatura	Dimensão	URL da miniatura associada a imagens, Reels ou vídeos.
Media Timestamp	Data e Hora da Mídia	Dimensão	Data e hora em que a mídia foi publicada.
Media Type	Tipo de Mídia	Dimensão	Tipo de objeto de mídia: IMAGE, VIDEO ou CAROUSEL_ALBUM.
Media URL	URL da Mídia	Dimensão	URL completa da mídia (imagem ou vídeo).
Media Video Title	Título do Vídeo	Dimensão	Título associado ao vídeo publicado.
New Followers (Last 30 Days Only)	Novos Seguidores (Últimos 30 dias)	Métrica	Número total de novos seguidores nos últimos 30 dias.
Reached Audience Demographics	Demografia do Público Alcançado	Dimensão	Distribuição demográfica do público alcançado, incluindo país, cidade e gênero.
Story Navigation Action Type (Breakdown)	Tipo de Ação de Navegação (Detalhamento)	Dimensão	Tipos de ações de navegação realizadas em stories.
Total Followers (All Time)	Total de Seguidores (Todo o Tempo)	Métrica	Número total de seguidores únicos do perfil.
User Account Name	Nome do Usuário	Dimensão	Nome de usuário associado ao perfil.
User Biography	Biografia	Dimensão	Biografia do perfil do Instagram.
User ID	ID do Usuário	Dimensão	Identificador único associado ao perfil do usuário.
User IG ID	ID do Instagram do Usuário	Dimensão	ID exclusivo do perfil do Instagram.
User Insights Accounts Engaged	Contas Engajadas	Métrica	Número total de contas que interagiram com as mídias do perfil.
User Insights Comments	Comentários	Métrica	Total de comentários nas mídias do perfil.
User Insights Email Contacts (Deprecated)	Contatos de E-mail (Obsoleto)	Métrica	Número de contatos via e-mail. (Campo descontinuado).
User Insights Follows and Unfollows	Seguidores e Deixaram de Seguir	Métrica	Total de seguidores ganhos e perdidos no intervalo especificado.
User Insights Get Directions Clicks (Deprecated)	Cliques em Obter Direções (Obsoleto)	Métrica	Número de cliques no botão "Obter Direções". (Campo descontinuado).
User Insights Impressions	Impressões	Métrica	Número total de vezes que o perfil foi visualizado. Inclui visualizações de anúncios.
User Insights Likes	Curtidas	Métrica	Número total de curtidas nas mídias do perfil.
User Insights Online Followers	Seguidores Online	Métrica	Número total de seguidores online no intervalo especificado. Disponível apenas para usuários com mais de 100 seguidores.
User Insights Phone Call Clicks (Deprecated)	Cliques em Ligações (Obsoleto)	Métrica	Número de cliques no botão para ligações telefônicas. (Campo descontinuado).
User Insights Profile Links Taps	Cliques em Links do Perfil	Métrica	Número total de cliques nos links do perfil.
User Insights Profile Views (Deprecated)	Visualizações de Perfil (Obsoleto)	Métrica	Número de visualizações do perfil do Instagram. (Campo descontinuado).
User Insights Reach	Alcance	Métrica	Número total de contas exclusivas que visualizaram o perfil no período especificado. Inclui visualizações orgânicas e de anúncios.
User Insights Replies	Respostas	Métrica	Número total de respostas às mídias do perfil.
User Insights Saved	Salvos	Métrica	Número de vezes que a mídia foi salva por usuários.
User Insights Shares	Compartilhamentos	Métrica	Número total de compartilhamentos das mídias.
User Insights Text Message Clicks (Deprecated)	Cliques em Mensagens de Texto (Obsoleto)	Métrica	Número de cliques no botão de mensagem de texto. (Campo descontinuado).
User Insights Total Interactions	Interações Totais	Métrica	Soma total de interações com as mídias do perfil, como curtidas, comentários e compartilhamentos.
User Insights Website Clicks (Deprecated)	Cliques no Site (Obsoleto)	Métrica	Número de cliques no link do site do perfil. (Campo descontinuado).
User Media Count	Contagem de Mídias	Métrica	Número total de mídias publicadas pelo perfil.
User Name	Nome do Perfil	Dimensão	Nome associado ao perfil do Instagram.
User Profile Picture URL	URL da Foto de Perfil	Dimensão	URL da imagem de perfil associada ao usuário do Instagram.
User Shopping Product Tag Eligibility	Elegibilidade para Marcação de Produtos	Dimensão	Indica se o perfil é elegível para marcação de produtos em posts.
User Website	Website do Perfil	Dimensão	URL do site associado ao perfil do Instagram.

Sobre os dados de Stories

Os dados relacionados a stories só ficam disponíveis por 24 horas.

Sobre os campos Demographics

Em geral campos iniciados com Demographics só podem ser combinados com Breakdowns específicos como Age, Gender, etc. e a métrica Follower Demographics.

Para obter dados de novos seguidores, utilize os campos:

• New Followers (Last 30 Days Only)
• Date

A API possui uma limitação de apenas 30 dias de dados para novos seguidores. Por isso, é necessário realizar uma extração separada para estes campos.

Métricas Específicas para Stories

Os stories têm métricas disponíveis apenas durante o período de 24 horas. Além disso possui métricas específicas como:

• navigation: Total de ações como voltar, próximo, encaminhar, etc.
• total interactions: Número de respostas e compartilhamentos do seu story.
• shares: Número de compartilhamentos realizados no story.

Métrica	Descrição
impressions	Total de vezes que o objeto do Story foi visualizado.
reach	Total de contas únicas do Instagram que visualizaram o objeto do Story.
replies	Total de respostas (comentários) no objeto do Story. Nota: Respostas feitas por usuários em algumas regiões, como Europa (a partir de 1º de dezembro de 2020) e Japão (a partir de 14 de abril de 2021), retornam valor 0.
follows	Número de contas que começaram a seguir você após visualizar o Story.
navigation	Total de ações realizadas no seu Story, incluindo métricas como: saiu, avançou, voltou ou viu o próximo Story. Detalhamento: story_navigation_action_type
profile_activity	Número de ações realizadas pelas pessoas ao visitar seu perfil após interagirem com o Story. Detalhamento: action_type
profile_visits	Número de vezes que seu perfil foi visitado.
shares	Número de vezes que o Story foi compartilhado.
total_interactions	Número total de respostas e compartilhamentos do seu Story.

Métricas do Instagram Reels

Métrica	Descrição
clips_replays_count	Número de vezes que o Reel começa a ser reproduzido novamente após uma reprodução inicial. Retomadas são contabilizadas quando duram pelo menos 1 ms na mesma sessão.
comments	Número de comentários no Reel. (Métrica em desenvolvimento)
ig_reels_aggregated_all_plays_count	Total de reproduções (iniciais e retomadas) do Reel após uma impressão. Inclui reproduções no Instagram e no Facebook via Recomendação entre Apps (XAR). Nota: Essa métrica pode ser maior que a soma de clips_replays_count e plays, pois abrange reproduções em múltiplos aplicativos.
ig_reels_avg_watch_time	Tempo médio de reprodução do Reel. (Métrica em desenvolvimento)
ig_reels_video_view_total_time	Tempo total de reprodução, incluindo repetições. (Métrica em desenvolvimento)
likes	Número de curtidas no Reel. (Métrica em desenvolvimento)
plays	Número de vezes que o Reel começa a ser reproduzido após uma impressão. Contabiliza sessões de vídeo com pelo menos 1 ms, excluindo repetições. (Métrica em desenvolvimento)
initial_plays	Reproduções iniciais em uma sessão, com duração mínima de 1 ms. Não inclui retomadas.
replays	Retomadas do Reel após a reprodução inicial. Contabiliza sessões de pelo menos 1 ms.
reach	Número de contas únicas que visualizaram o Reel pelo menos uma vez. Diferente de impressões, que incluem múltiplas visualizações pela mesma conta. (Métrica estimada e em desenvolvimento)
saved	Número de vezes que o Reel foi salvo. (Métrica em desenvolvimento)
shares	Número de compartilhamentos do Reel. (Métrica em desenvolvimento)
total_interactions	Soma de curtidas, salvamentos, comentários e compartilhamentos, menos descurtidas, remoções de salvamentos e exclusões de comentários. (Métrica em desenvolvimento)

Sobre a Compatibilidade das métricas

Se você solicitar uma métrica que não seja compatível com um detalhamento, a API retornará um erro (“An unknown error has occurred.”).

Por isso, tenha cuidado ao solicitar várias métricas em uma única consulta. Por exemplo, se você solicitar Impressions e Reach (metric_type=time_series), os detalhamentos não serão incluídos na resposta.

Além disso, é importante notar que campos de Media Insights não podem ser combinados com campos de User Insights em uma mesma consulta, pois eles pertencem a contextos diferentes na API.

Mais informações na Documentação da Graph API do Instagram.