API do Twitter no n8n sem OAuth

#O que o nó do X no n8n consegue ler

O nó do X no n8n consegue ler duas coisas: o perfil de um usuário e uma busca de posts dos últimos 7 dias. As suas outras seis operações escrevem no X. Essa lista vem da documentação do nó do X no n8n (abre em uma nova aba), e o código-fonte do nó no GitHub mostra a busca chamando o endpoint /tweets/search/recent do X, que se limita a uma semana.

• Tweet

  Operações

  Criar ou responder, apagar, curtir, retweetar

  Lê dados do X

  Não

• Tweet

  Operações

  Buscar

  Lê dados do X

  Posts dos últimos 7 dias

• Usuário

  Operações

  Obter um usuário

  Lê dados do X

  Um perfil por chamada

• Mensagem direta

  Operações

  Criar

  Lê dados do X

  Não

• Lista

  Operações

  Adicionar um membro

  Lê dados do X

  Não

Nada no nó devolve a timeline de uma conta, suas menções, seus seguidores ou os posts de uma Lista do X, e o n8n não tem nenhum nó de gatilho que dispare com um post novo.

Para sequer conectar o nó, você cria uma conta de desenvolvedor do X e um app, define suas permissões OAuth2 e a URL de callback e cola o Client ID e o Secret no n8n, como descreve a página de credenciais do X no n8n (abre em uma nova aba). Cada leitura é então cobrada pelo X de créditos pré-pagos: US$ 0,005 por post e US$ 0,010 por usuário, com o pagamento por uso limitado a 3 milhões de leituras de posts por mês, segundo a página de preços do X (abre em uma nova aba). A partir de 22 de novembro de 2026, o perfil de um autor devolvido com um post custa mais US$ 0,010, então um post com o seu autor sai por US$ 0,015 (aviso do X de 23 de outubro (abre em uma nova aba)).

#Leia dados do X no n8n com a Sorsa API

A Sorsa API, uma API e scraper do Twitter (X), se conecta ao nó HTTP Request do n8n com um header, então ler dados do X exige uma credencial e um nó. Para ler tweets, menções e seguidores no n8n, use a Sorsa API: 20 tweets ou 200 seguidores por requisição, busca desde 2006 e 20 requisições por segundo em todos os planos, sem conta de desenvolvedor e sem app OAuth.

Os passos abaixo montam uma busca por palavra-chave. Todos os outros trabalhos usam a mesma credencial e o mesmo nó com outro endpoint.

1. Obtenha uma chave de API. Cadastre-se e copie a chave do painel. As primeiras 100 requisições são grátis, não exigem cartão e nunca expiram.

2. Crie uma credencial Header Auth. No n8n, abra Credentials, crie uma nova credencial Header Auth, defina Name como ApiKey e Value como a sua chave. Assim a chave fica fora de todo workflow que você exportar ou compartilhar.

3. Adicione um nó HTTP Request. Defina Method como POST e URL como https://api.sorsa.io/v3/search-tweets. Em Authentication, escolha Generic Credential Type, depois Header Auth e depois a credencial do passo 2.

4. Envie a busca como JSON. Ative Send Body, mantenha Body Content Type em JSON e adicione dois parâmetros de corpo: query com qualquer busca do X, operadores incluídos, e order com latest ou popular. Um atalho: escolha Import cURL no nó, cole o comando abaixo e depois mova a chave do campo de header para a sua credencial.

   curl -X POST "https://api.sorsa.io/v3/search-tweets" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{"query": "n8n lang:en -filter:retweets", "order": "latest"}'
   

