# Como exportar um relatório mensal de publicações do Instagram só com as contagens necessárias

Comece pela lista de publicações conferida pelo titular da conta ou por uma exportação existente. Selecione as publicações do mês escolhido. Depois, acrescente as contagens públicas atuais de curtidas e comentários, se necessário, e exporte uma linha por publicação para uma planilha. Mantenha as publicações indisponíveis no arquivo, com as células de contagem vazias. Essas são as contagens atuais das publicações feitas naquele mês. Não são contagens registradas no fim daquele mês.

Use primeiro os registros do titular quando eles contiverem as datas e as contagens necessárias. Para uma lista pequena, você pode preparar a planilha manualmente. Se precisar de contagens públicas atuais para URLs de publicações conhecidas, a entrada documentada do Instagram Metrics Scraper atende a essa etapa de coleta. Você ainda precisa montar a lista mensal, conferir as linhas retornadas e preparar o relatório.

A pergunta do leitor é como exportar publicações de um determinado mês. Essa formulação deixa duas decisões em aberto: quais publicações entram no arquivo e quando suas contagens foram observadas. Mantenha essas decisões separadas durante todo o método.

## 1. Defina o mês e o momento das contagens

Anote o mês, o ano e o fuso horário de publicação antes de selecionar as publicações. O momento da publicação é quando ela foi publicada. O momento da observação é quando você coletou suas contagens.

Use o primeiro instante do mês como início. Use o primeiro instante do mês seguinte como fim. Inclua o início e exclua o fim. Essa regra impede que uma publicação feita no início do mês seguinte entre nos dois relatórios.

Escolha qual pergunta a planilha deve responder:

1. Quais são as contagens públicas atuais das publicações feitas no mês selecionado?
2. Quanta atividade ocorreu durante o mês selecionado?

Este método responde à primeira pergunta. Uma publicação feita em setembro pode ter suas contagens coletadas em 25 de outubro. A data de publicação em setembro determina a seleção da publicação. O momento da observação em outubro descreve as contagens.

Se o pedido se refere à atividade durante setembro, altere as evidências solicitadas antes de coletar as contagens atuais. Uma contagem atual não permite determinar qual era a contagem em 30 de setembro. Não apresente uma observação de outubro como uma leitura do fim de setembro.

Defina também a conta e a lista usada como fonte. Um relatório baseado em uma lista limitada deve informar essa limitação. Um título adequado é “Observações atuais das publicações conhecidas de setembro”. Acrescente o ano e a data real da observação ao seu relatório.

## 2. Monte uma lista de publicações conferida

A lista reúne as publicações que você pretende incluir. Comece pelo registro de publicações conferido pelo titular ou por uma exportação existente. Um registro de publicações informa quais publicações foram feitas e quando.

Confira se essa fonte abrange a conta e o mês solicitados. Mantenha uma nota sobre sua cobertura. Cobertura é a parte da lista solicitada que a fonte permite comprovar. Não presuma que uma exportação contém todas as publicações apenas porque tem muitas linhas.

Se não houver uma lista do titular, prepare manualmente uma lista limitada de URLs de publicações públicas conhecidas. Identifique essa lista como limitada. Não prometa incluir todas as publicações mensais da conta com base nessa evidência.

Para cada publicação candidata, salve a URL solicitada e as evidências de publicação. Use um ID estável da publicação quando houver um disponível. O ID identifica um item de conteúdo. A URL é seu endereço na web.

Mantenha estas decisões visíveis:

| Evidência de publicação | Decisão sobre inclusão no mês | Ação necessária |
| --- | --- | --- |
| Momento conferido dentro do mês | Incluir | Manter a publicação na lista mensal |
| Momento conferido fora do mês | Excluir | Manter o motivo no registro de seleção |
| Momento da publicação desconhecido | Revisar | Manter a candidata sem decisão |
| Fontes de publicação divergentes | Revisar | Verificar a divergência antes de decidir a inclusão |

Não use o dia em que você encontrou uma publicação como sua data de publicação. Não trate uma data desconhecida como prova de que a publicação está fora do mês.

Use uma linha por item de conteúdo. Se duas URLs levarem ao mesmo ID de publicação conferido, mantenha as URLs solicitadas no registro das fontes e inclua a publicação uma única vez no relatório. Legendas iguais, por si só, não provam que duas linhas representam a mesma publicação.

O [guia para um inventário conferido de publicações do Instagram](/pt-BR/articles/auditoria-formatos-e-cadencia-instagram/) explica os limites relacionados às datas e à cobertura. Para este relatório, use as identidades e as datas conferidas. Você não precisa da análise de formatos ou de frequência de publicação desse guia.

