Pular para o conteúdo principal
Os endpoints de contagem de Posts da v2 permitem que os desenvolvedores entendam e obtenham o volume de data para uma determinada query. Isso pode ser útil por vários motivos, incluindo:
  • Entender o volume de Posts para uma palavra‑chave a fim de criar visualizações, como linhas de tendência.
  • Entender o período em que um evento ou conversa ocorreu, para garantir que sua query capture os dados relevantes
  • Entender quantos Posts uma query de pesquisa retornará, a fim de refinar sua query antes de usar os endpoints de pesquisa recente ou de pesquisa em arquivo completo. Observação: As contagens nem sempre corresponderão ao resultado retornado pelos endpoints de pesquisa porque esses endpoints passam por verificações adicionais de compliance pelas quais os endpoints de contagem não passam
  • Entender o tamanho da conversa em torno de um tópico, sem precisar realmente extrair os dados brutos nem consumir seus Posts no Post cap mensal.
Ao desenvolver uma query, você estará limitado a um determinado comprimento de query e a operadores específicos com base no seu nível de acesso.
  • Se você estiver usando um Projeto com acesso Pro, poderá usar todos os operadores disponíveis e queries com até 1024 caracteres de comprimento.
  • Se você estiver usando um Projeto com acesso Enterprise, poderá usar todos os operadores disponíveis e queries com até 4096 caracteres de comprimento.
Você também pode especificar a granularidade (que pode ser dia, hora ou minuto), bem como o período para o qual você precisa das contagens de Posts (usando os parâmetros start_time e end_time). A granularidade de tempo padrão que este endpoint usa é hora, o que significa que, se você não especificar o parâmetro de granularidade, o endpoint fornecerá as contagens de Posts por hora dos últimos 7 dias.
Configuração da contaPara acessar esses endpoints, você precisará de:Saiba mais sobre como obter acesso aos endpoints da X API v2 em nosso guia de primeiros passos.

Contagens de Posts recentes

O endpoint de contagens de Posts recentes permite recuperar, de forma programática, o número de Posts para uma query nos últimos sete dias. Este endpoint está disponível para qualquer pessoa que utilize chaves e tokens associados a uma App dentro de um Projeto e utiliza OAuth 2.0 App-Only para autenticação.

Contagens de Posts do arquivo completo

O endpoint de contagem de Posts do arquivo completo permite recuperar programaticamente o número de Posts para uma query em todo o arquivo de Posts públicos. Atualmente, esse endpoint está disponível apenas para quem foi aprovado para Academic Research ou acesso Enterprise e utiliza o OAuth 2.0 App-Only para autenticação. Exemplo: você pode usar o endpoint de contagem de Posts do arquivo completo para ver o número de Posts com a hashtag #SOSHurricaneHarvey por dia entre agosto e setembro de 2017. Observação: o endpoint de contagem pagina a cada 31 dias por resposta. Por exemplo, ao definir a granularidade de dia, será retornada a contagem de resultados por dia para 31 dias por página. Ao definir a granularidade de hora, será retornada a contagem de resultados por hora para 744 horas (31 dias x 24 horas) por página. Se você não especificar a granularidade e o período, esse endpoint fornecerá contagens de Posts por hora para uma query nos últimos 30 dias.
I