Referência da API · v1
Tudo o que uma conta do X faz, em uma única conexão
O xSignalFeed observa as contas do X (antigo Twitter) que você indicar e envia o que elas fazem no momento em que acontece: novas publicações, respostas, republicações, citações, exclusões, edições de perfil, novos seguidos e novos seguidores verificados. Você também pode observar a busca do X por uma frase e ler perfis, publicações, seguidores, listas, comunidades e tendências sob demanda. Um único WebSocket carrega os eventos; a REST existe para as vezes em que você precisa perguntar em vez de esperar.
Introdução
Há três maneiras de consumir o serviço. Monitoramento: indique contas e palavras-chave e receba eventos por WebSocket ou webhook à medida que as coisas acontecem. Histórico: releia os eventos que sua chave recebeu. Leituras: peça ao X um perfil, uma publicação, uma busca, uma lista, uma comunidade ou as tendências agora.
Os eventos se dividem em quatro famílias. Cada uma tem um único formato de payload, descrito campo a campo em Eventos.
| Categoria | Tipos | Significado |
|---|---|---|
| Publicações | tweet.create, tweet.reply, tweet.retweet, tweet.quote, tweet.edit, tweet.delete | O que a conta publica: novas publicações, respostas, republicações, citações, edições e exclusões de qualquer uma delas |
| Perfil | profile.name, profile.screen_name, profile.bio, profile.location, profile.url, profile.avatar, profile.banner, profile.pinned, profile.verified | Qualquer alteração no que a conta mostra sobre si mesma, com o valor antigo e o novo |
| Seguidos e seguidores | follow.add, follow.remove, followers.verified.add | Quem a conta começa ou para de seguir, e quais contas verificadas começam a segui-la |
| Conta | account.status | Se a conta ainda pode ser vista: protegida, suspensa, indisponível ou ativa de novo |
| Busca | search.match | Publicações de qualquer pessoa no X que correspondam a uma palavra-chave que você observa |
O acesso é por chave de API. Uma chave carrega escopos e limites que vêm do seu plano; GET /v1/account informa o que a sua pode fazer. Nada aqui é cobrado pelo volume de eventos: o streaming está incluído, e apenas as leituras sob demanda consomem créditos.
O xSignalFeed é um serviço independente de terceiros. Não é afiliado, endossado nem patrocinado pela X Corp. Lemos apenas dados públicos.
Próximos passos
Início rápido
Verifique sua chave, monitore uma conta e leia seu primeiro evento em quatro passos.
Conceitos básicos
Contas monitoradas e palavras-chave, entrega em dois quadros, pelo menos uma vez, replay.
Eventos
O envelope, todos os tipos de evento e os cinco formatos de payload, campo a campo.
Referência da API
Uma página por endpoint: parâmetros, resposta e um exemplo de requisição e de resposta.