O Filtered Stream prioriza a hidratação e entrega de dados, com aproximadamente 6-7 segundos de latência P99. Para requisitos de latência menor, veja Powerstream.
Visão geral
Entrega em quase tempo real
Receba Posts em segundos após a publicação
Regras persistentes
Adicione e remova regras sem desconectar
Operadores poderosos
Corresponda a palavras-chave, hashtags, usuários e muito mais
Entrega via webhook
Opcionalmente receba Posts via webhooks
Como funciona
- Crie regras — Defina regras de filtro usando operadores
- Conecte-se ao stream — Estabeleça uma conexão HTTP persistente
- Receba Posts — Obtenha Posts correspondentes em quase tempo real
Endpoints
Níveis de acesso
Contato para Enterprise
Obtenha limites mais altos e recursos adicionais
Alguns operadores exigem tiers específicos. O operador semântico
embedding: está disponível apenas para o Filtered Stream em planos Enterprise com acesso ao tier Embedding. O acesso Pay-per-use padrão inclui apenas os operadores core.Criando regras
As regras usam os mesmos operadores que as queries de busca:Exemplos de regras
Criar uma regra
Aprenda a sintaxe de regras e os operadores
Conectando-se ao stream
Estabeleça uma conexão HTTP persistente para receber Posts:Sinais keep-alive
O stream envia linhas em branco (\r\n) a cada 20 segundos para manter a conexão. Se você não receber dados ou um keep-alive por 20 segundos, reconecte.
Lidando com desconexões
Reconecte com elegância
Consumindo dados de streaming
Processe Posts com eficiência
Entrega via webhook
Em vez de manter uma conexão persistente, você pode receber Posts via webhooks:Entrega via webhook
Configure a entrega via webhook para o filtered stream
Edições de Post
O stream entrega Posts editados com seu histórico de edições. Cada edição cria um novo Post ID:Fundamentos de edição de Posts
Saiba mais sobre edições de Posts
Introdução
Pré-requisitos
- Uma conta de desenvolvedor aprovada
- Um Project e App no Developer Console
- O Bearer Token do seu App
Quickstart
Conecte-se ao stream em minutos
Criar uma regra
Aprenda a sintaxe de regras
Referência de operadores
Todos os operadores disponíveis
Código de exemplo
Exemplos de código funcionais
Tópicos avançados
Lidando com desconexões
Reconecte com elegância
Capacidade de alto volume
Lide com alto throughput
Recuperação e redundância
Construa aplicações resilientes
Correspondência de Posts retornados
Identifique quais regras corresponderam