Pular para o conteúdo principal
Pesquisar Posts é um recurso importante usado para destacar conversas no X sobre um tópico ou evento específico. Embora essa funcionalidade exista no X, esses endpoints oferecem maior flexibilidade e poder ao filtrar e ingerir Posts, ajudando você a encontrar dados relevantes para sua pesquisa com mais facilidade; criar aplicações de “escuta” quase em tempo real; ou, em geral, explorar, analisar e/ou agir sobre Posts relacionados a um tópico de interesse.  Oferecemos dois endpoints que permitem pesquisar Posts: pesquisa recente e pesquisa em todo o arquivo. Ambos esses endpoints REST compartilham um design e recursos comuns, incluindo o uso de uma única query de busca para filtrar Posts sobre um tópico específico. Essas queries de busca são criadas com um conjunto de operadores que fazem correspondência com atributos do Post e do usuário, como palavras‑chave da mensagem, hashtags e URLs. Os operadores podem ser combinados em queries com lógica booleana e parênteses para ajudar a refinar o comportamento de correspondência das queries.  Tanto os endpoints de pesquisa recente quanto os de pesquisa em todo o arquivo fornecem metadata de edição de Post. Todos os objetos de Posts criados desde 29 de setembro de 2022 incluem metadata de edição de Post, mesmo que o Post nunca tenha sido editado. Cada vez que um Post é editado, um novo ID do Post é criado. O histórico de edição de um Post é documentado por um array de IDs do Post, começando pelo ID original. Esses endpoints sempre retornarão a edição mais recente, juntamente com qualquer histórico de edição. Qualquer Post coletado após sua janela de edição de 30 minutos representará sua versão final. Para saber mais sobre a metadata de Edit Post, confira a página Edit Posts fundamentals. Depois de configurar sua query e começar a receber Posts, esses endpoints permitem navegar pelos resultados tanto por tempo quanto por intervalos de ID do Post. Isso foi projetado para atender a dois casos de uso comuns: 
  • Obter histórico: As solicitações abrangem um período de interesse, sem foco no aspecto em tempo real dos dados. Uma única solicitação é feita, e todos os dados correspondentes são entregues usando paginação conforme necessário. Este é o modo padrão para Search Posts.
  • Polling ou listening: As solicitações são feitas no modo “há novos Posts desde minha última solicitação?”. As solicitações são contínuas e, normalmente, há um caso de uso focado na “escuta” quase em tempo real de Posts de interesse.
Muitos operadores e limites de query são exclusivos do Enterprise access, o que significa que você deve usar chaves e tokens de uma App dentro de um Projeto com acesso Enterprise para utilizar a funcionalidade adicional. Você pode saber mais sobre isso nas seções de endpoint abaixo. Tanto os endpoints de pesquisa recente quanto os de pesquisa em todo o arquivo que retornam Posts contribuem para o Post cap mensal. Configuração de conta Para acessar esses endpoints, você precisará de: Saiba mais sobre como obter acesso aos endpoints da X API v2 em nosso guia de primeiros passos. O endpoint de pesquisa recente permite acessar programaticamente Posts públicos filtrados publicados na última semana e está disponível para todos os desenvolvedores que têm uma conta de desenvolvedor e estão usando chaves e tokens de um App dentro de um Projeto. Você pode autenticar suas solicitações com Contexto de Usuário do OAuth 1.0a, OAuth 2.0 App-Only ou OAuth 2.0 Authorization Code com PKCE. No entanto, se você quiser receber metrics privadas ou um detalhamento das metrics orgânicas e promovidas nos resultados do seu Post, será necessário usar o Contexto de Usuário do OAuth 1.0a ou OAuth 2.0 Authorization Code com PKCE e enviar os Access Tokens do usuário associados ao usuário que publicou o conteúdo em questão. Este endpoint pode retornar até 100 Posts por solicitação, em ordem cronológica inversa, e tokens de paginação são fornecidos para percorrer grandes conjuntos de Posts correspondentes. Ao usar um Projeto com acesso regular, você pode usar o conjunto básico de operadores e fazer consultas com até 512 caracteres. Ao usar um Projeto com acesso Enterprise, você tem acesso a operadores adicionais. Projetos com acesso Enterprise podem fazer consultas com até 4096 caracteres. Saiba mais sobre níveis de acesso. O endpoint de busca em todo o acervo da v2 está disponível apenas para Projetos com acesso Pro e Enterprise. Esse endpoint permite acessar programaticamente Posts públicos do acervo completo, desde o primeiro Post em março de 2006, com base na sua query de busca. Você pode autenticar suas solicitações para este endpoint usando OAuth 2.0 App-Only, e o App Access Token deve vir de um App que esteja em um Projeto com acesso Pro ou Enterprise. Como não é possível fazer solicitações em nome de outros usuários (Contexto de Usuário do OAuth 1.0a ou OAuth 2.0 Authorization Code com PKCE) com este endpoint, você não poderá obter metrics privadas. Este endpoint pode retornar até 500 Posts por solicitação em ordem cronológica inversa, e tokens de paginação são fornecidos para percorrer grandes conjuntos de Posts correspondentes. Observação: Se solicitar annotations por meio do parâmetro tweet.fields, o parâmetro max_results está atualmente limitado ao valor máximo de 100. Isso pode mudar no futuro, mas fique atento a essa limitação. Como este endpoint está disponível apenas para aprovados nos acessos Pro e Enterprise, você tem acesso ao conjunto completo de operators de busca e pode fazer queries com até 1024 caracteres.







Recursos de suporte Aprenda a usar o Postman para fazer solicitações Solucionar um erro Visite a página de referência da API
⌘I