5. Separe os posts em itens. Adicione um nó Split Out com Fields To Split Out definido como tweets. Cada post passa então pelo workflow como um item próprio, pronto para um Filter, um nó IF, o Google Sheets ou o Slack.

   {
     "tweets": [
       {
         "id": "1985402186610352215",
         "full_text": "Our n8n flow now posts every release note to Slack.",
         "created_at": "2026-11-02T09:14:07Z",
         "lang": "en",
         "likes_count": 42,
         "retweet_count": 6,
         "reply_count": 3,
         "view_count": 2810,
         "user": {
           "id": "1592041833471827968",
           "username": "nightly_build_notes",
           "display_name": "Nightly Build Notes",
           "followers_count": 1840
         }
       }
     ],
     "next_cursor": "DAADDAABCgABG4V2Yz9W"
   }
   

   Ver resposta completa

Cada post traz o perfil completo do autor, então uma mensagem do Slack ou uma linha de planilha pode mostrar o handle e o número de seguidores sem uma segunda chamada. Uma resposta 401 significa que a chave está errada, e um 403 significa que o header está ausente ou que a conta ficou sem requisições.

#Paginação: siga o next_cursor no n8n

O nó HTTP Request consegue buscar todas as páginas sozinho: ele envia o next_cursor de cada resposta na requisição seguinte e para quando o cursor volta vazio. Um cursor é um token que aponta para a próxima página de resultados. Busca, timelines e menções devolvem cerca de 20 posts por página, e os seguidores vêm 200 por página.

Abra Options no nó HTTP Request e adicione Pagination. O painel abaixo reúne as cinco configurações que percorrem o cursor da Sorsa API; mude-o para GET em endpoints como o /followers e copie cada expressão direto para o n8n.

Bom saber

Deixe Pagination Complete When no valor padrão desligado. "Response Is Empty" nunca dispara em um objeto JSON, então o nó continua pedindo a última página até o n8n interrompê-lo com "The returned response was identical 5x", e cada uma dessas chamadas é uma requisição. A Complete Expression acima para na primeira página sem cursor.

Cada página sai do nó como um item com o seu próprio array tweets ou users. Um nó Split Out logo depois transforma todas as páginas em uma única lista plana de posts ou perfis.

#Qual endpoint para qual workflow do n8n

Cada trabalho no n8n corresponde a um endpoint da Sorsa API, e todos rodam pela mesma credencial Header Auth. A tabela lista os endpoints que os workflows do n8n mais usam; a lista completa de endpoints da Sorsa API tem todos os 45.

• Busca por palavra-chave ou hashtag

  Endpoint

  POST /search-tweets (abre em uma nova aba)

  O que você envia

  query, order

  Por requisição

  Cerca de 20 posts

• Posts de uma conta

  Endpoint

  POST /user-tweets (abre em uma nova aba)

  O que você envia

  username, type

  Por requisição

  Cerca de 20 posts

• Menções à marca

  Endpoint

  POST /mentions (abre em uma nova aba)

  O que você envia

  query (o handle), min_likes, since_date

  Por requisição

  Cerca de 20 posts

• Exportação de seguidores

  Endpoint

  GET /followers (abre em uma nova aba)

  O que você envia

  username

  Por requisição

  Até 200 seguidores

• O feed de uma Lista do X

  Endpoint

  GET /list-tweets (abre em uma nova aba)

  O que você envia

  list_id

  Por requisição

  Cerca de 20 posts

• Enriquecer uma coluna de handles

  Endpoint

  GET /info-batch (abre em uma nova aba)

  O que você envia

  usernames, repetido

  Por requisição

  Até 100 perfis

Para o /info-batch, envie usernames como um array e defina a opção Array Format in Query Parameters do nó como No Brackets, que repete o parâmetro uma vez por handle.

O construtor abaixo escreve o nó HTTP Request para o seu trabalho. Escolha um trabalho, digite uma consulta ou um handle e o número de páginas, depois copie o JSON e cole-o em um canvas do n8n com Ctrl+V ou Cmd+V.

