API do Grok vs API do Twitter para dados do X

#O que o Grok consegue obter do X e o que ele devolve

O Grok só lê posts públicos do X por uma ferramenta de busca: a página de modelos (abre em uma nova aba) da xAI diz que o Grok não tem conhecimento de eventos atuais nem de dados além do que havia nos seus dados de treinamento, que no grok-4.7 terminam em maio de 2026. No app do Grok a busca roda sozinha. Pela API da xAI, você mesmo a ativa, e a ferramenta se chama X Search (x_search).

Isso coloca o Grok do lado das respostas de uma linha que todo construtor de agentes conhece. Nosso guia da API do Twitter para agentes de IA cobre o outro lado: ferramentas que devolvem dados do X a um modelo como JSON simples.

Uma requisição com o X Search ativo é uma chamada à Responses API da xAI, aqui pelo SDK da OpenAI apontado para api.x.ai:

import os

from openai import OpenAI

grok = OpenAI(api_key=os.environ["XAI_API_KEY"],
              base_url="https://api.x.ai/v1")
resp = grok.responses.create(
    model="grok-4.7",
    input="What are developers saying about MCP this week?",
    tools=[{"type": "x_search"}],
)
print(resp.output_text)

Por trás dessa única chamada, o modelo roda quantas buscas achar necessárias. A documentação do X Search (abre em uma nova aba) lista quatro funções que ele pode chamar: busca por palavra-chave com os operadores de busca do X, busca semântica por significado, busca de usuários e uma busca de thread que traz um post com seus pais e respostas. Você pode restringi-lo a no máximo 20 handles, ou excluir 20, e definir um intervalo de datas em YYYY-MM-DD.

O que volta é o texto do modelo, os links que ele citou e duas contagens de uso, x_posts_fetched e x_users_fetched. Os posts em si ficam dentro da requisição: não há lista de registros, nem um conjunto estável de campos, nem um cursor para a página seguinte. A própria documentação da xAI avisa que os resultados variam porque o modelo escolhe as próprias consultas. A antiga Live Search API também acabou: o guia dela agora redireciona para a Web Search.

#O X Search do Grok vs uma API de dados do X, lado a lado

O X Search foi feito para responder a uma pergunta, e uma API de dados do X foi feita para devolver registros, então os dois mais divergem onde um trabalho precisa de todos os posts correspondentes, de números exatos ou do mesmo resultado duas vezes. Em cada uma dessas linhas as APIs de dados vencem, e a Sorsa API faz isso por uma pequena fração do preço por post das outras duas.

• O que volta

  Sorsa API

  registros JSON, 41 campos por post com o autor

  X Search da xAI (Grok)

  a resposta do modelo com links

  API oficial do X

  registros JSON, os campos que você pedir

• Quem escolhe os posts

  Sorsa API

  você, com uma consulta e operadores do X

  X Search da xAI (Grok)

  o modelo, com as próprias consultas

  API oficial do X

  você

• Todos os resultados, página a página

  Sorsa API

  sim, next_cursor até ficar vazio

  X Search da xAI (Grok)

  não: o modelo para quando tem uma resposta

  API oficial do X

  sim, com tokens de página

• Mesma requisição, mesmos posts

  Sorsa API

  sim

  X Search da xAI (Grok)

  não: os resultados variam a cada execução

  API oficial do X

  sim

• Até onde volta no tempo

  Sorsa API

  até 2006

  X Search da xAI (Grok)

  um intervalo de datas que você define

  API oficial do X

  até 2006 com busca no arquivo completo

• Preço por 1.000 posts

  Sorsa API

  a partir de US$ 0,07

  X Search da xAI (Grok)

  US$ 5,00 mais tokens

  API oficial do X

  US$ 5,00; US$ 15,00 com autores a partir de 22 de nov. de 2026

