Pular para o conteúdo principal
O grupo de endpoints do stream filtrado permite que desenvolvedores filtrem um stream de Posts públicos. A funcionalidade desse grupo inclui vários endpoints que permitem criar e gerenciar regras e aplicá‑las para filtrar um stream de Posts que retornará Posts públicos correspondentes. Esse grupo de endpoints permite que os usuários acompanhem tópicos e eventos específicos, monitorem a conversa em torno de competições, entendam como as tendências se desenvolvem e muito mais. Os desenvolvedores podem usar o endpoint de regras REST para adicionar e remover regras em uma conexão de stream persistente sem precisar desconectar. Essas regras podem ser criadas com operadores que fazem correspondência com atributos do Post, como palavras‑chave, hashtags e URLs. Operadores e cláusulas de regras podem ser combinados com lógica booleana e parênteses para refinar o comportamento de correspondência do filtro. Depois de adicionar um conjunto de regras, é possível estabelecer uma conexão de streaming que começará a entregar objetos Post em formato JSON por meio de uma conexão HTTP Streaming persistente. Você só receberá conteúdo que corresponda às suas regras enquanto estiver conectado ao stream. Como alternativa, você pode vincular o Filtered Stream a um webhook para entrega como eventos de webhook. Para mais detalhes sobre o uso de webhooks com o Filtered Stream, consulte a introdução ao Filtered Stream Webhooks. O endpoint de busca filtrada oferece suporte a Posts editados. Esse endpoint entregará Posts editados que correspondam a um ou mais dos seus filtros, junto com seu histórico de edições, incluindo um array de IDs do Post. Para Posts sem histórico de edições, esse array conterá um único ID. Para Posts que foram editados, esse array conterá vários IDs, organizados em ordem ascendente, refletindo a sequência das edições, com a versão mais recente na última posição do array. Para saber mais sobre como funcionam as edições de Post, consulte a página Fundamentos de edições de Posts. Certos aspectos do endpoint do stream filtrado são limitados por nível de acesso: Acesso Pro
  • 1000 regras por projeto
  • 100 solicitações a cada 15 minutos ao usar o endpoint POST /2/tweets/search/stream/rules para adicionar regras
  • Pode usar todos os operadores ao criar sua regra
  • Pode criar regras com até 1024 caracteres
Acesso Enterprise
  • 25.000+ regras por projeto
  • Pode usar todos os operadores ao criar sua regra
  • Pode criar regras com até 2048 caracteres
  • Solicite acesso Enterprise aqui
Os Posts retornados do stream filtrado contam para o Post cap mensal.
Configuração de contaPara acessar esses endpoints, você precisará de:Saiba mais sobre como obter acesso aos endpoints da X API v2 em nosso guia de Introdução.
⌘I