## 3. Confira uma URL pública conhecida

Um Actor é um programa hospedado que coleta dados. O Instagram Metrics Scraper documenta a coleta direta a partir de URLs conhecidas de conteúdo público. A entrada pública conferida aceita `mode` definido como `contentUrls`, uma lista em `startUrls` e um limite total opcional de linhas em `maxItems`.

Um limite é um máximo, não uma quantidade garantida de resultados. A entrada documentada também permite descobrir perfis. Este método usa sua lista de conteúdo conferida. Ele não depende da descoberta de perfis para estabelecer um histórico mensal completo. Consulte o [contrato público da versão compilada, conferido em 25 de outubro de 2026; somente entrada e saída documentadas](https://api.apify.com/v2/acts/chronometrica~instagram-metrics-scraper/builds/default).

Use esta pequena entrada fornecida para a primeira verificação:

```json
{"maxItems":1,"mode":"contentUrls","startUrls":["https://www.instagram.com/reel/DIwcCZgxVZP/"]}
```

3. Confira uma URL pública conhecida

Antes de executar:

1. Substitua a URL de exemplo pela URL de uma publicação pública conhecida ou de um Reel da sua lista. Um Reel é uma publicação de vídeo do Instagram.
2. Mantenha `mode` definido como `contentUrls`.
3. Mantenha `maxItems` definido como `1` nesta verificação de um único item.
4. Compare a identidade, a data, as contagens e os estados retornados com a publicação solicitada.

A entrada fornecida tem uma estrutura válida conforme a documentação. Nenhuma execução foi feita para este guia. A URL de exemplo não serve como evidência para seu relatório mensal.

Para uma lista conferida maior, substitua a lista de exemplo pelas URLs desejadas. Escolha um limite suficiente para esses itens. Depois, associe cada publicação solicitada aos dados retornados. Um limite maior não garante que todas as publicações terão contagens utilizáveis.

A página pública da [Instagram Brand Campaign Metrics Task, conferida em 25 de outubro de 2026; somente a existência da página foi verificada](https://apify.com/chronometrica/instagram-metrics-scraper/examples/instagram-brand-campaign-metrics), é um possível ponto de partida. Uma Task é uma configuração de entrada salva. As configurações salvas não foram conferidas por meio de uma conta autenticada, e a Task não foi executada. Confira a entrada por conta própria antes de usar.

## 4. Mantenha os campos que explicam cada contagem

Mantenha os campos de contagem e as evidências necessárias para interpretá-los. A saída documentada inclui os campos a seguir. A presença deles no contrato não significa que todas as linhas retornadas conterão todos os valores.

| Campo | Por que mantê-lo |
| --- | --- |
| `inputUrl` | Associa uma linha retornada à URL solicitada |
| `postId` | Identifica o item de conteúdo quando disponível |
| `postUrl` | Mantém o endereço público da publicação retornado |
| `publishedAt` | Registra o momento da publicação disponível |
| `likes` | Contém a contagem pública de curtidas disponível |
| `comments` | Contém a contagem pública de comentários disponível |
| `postMetricStatus` | Descreve o estado e a precisão de cada contagem pública |
| `status` | Registra o estado da linha retornada |
| `statusReason` | Preserva o motivo informado para esse estado |
| `scrapedAt` | Registra quando a linha retornada foi coletada |

A precisão descreve o quanto uma contagem é exata. Conforme a documentação, `postMetricStatus` pode distinguir entre precisão exata, arredondada, indisponível e desconhecida. Ele também registra se uma métrica está presente, está indisponível ou não teve tentativa de coleta.

Leia os registros de curtidas e comentários separadamente. Uma linha pode ter um valor utilizável para uma contagem e nenhum valor para a outra. Portanto, uma linha retornada não basta para comprovar que ambas as contagens são utilizáveis.

Deixe vazias as contagens ausentes. Digite zero somente quando a fonte realmente fornecer zero. Uma célula vazia significa que você não tem esse valor. Zero significa que a contagem observada é zero.

Mantenha os valores arredondados identificados como arredondados. Não apresente como exato um total calculado com valores arredondados. Se precisar de um total formado apenas por valores exatos, selecione as linhas com precisão exata documentada e informe essa regra.

Acrescente suas próprias colunas ao relatório para a decisão sobre inclusão no mês, as evidências de publicação e a nota de cobertura. Essas verificações são feitas por você. Não as descreva como análises produzidas pelo Actor.

Curtidas e comentários públicos são contagens, não uma contagem de pessoas únicas. Este método não fornece alcance privado, salvamentos, compartilhamentos ou uma separação entre atividade paga e orgânica. Orgânica é a atividade não atribuída à publicidade paga. Se o pedido exigir registros exclusivos do titular, solicite a fonte adequada ao titular em vez de preencher essas colunas com contagens públicas.

## 5. Associe cada publicação solicitada à saída

A conciliação consiste em associar sua lista solicitada às linhas retornadas. Comece pela lista para que um resultado ausente continue visível.

Para cada publicação solicitada:

1. Procure uma correspondência por `inputUrl`, pelo `postId` conferido ou pelo `postUrl` retornado.
2. Leia `status` e `statusReason` quando houver uma linha.
3. Confirme a decisão sobre inclusão no mês com base nas evidências conferidas.
4. Examine curtidas e comentários separadamente, incluindo os estados dessas métricas.
5. Mantenha o valor real de `scrapedAt`.
6. Mantenha uma linha no relatório mesmo quando nenhuma contagem utilizável tiver sido retornada.

Se uma publicação não tiver uma linha retornada, preserve sua identidade solicitada a partir da lista. Não invente um estado do Actor nem uma data e hora de coleta. Registre a ausência do resultado em uma nota sua no relatório.

| Condição | Tratamento na planilha |
| --- | --- |
| Curtidas e comentários são utilizáveis | Manter ambos os valores e as evidências de sua qualidade |
| Curtidas são utilizáveis e comentários estão ausentes | Manter as curtidas; deixar os comentários em branco |
| Contagens indisponíveis | Manter a linha da publicação e o motivo informado |
| Nenhuma linha correspondente foi retornada | Manter a publicação solicitada e indicar o resultado ausente |
| A data de publicação continua desconhecida | Manter a candidata em revisão |
| Identidade duplicada ou resultados divergentes | Resolver a correspondência antes de contar a publicação |

Um limite baixo demais pode deixar itens solicitados sem processamento. Mesmo um limite suficiente não comprova que todas as contagens estavam disponíveis. Leia as evidências retornadas em vez de tratar a quantidade de linhas de saída como prova de sucesso.

Preserve as linhas de origem ao resolver uma divergência. O arquivo entregue deve ter uma linha de contagens por publicação, com evidências suficientes para explicar cada decisão.

## 6. Exporte e examine a planilha

Exporte as colunas selecionadas para CSV ou use a exportação para planilha da plataforma. CSV significa valores separados por vírgulas. É um arquivo de texto que armazena dados em linhas e colunas.

Importe os IDs das publicações como texto. Eles identificam publicações; não são quantidades para cálculo. Mantenha o fuso horário junto à data e hora. Não remova o fuso ao formatar as células de data.

Confira o arquivo importado antes de calcular:

1. Examine a primeira e a última linha para conferir o alinhamento das colunas.
2. Compare cada identidade solicitada com as linhas entregues.
3. Confirme que as publicações indisponíveis continuam presentes.
4. Confira se as células de contagem vazias não viraram zero.
5. Confira se os IDs continuam como texto e se as datas e horas continuam legíveis.
6. Confirme que as informações sobre a qualidade das métricas foram preservadas na exportação.

Se for difícil ler `postMetricStatus` em uma única célula da planilha, crie colunas separadas para a qualidade de curtidas e comentários. Copie para elas o estado e a precisão documentados. Mantenha os valores de origem disponíveis para que outra pessoa possa conferir seu resumo.

Defina quais linhas podem entrar em cada cálculo. Essas são as linhas elegíveis. O denominador é o número pelo qual você divide ao calcular uma média. A média é o total dividido pela quantidade de linhas elegíveis.

Informe separadamente a quantidade de publicações com curtidas utilizáveis e a quantidade com comentários utilizáveis. Se essas quantidades forem diferentes, as médias precisarão de denominadores diferentes. Se nenhuma linha atender aos critérios, informe que o resultado está indisponível, em vez de informar zero.

## 7. Exemplo com cálculos: ficção original

Este exemplo é uma ficção original. P1, P2 e P3 são registros inventados para o leitor. Não são dados retornados pelo Actor.

A lista fictícia contém três publicações de setembro conferidas. Suas contagens foram observadas em 25 de outubro. O exemplo não fornece as datas e horas individuais de publicação, a hora da observação, um fuso horário ou registros de precisão das métricas. Ele ensina como tratar linhas ausentes e fazer os cálculos. Não é um arquivo plenamente aprovado para uso em produção.

| Publicação | Inclusão no mês de publicação | Data da observação | Curtidas | Comentários | Estado das contagens |
| --- | --- | --- | --- | --- | --- |
| P1 | Publicação de setembro conferida | 25 de outubro | 100 | 10 | Utilizáveis |
| P2 | Publicação de setembro conferida | 25 de outubro | 200 | 20 | Utilizáveis |
| P3 | Publicação de setembro conferida | 25 de outubro | `""` | `""` | Indisponíveis |

Mantenha as três linhas no CSV entregue. As células vazias de P3 indicam contagens indisponíveis. Elas não significam zero curtidas ou zero comentários.

Os cálculos para essas linhas fictícias utilizáveis são:

1. Cobertura de curtidas utilizáveis: 2 publicações de um total de 3 solicitadas.
2. Total de curtidas observadas: 100 curtidas + 200 curtidas = 300 curtidas em 2 publicações utilizáveis.
3. Média de curtidas observadas: 300 curtidas / 2 publicações utilizáveis = 150 curtidas por publicação utilizável.
4. Cobertura de comentários utilizáveis: 2 publicações de um total de 3 solicitadas.
5. Total de comentários observados: 10 comentários + 20 comentários = 30 comentários em 2 publicações utilizáveis.
6. Média de comentários observados: 30 comentários / 2 publicações utilizáveis = 15 comentários por publicação utilizável.

Uma nota adequada para o relatório é: “As duas linhas utilizáveis contêm 300 curtidas e 30 comentários observados em 25 de outubro. A lista de três publicações inclui uma linha com contagens indisponíveis.”

Não apresente 300 como o total de todas as curtidas de setembro. Esse número exclui o valor desconhecido de P3. Ele também descreve uma observação feita em outubro de publicações de setembro. Não o chame de total do fim de setembro.

Não divida 300 por 3 para informar uma média das três publicações. Esse cálculo trataria a contagem ausente como zero. A média sustentada pelos dados usa apenas as duas linhas utilizáveis.

## 8. Aprove o relatório com suas limitações

Aprove o arquivo quando cada publicação incluída tiver uma identidade conferida, uma decisão sobre inclusão no mês, um momento de observação conhecido para as contagens retornadas e um estado claro das contagens. Mantenha visíveis as candidatas sem decisão até que seja possível conferir sua inclusão.

A nota do relatório deve identificar a lista usada como fonte e sua cobertura. Ela também deve informar o momento da observação das contagens, a quantidade de linhas utilizáveis para cada métrica e a regra usada nos totais ou nas médias. Não descreva uma lista parcial de publicações conhecidas como o histórico completo da conta.

Se o pedido passar a ser sobre a atividade entre os limites do mês, use outras evidências. O [guia sobre observações salvas nos limites do mês](/pt-BR/articles/como-separar-publica%C3%A7%C3%B5es-antigas-e-novas-no-relat%C3%B3rio-mensal-do-instagram/) explica esse requisito separado. Um rótulo com o mês de publicação não transforma contagens atuais em leituras históricas.

Este é um fluxo de trabalho proposto com base em documentação pública conferida. As evidências fornecidas não incluem uma execução paga nem um resultado de confiabilidade medida. Elas sustentam a adequação documentada à etapa de coleta, não uma afirmação de que o Actor conclui ou valida o relatório por você.

## Prepare sua primeira exportação conferida

Escolha uma publicação da lista mensal conferida pelo titular da conta. Se a exportação do titular já tiver as contagens necessárias e o momento da observação, prepare a planilha com essa fonte. Caso contrário, substitua a URL de exemplo e use o [Instagram Metrics Scraper](https://apify.com/chronometrica/instagram-metrics-scraper) para solicitar uma leitura pública atual.

Confira esse primeiro resultado antes de ampliar a lista. Entregue uma linha por publicação solicitada, incluindo as indisponíveis. Dê ao arquivo um nome que indique observações atuais das publicações conhecidas do mês. Informe quantas linhas foram utilizáveis em cada cálculo.

## Fontes e leituras adicionais

- [Pergunta de leitor sobre exportar publicações de um determinado mês — publicada em 3 de fevereiro de 2025; consultada em 25 de outubro de 2026; uma pergunta pública, sem leitura autenticada](https://www.reddit.com/r/socialmedia/comments/1igv6h6/how_to_export_social_media_analytics_to_google/)
- [Versão pública compilada 1.0.35 e README do Instagram Metrics Scraper — conferidos em 25 de outubro de 2026; documentação estática de entrada e saída, sem resultado de execução](https://api.apify.com/v2/acts/chronometrica~instagram-metrics-scraper/builds/default)
- [Instagram Brand Campaign Metrics Task — conferida em 25 de outubro de 2026; somente a existência da página pública foi verificada, configurações salvas não verificadas com autenticação e Task não executada](https://apify.com/chronometrica/instagram-metrics-scraper/examples/instagram-brand-campaign-metrics)