• Preço por 1.000 perfis

  Sorsa API

  a partir de US$ 0,014

  X Search da xAI (Grok)

  US$ 10,00

  API oficial do X

  US$ 10,00

• O que você precisa

  Sorsa API

  uma chave de API em um header

  X Search da xAI (Grok)

  uma chave de API da xAI

  API oficial do X

  uma conta de desenvolvedor, OAuth ou bearer token, créditos pré-pagos

Os preços da API oficial do X vêm da sua tabela de preços de pagamento por uso (abre em uma nova aba), que também limita as leituras a 3 milhões de posts por mês; acima disso, o X só vende contratos Enterprise a partir de cerca de US$ 42 mil por mês. O aviso do X de 23 de outubro (abre em uma nova aba) acrescenta que, a partir de 22 de novembro de 2026, os autores e as mídias devolvidos com os posts também são cobrados como leituras, então um resultado de busca com o autor passa de US$ 0,005 para US$ 0,015.

Bom saber

Pedir ao Grok para "devolver os posts em JSON" não transforma a resposta dele em registros. O modelo escreve esse JSON a partir do que leu, e é ele quem decide quantos posts ler. Guarde os IDs de posts que ele cita e busque os registros por ID quando os números importarem: o POST /tweet-info-bulk (abre em uma nova aba) da Sorsa API devolve até 100 posts por chamada, a partir de US$ 0,014 por 1.000.

#Quanto custam 10 mil, 100 mil e 1 milhão de posts

Ler 1 milhão de posts custa US$ 5.000 mais tokens pelo X Search do Grok, US$ 5.000 na API oficial do X (US$ 15.000 com o autor de cada post a partir de 22 de novembro) e a partir de US$ 70 na Sorsa API. A diferença se mantém em qualquer tamanho, porque o X Search e a API oficial do X cobram por post, enquanto a Sorsa API cobra por requisição e cada requisição de busca devolve cerca de 20 posts.

Os tokens não mudam a comparação. Seja qual for o caminho que traz os posts, o Grok cobra a leitura dele à tarifa do grok-4.7 de US$ 2,00 por milhão de tokens de entrada e US$ 6,00 por milhão de tokens de saída, como na página de preços da API (abre em uma nova aba) da xAI. Se um post enxuto dá cerca de 60 tokens, 1.000 posts acrescentam cerca de US$ 0,12 de entrada, pouco ao lado dos US$ 5,00 pelos posts.

O X Search tem três regras de cobrança que fazem uma pergunta custar mais do que parece:

• Cada item buscado é cobrado, não cada item citado: posts pais, posts citados e todos os posts de uma thread buscada contam a US$ 5 por 1.000.
• As contagens não são deduplicadas. Um post que duas buscas devolvem é cobrado duas vezes.
• O modelo define o volume. Você pode limitar as rodadas de busca e ler x_posts_fetched depois, mas não consegue fixar o número de posts antes da chamada.

Uma assinatura do Grok ou do X não cobre nada disso. A página de planos (abre em uma nova aba) diz que os planos pagos incluem acesso à API, mas que o uso da API é cobrado separadamente às tarifas padrão dos modelos e não sai da cota de uso do plano.

#Como dar posts brutos do X ao Grok com a Sorsa API

Para dar posts brutos ao Grok, busque-os em uma API de dados do X, guarde os campos de que a sua pergunta precisa e passe-os ao grok-4.7 no prompt, sem a ferramenta X Search, para que o Grok leia exatamente os posts que você escolheu. Para essa busca, use a Sorsa API, uma API e scraper do Twitter (X): um header ApiKey e nenhum OAuth, cerca de 20 posts com o perfil completo do autor por chamada de busca, a partir de US$ 0,07 por 1.000, a 20 requisições por segundo em todos os planos.

1. Obtenha duas chaves. Crie sua conta e copie sua chave da Sorsa API em SORSA_API_KEY; coloque a sua chave da xAI em XAI_API_KEY. As duas ficam no seu servidor.

