Os limites de dados históricos das APIs referem-se ao período máximo de informações que uma API pode fornecer ao solicitar dados de uma fonte específica.
Esses limites variam conforme a plataforma e são definidos pelas políticas de retenção de dados de cada serviço. Por exemplo, algumas APIs permitem acessar dados desde o início da conta, enquanto outras limitam o histórico aos últimos meses ou anos.
Esses limites são importantes para planejar consultas e relatórios, garantindo que as informações obtidas estejam dentro do intervalo permitido pela API.
Limites por Fonte de Dados
Abaixo estão listados os diferentes limites para períodos históricos, atrasos da API e janelas recomendadas de atualização de dados disponíveis em diversas fontes de dados.
A janela de atualização determina quantos dias de dados precisam atualizados a cada execução. Em alguns casos, as APIs podem apresentar atrasos de 48 horas ou mais. Nesses cenários, é importante garantir que os dados dos últimos dias necessários sejam incluídos na atualização.
Facebook Ads
- Período Histórico: Dados de insights de anúncios limitados aos últimos 37 meses
- Janela de Atualização: Igual ao período máximo de atribuição configurado na plataforma
Facebook Insights
- Período Histórico:
- Valores de alcance orgânico não são rastreados antes de outubro de 2017
- Retém dados dos últimos 2 anos; dados mais antigos podem ser removidos
- Atraso da API: 0-4 dias
- Janela de Atualização: 5 dias
Google Ad Manager
- Período Histórico: Até 3 anos
Google AdSense
- Período Histórico: Últimos 3 anos
Google Ads
- Período Histórico: Sem limitações conhecidas, considera-se o tempo de vida da conta
- Janela de Atualização: Igual ao período máximo de atribuição configurado na plataforma
Google Analytics 4
- Período Histórico:
- Dados de nível de usuário e conversões são excluídos após 14 meses
- Dados de idade, gênero e interesses são excluídos após 2 meses
- Outros eventos podem ter retenção de 2 ou 14 meses, conforme configurado
- Janela de Atualização: 12 dias, para permitir a finalização de conversões modeladas.
- Atualização dos dados: O GA4 utiliza a atualização de dados para definir o intervalo de tempo necessário para coletar, processar e apresentar as informações da sua conta. Esse tempo de atualização pode variar, dependendo do tipo e volume de dados envolvidos. Mais informações.
Google My Business
- Período Histórico: Últimos 18 meses de dados
- Atraso da API: 2 dias
- Janela de Atualização: 3 dias
Google Search Console
- Período Histórico: Últimos 16 meses
- Atraso da API: 2 dias
- Janela de Atualização: 3 dias
Instagram
- Período Histórico:
- Postagens no perfil até 2 anos
- Stories desaparecem após 24 horas
LinkedIn Ads
- Período Histórico:
- Dados não demográficos disponíveis para os últimos 10 anos
- Dados demográficos diários disponíveis para os últimos 6 meses
- Outros dados granulares disponíveis por até 2 anos
- Atraso da API: O atraso esperado para o campo approximate Member Reach é de 24 a 48 horas. Solicitações que incluírem o dia atual no intervalo de datas retornarão alcance apenas para os dias em que os dados estiverem disponíveis. Mais informações.
- Janela de Atualização: Igual ao período máximo de atribuição configurado na plataforma
LinkedIn Company Pages
- Período Histórico: Estatísticas de compartilhamento e seguidores disponíveis por até 12 meses. Algumas métricas são acumulativas (lifetime).
- Atraso da API: 2 dias para postagens
TikTok Ads
- Período Histórico: Tempo de vida da conta
- Atraso da API: Até 48 horas para métricas relacionadas a gastos
YouTube
- Período Histórico: Sem limitações conhecidas; pode buscar dados desde o início da conta.
- Consultas de “Desempenho de Vídeos” estão limitadas aos últimos 1000 vídeos publicados
RD Station Marketing
- A API do RD Station Marketing possui diversos limites para dados históricos e recursos de acordo com o plano ativo do usuário na ferramenta. Mais informações.
Use essas informações para configurar suas consultas de maneira eficiente e garantir que as limitações específicas sejam respeitadas. Em caso de dúvidas ou problemas, entre em contato com o suporte.
