Não encontrou o que procurava?
Entre em contato e responderemos o mais breve possível
Enviar uma dúvida
Cadastre-se agora e ganhe 50% de desconto na primeira mensalidade!
Cadastre-se agora e ganhe 50% de desconto na primeira mensalidade!
Última modificação: janeiro 4, 2025
| 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. |
Os dados relacionados a stories só ficam disponíveis por 24 horas.
Em geral campos iniciados com Demographics só podem ser combinados com Breakdowns específicos como Age, Gender, etc. e a métrica Follower Demographics.
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.
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:
| 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é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) |
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.
Entre em contato e responderemos o mais breve possível
Enviar uma dúvida