2. Busque os posts. POST /search-tweets (abre em uma nova aba) recebe uma consulta com operadores de busca do X e devolve cerca de 20 posts por página, do mais novo para o mais antigo com "order": "latest". A busca volta até 2006.

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

   {
     "tweets": [
       {
         "id": "2116193940272985298",
         "full_text": "Our digest now fetches posts first, then asks Grok.",
         "created_at": "2026-10-30T15:42:07Z",
         "lang": "en",
         "likes_count": 64,
         "retweet_count": 7,
         "reply_count": 12,
         "quote_count": 3,
         "view_count": 8120,
         "is_reply": false,
         "conversation_id_str": "2116193940272985298",
         "user": {
           "id": "1544001928374651904",
           "username": "maya_ships_prompts",
           "display_name": "Maya Ships Prompts",
           "followers_count": 4210,
           "verified": false
         }
       }
     ],
     "next_cursor": "DAADDAABCgABHV6x9mPAJxIKAAIdXrH2Y8"
   }
   

   Ver resposta completa

3. Busque e enxugue as páginas. A função segue o next_cursor até um orçamento de páginas e guarda seis campos por post, para que 200 posts continuem sendo um prompt curto.

   import os
   
   import requests
   
   SORSA = "https://api.sorsa.io/v3"
   HEADERS = {"ApiKey": os.getenv("SORSA_API_KEY", "YOUR_API_KEY")}
   
   
   def fetch_posts(query: str, max_pages: int = 10) -> list[dict]:
       posts, cursor = [], None
       for _ in range(max_pages):
           body = {"query": query, "order": "latest"}
           if cursor:
               body["next_cursor"] = cursor
           r = requests.post(f"{SORSA}/search-tweets", json=body,
                             headers=HEADERS, timeout=30)
           r.raise_for_status()  # 403: key or quota; 429: over 20 req/s
           data = r.json()
           for t in data.get("tweets", []):
               posts.append({
                   "id": t["id"],
                   "at": t["created_at"],
                   "author": t["user"]["username"],
                   "followers": t["user"]["followers_count"],
                   "likes": t["likes_count"],
                   "text": t["full_text"][:500],
               })
           cursor = data.get("next_cursor")
           if not cursor:
               break
       return posts
   

4. Pergunte ao Grok só sobre esses posts. Envie os posts enxutos como prompt, sem tools, e peça IDs de posts na resposta.

   import json
   
   from openai import OpenAI
   
   grok = OpenAI(api_key=os.environ["XAI_API_KEY"],
                 base_url="https://api.x.ai/v1")
   
   
   def ask_grok(question: str, posts: list[dict]) -> str:
       lines = "\n".join(json.dumps(p, ensure_ascii=False) for p in posts)
       resp = grok.responses.create(
           model="grok-4.7",
           input=[
               {"role": "system", "content":
                "Answer only from the posts given. Cite post ids."},
               {"role": "user", "content": f"{question}\n\nPosts:\n{lines}"},
           ],
       )
       return resp.output_text
   
   
   posts = fetch_posts('"grok api" lang:en -filter:retweets')
   print(ask_grok("What problems do developers report?", posts))
   

Dez páginas de busca são 10 requisições e cerca de 200 posts, então o lado dos dados dessa execução custa no máximo alguns centavos em qualquer plano da Sorsa API, e é o mesmo se o Grok, o Claude ou o GPT lerem em seguida. Nosso guia da API de busca do Twitter lista os operadores que restringem uma consulta antes de ela custar qualquer coisa.

#O que as pessoas perguntam ao Grok sobre contas do X

Muitas perguntas que as pessoas digitam no Grok sobre uma conta têm uma resposta exata que uma única chamada de API devolve, como a contagem de seguidores, um ID de usuário, uma lista de seguindo ou o status de shadowban. Uma frase de um modelo sobre esses números pode estar desatualizada ou arredondada; a consulta devolve o valor como ele está no momento da chamada, em um campo que o seu código consegue ler.