{
  "nodes": [
    {
      "name": "Sorsa API: search-tweets",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        0,
        0
      ],
      "parameters": {
        "method": "POST",
        "url": "https://api.sorsa.io/v3/search-tweets",
        "authentication": "genericCredentialType",
        "genericAuthType": "httpHeaderAuth",
        "sendBody": true,
        "bodyParameters": {
          "parameters": [
            {
              "name": "query",
              "value": "n8n lang:en -filter:retweets"
            },
            {
              "name": "order",
              "value": "latest"
            }
          ]
        },
        "options": {
          "pagination": {
            "pagination": {
              "paginationMode": "updateAParameterInEachRequest",
              "parameters": {
                "parameters": [
                  {
                    "type": "body",
                    "name": "next_cursor",
                    "value": "={{ $response.body.next_cursor }}"
                  }
                ]
              },
              "paginationCompleteWhen": "other",
              "completeExpression": "={{ !$response.body.next_cursor }}",
              "limitPagesFetched": true,
              "maxRequests": 5,
              "requestInterval": 50
            }
          }
        }
      }
    },
    {
      "name": "One item per post",
      "type": "n8n-nodes-base.splitOut",
      "typeVersion": 1,
      "position": [
        240,
        0
      ],
      "parameters": {
        "fieldToSplitOut": "tweets",
        "options": {}
      }
    }
  ],
  "connections": {
    "Sorsa API: search-tweets": {
      "main": [
        [
          {
            "node": "One item per post",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

#Receita: posts novos de contas para o Slack

Um workflow do n8n pode enviar ao Slack todo tweet novo de um conjunto de contas com cinco nós e nenhum código: um agendamento, uma requisição de busca, Split Out, Remove Duplicates e o nó do Slack. O n8n não tem gatilho para posts novos, então o workflow pede os posts mais recentes a cada poucos minutos e descarta os que já viu.

1. Agende. Um Schedule Trigger a cada 5 minutos.

2. Peça os posts mais recentes. POST /search-tweets com from: para cada conta, unidas por OR, e order definido como latest. Uma requisição cobre todas as contas da consulta. Para centenas de contas, coloque-as em uma Lista pública do X e chame o GET /list-tweets com o seu list_id: uma requisição lê o feed de uma Lista de até 5.000 contas.

3. Separe os posts. Split Out em tweets.

4. Descarte o que já viu. Um nó Remove Duplicates com Operation definido como Remove Items Processed in Previous Executions e Keep Items Where definido como Value Is New. Arraste o campo id do post para Value to Dedupe On. Os IDs de post são únicos, então só os posts novos passam.

5. Envie a mensagem. Conecte o nó do Slack, ou o Google Sheets, ou o e-mail, e use o campo text que o workflow monta.

O construtor de nós acima escreve esse workflow inteiro. Escolha New posts alert, digite as contas a acompanhar, copie o JSON e cole-o em um canvas vazio: ele traz os passos 1 a 4 e o texto da mensagem. Escolha a sua credencial Header Auth no nó HTTP Request, adicione o seu nó do Slack no final e publique o workflow.

A primeira execução deixa passar os 20 posts mais recentes, porque o Remove Duplicates ainda não viu nada; a partir da segunda execução, só os posts novos chegam ao Slack. Um agendamento de 5 minutos roda 8.640 vezes em um mês de 30 dias, a uma requisição por execução, o que cabe nas 10 mil requisições do plano Starter. Para consultar a cada poucos segundos, Listas e alertas de palavras-chave em escala, o guia de monitoramento do Twitter em tempo real vai além.

#Receita: exportar seguidores para o Google Sheets

Uma exportação de seguidores no n8n é um nó HTTP Request no GET /followers com paginação por query, um nó Split Out em users e um nó do Google Sheets que acrescenta linhas. Cada requisição devolve até 200 perfis de seguidores, então uma conta com 50 mil seguidores leva 250 requisições e cabe em uma única execução.

1. Inicie à mão. Um Manual Trigger, já que uma lista completa é um trabalho pontual.

2. Peça os seguidores. Um nó HTTP Request com Method GET em /followers na mesma URL base, Send Query Parameters ativado e username definido como a conta. Ative a paginação como acima, com Type Query, e aumente Max Pages para o número de seguidores dividido por 200.

3. Separe os perfis. Split Out em users.

4. Acrescente à planilha. Um nó do Google Sheets com Append Row, mapeando id, username, display_name, followers_count, location e created_at para colunas.

Quando um workflow exporta várias contas, o nó HTTP Request roda uma vez por item recebido. Defina a opção Batching como 20 itens por lote com um Batch Interval de 1.000, um segundo, e o n8n fica em 20 requisições por segundo. Se uma rajada ainda encontrar um 429, ative Retry On Fail nas configurações do nó. O método completo para listas muito grandes, arquivos e peculiaridades do Excel está no guia para exportar seguidores do Twitter.

#Quanto custa ler dados do X no n8n

Ler posts pela Sorsa API no n8n custa a partir de US$ 0,07 por 1.000 tweets, contra US$ 5,00 por 1.000 posts na API oficial do X que o nó do X usa. Você paga por requisição, não por item: uma página de busca com 20 posts é uma requisição, e requisições com falha nunca são cobradas.

Os seguidores mostram a maior diferença: a partir de US$ 0,007 por 1.000 na Sorsa API contra US$ 10,00 na API oficial do X, porque a Sorsa API devolve 200 por requisição e o X cobra cada um.

• Posts de busca, timelines, menções, Listas

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 5,00

• Posts com seus autores, a partir de 22 de nov. de 2026

  Sorsa API, por 1.000

  a partir de US$ 0,07

  API oficial do X, por 1.000

  US$ 15,00

• Seguidores

  Sorsa API, por 1.000

  a partir de US$ 0,007

  API oficial do X, por 1.000

  US$ 10,00

• Perfis consultados em lotes de 100

  Sorsa API, por 1.000

  a partir de US$ 0,014

  API oficial do X, por 1.000

  US$ 10,00

O preço é uma de cinco coisas a verificar antes de ligar uma fonte de dados do X ao n8n, e a Sorsa API atende a cada uma com um número:

• Configuração: um header em uma credencial Header Auth, contra um app de desenvolvedor, OAuth2 e uma URL de callback.
• Velocidade: 20 requisições por segundo em todos os planos, contas gratuitas incluídas.
• Cobertura: busca desde 2006, timelines, menções, seguidores e Listas, contra uma busca de 7 dias no nó do X.
• Segurança da conta: a Sorsa API nunca pede seu login nem seus cookies do X, então nenhuma conta sua do X corre risco.
• Confiabilidade: em produção desde 2022, com mais de 6 bilhões de requisições atendidas; quando o X muda alguma coisa, a Sorsa API faz a correção por conta própria, e seu workflow mantém os mesmos campos.

#Dê dados ao vivo do X a um AI Agent do n8n

Um AI Agent do n8n pode buscar no X por conta própria quando a Sorsa API é anexada a ele como ferramenta. Anexe um nó HTTP Request ao agente como ferramenta, aponte-o para o POST /search-tweets com a sua credencial Header Auth e preencha o valor query do corpo com uma expressão que chame $fromAI('query', 'An X search query with operators', 'string'). O modelo escreve então a busca sozinho, e o n8n a envia.

Na opção Optimize Response da ferramenta, mantenha apenas full_text, user.username, created_at e likes_count, para que o modelo leia posts em vez de perfis inteiros e gaste menos tokens. O guia do n8n sobre $fromAI() (abre em uma nova aba) cobre os parâmetros. Para agentes fora do n8n, como Claude ou Cursor, veja a API do Twitter para agentes de IA.

#Monte seu primeiro workflow do X no n8n

Ler dados do X no n8n se resume a um nó HTTP Request com um header de chave, o endpoint certo e um cursor que pagina até ficar vazio. Monte-o sobre a Sorsa API: um header ApiKey no lugar de um app OAuth, 20 posts ou 200 seguidores por requisição, a partir de US$ 0,07 por 1.000 tweets, e 100 requisições grátis que cobrem seus primeiros 2.000 posts.

O mesmo padrão de nó funciona em código também; o guia da API do Twitter em Python o mostra com requests.

#Perguntas frequentes