Não encontrou o que procurava?
Entre em contato e responderemos o mais breve possível
Enviar uma dúvidaCadastre-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