• Quantos seguidores esta conta tem?

  Consulta na Sorsa API

  GET /info (abre em uma nova aba)

  O que volta

  followers_count, followings_count, tweets_count, created_at e mais 15 campos

• Qual é o ID de usuário desta conta?

  Consulta na Sorsa API

  GET /username-to-id/{user_handle} (abre em uma nova aba)

  O que volta

  o id numérico

• Quem esta conta segue?

  Consulta na Sorsa API

  GET /follows (abre em uma nova aba)

  O que volta

  até 200 contas por página, com next_cursor

• Esta conta está com shadowban?

  Consulta na Sorsa API

  GET /check-shadowban (abre em uma nova aba)

  O que volta

  is_shadowbanned e cada verificação como limpa, banida ou desconhecida

• O que esta conta postou esta semana?

  Consulta na Sorsa API

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

  O que volta

  cerca de 20 posts por página, cada um com o perfil completo do autor

Duas delas têm ferramentas gratuitas que não exigem código: o Localizador de ID do Twitter para um ID de usuário e o Teste de shadowban do Twitter para banimentos de busca. Para muitas contas de uma vez, o GET /info-batch (abre em uma nova aba) devolve 100 perfis por chamada, a partir de US$ 0,014 por 1.000 perfis, contra US$ 10,00 por 1.000 perfis pelo X Search.

#Qual usar, trabalho a trabalho

Pergunte ao Grok quando o resultado que você quer é uma frase, e use uma API de dados do X quando o resultado for os posts, uma lista ou um número; a maioria dos produtos precisa dos dois, nessa ordem: buscar, depois perguntar. Os critérios que decidem são os da tabela acima: quem escolhe os posts, se você recebe todos os resultados, se uma nova execução devolve os mesmos posts e o preço por 1.000.

• Uma pergunta avulsa sobre a conversa de hoje

  O que usar

  Grok, no app

• Todos os posts que correspondem a uma consulta, guardados no seu banco de dados

  O que usar

  Sorsa API, POST /search-tweets página a página

• Um dashboard de contagens de seguidores ou de engajamento

  O que usar

  Sorsa API, GET /info-batch e POST /tweet-info-bulk

• Os posts de uma conta ao longo de anos

  O que usar

  Sorsa API, POST /user-tweets

• Um resumo diário do que dizem sobre o seu produto

  O que usar

  Sorsa API para buscar, depois o Grok ou qualquer modelo para resumir

• Conferir os posts que uma resposta do Grok citou

  O que usar

  Sorsa API, POST /tweet-info-bulk com os IDs

Para qualquer trabalho em que os posts são o produto, a escolha é a Sorsa API: posts com todos os 41 campos a partir de US$ 0,07 por 1.000 pela busca e a partir de US$ 0,014 por 1.000 por ID, todos os resultados página a página e histórico até 2006. Ela é somente leitura e nunca pede o seu login no X, então a sua conta do X não corre nenhum risco. Para publicar ou responder, combine-a com a API oficial do X.

Agentes que rodam o Grok em um agendamento seguem a mesma regra; o guia do Hermes Agent mostra onde fica o x_search embutido nele e como trocar a fonte de dados. Todos os preços da API do X por trás destes números estão no nosso detalhamento dos preços da API do X.

#Dê ao Grok os posts que você escolher

O Grok lhe dá uma resposta sobre o X; para os posts, as contagens e o histórico por trás dela, busque-os primeiro. Com a Sorsa API isso custa a partir de US$ 0,07 por 1.000 posts em vez de US$ 5,00 pelo X Search, os posts vêm com os autores e todos os campos, e suas primeiras 100 requisições são grátis: o bastante para cerca de 2.000 posts para testar o pipeline acima.

#Perguntas frequentes