O que é a Sorsa API?
A Sorsa API é uma API REST somente leitura para dados públicos do X (Twitter). Ela cobre 41 endpoints de perfis de usuário, posts, busca avançada, seguidores e seguidos, Listas, Artigos no X, Spaces, trending topics e verificação de ações, e retorna JSON limpo. Do seu lado, toda a configuração é uma única chave de API da Sorsa, sem pedido de conta de desenvolvedor no X. O preço é fixo por requisição, a partir de US$ 0,02 por 1.000 tweets, e toda conta nova começa com 100 requisições grátis. A Sorsa está em produção desde 2022, primeiro como TweetScout API.
Preciso de uma conta de desenvolvedor do X, ou da minha própria conta no X, para usar a Sorsa?
Não. A única credencial de que você precisa é uma chave de API da Sorsa, emitida na hora em que você cria a conta. Você não envia pedido de desenvolvedor ao X, não passa por um fluxo OAuth nem espera numa fila de aprovação, e nunca compartilha com a Sorsa o seu login ou os seus cookies do X. Crie uma conta, copie a chave no painel, envie-a no header ApiKey e a sua primeira requisição funciona em poucos minutos.
Quais dados posso obter e o que fica de fora?
A Sorsa API retorna dados públicos do X: perfis de usuário (um por vez ou 100 por lote), listas de seguidores e seguidos (200 por página), posts por ID (100 por lote), timelines completas de usuários, respostas, quotes, quem deu retweet, busca por palavra-chave e por menção com todos os operadores da busca avançada, Listas, Artigos no X, Spaces, trending topics por localização, dados de "Sobre esta conta" como o país da conta, e verificações que confirmam se um usuário seguiu, deu retweet, fez quote ou respondeu. Fica de fora: contas protegidas, DMs, quem curtiu um post, as curtidas ou os itens salvos de um usuário, posts apagados e qualquer ação de escrita, como postar, curtir, seguir ou enviar mensagens. A Sorsa é somente leitura por design. A lista completa de endpoints está na referência da API.
Qual é a diferença entre a Sorsa e a API oficial do X?
A Sorsa cobra por requisição; a API oficial do X cobra por recurso. No X, cada post, perfil e seguidor de uma resposta é cobrado separadamente: cerca de US$ 5,00 por 1.000 leituras de posts, mais US$ 10,00 pelos perfis dos autores, e as leituras têm teto de 2 milhões de posts por mês. Na Sorsa, uma requisição retorna até 100 tweets ou 200 perfis com os dados do autor incluídos, então 1.000 tweets saem a partir de US$ 0,02, um custo até 50x menor em cargas de leitura intensa. Do seu lado, uma única chave de API da Sorsa substitui o OAuth e o pedido de desenvolvedor. A contrapartida é que a Sorsa é somente leitura: postar, DMs e outras ações de escrita continuam na API oficial. Para migrar passo a passo, veja o guia de migração.
Como a Sorsa se compara a outras APIs de terceiros e scrapers do X?
Em três pontos. O preço é fixo por requisição, sem cobrança por item, e os endpoints em lote retornam até 100 tweets ou 200 perfis em uma única requisição; é assim que a Sorsa chega a US$ 0,02 por 1.000 tweets, enquanto APIs que cobram por item costumam custar várias vezes mais. A cobertura inclui o que muitas alternativas deixam de fora: verificação de follows, retweets, quotes e respostas, Artigos no X, Spaces e dados de "Sobre esta conta", como o país da conta. E a Sorsa é um serviço gerenciado: o esquema de resposta continua estável e, quando o X muda a plataforma, o ajuste é feito por nós, não no seu código.
Os dados são em tempo real?
Sim. Cada requisição é atendida ao vivo no momento da chamada, então contagens de seguidores, métricas de engajamento e resultados de busca refletem o X naquele instante, e não uma cópia em cache. O tempo mediano de resposta fica em torno de 300 ms. A Sorsa não oferece firehose de streaming nem webhooks; o monitoramento em tempo real funciona com consultas periódicas (polling) de até 20 requisições por segundo, incluídas em todos os planos. A única exceção é a verificação de shadowban, cujo resultado fica em cache por uma hora para cada usuário.
Até onde vai o histórico dos dados?
Até o primeiro post de uma conta. As timelines de usuário são paginadas por todo o histórico de postagens, sem o teto de 3.200 tweets, e a busca aceita os operadores since: e until: com datas desde 2006, então dá para obter posts antigos de qualquer palavra-chave, hashtag ou conta. As contagens de engajamento voltam como estão no momento da requisição. As listas de seguidores e seguidos refletem o grafo atual; a Sorsa não guarda registros históricos de quem seguia quem. Para métodos e código, veja o guia de dados históricos do X.
Quais são os rate limits?
20 requisições por segundo em todos os planos, do Starter ao Enterprise, com todos os endpoints incluídos e sem limitação de velocidade nos planos menores. Como uma requisição pode retornar até 100 tweets ou 200 perfis, isso chega a 2.000 tweets ou 4.000 perfis por segundo antes da paginação. Os planos diferem apenas no volume mensal: 10.000, 100.000 ou 500.000 requisições. Acima disso, planos personalizados vêm com um rate limit dedicado maior; fale com vendas para configurar o seu.
O que acontece quando o X muda alguma coisa?
Nada muda para você. Quando o X altera a plataforma, a equipe da Sorsa cuida da atualização, o esquema de resposta continua o mesmo e a sua integração segue funcionando sem mudanças no código. Essa é a diferença prática entre um serviço mantido e um script próprio ou uma biblioteca open source que você precisa consertar sozinho a cada atualização do X. A Sorsa está em produção desde 2022, e a página de status pública mostra o uptime e a latência ao vivo.
A Sorsa é um produto oficial do X?
Não. A Sorsa é um serviço independente e não é afiliada, endossada nem patrocinada pela X Corp; X e o logo do X são marcas registradas da X Corp. Você acessa dados públicos do X pela API e pelo painel da Sorsa, conforme os Termos de serviço, e continua responsável por usar, armazenar e compartilhar esses dados de acordo com as leis que se aplicam a você e ao seu projeto, incluindo as regras de privacidade que protegem as pessoas cujos posts você processa. Nada nesta página é aconselhamento jurídico.
Como integrar a Sorsa API e quais linguagens e ferramentas de IA ela suporta?
Qualquer linguagem que consiga enviar uma requisição HTTP. A Sorsa API é REST simples: coloque a sua chave no header ApiKey, envie JSON e receba JSON, sem precisar de SDK. Há guias para Python, Node.js, Go, PHP, n8n, Make e Zapier. Para projetos com ajuda de IA, cole a URL única da documentação no Claude Code, no Cursor, no ChatGPT ou no Codex e deixe o modelo escrever o cliente, ou instale o servidor sorsa-mcp pelo npm para dar ao Claude e a outros clientes MCP dados do X ao vivo, diretamente. A maioria das integrações, incluindo migrações da API oficial do X, leva menos de duas horas.
Quanto custa e posso testar de graça?
A partir de US$ 0,02 por 1.000 tweets e US$ 0,01 por 1.000 perfis em planos de preço fixo, em que uma chamada à API sempre conta como uma requisição em qualquer endpoint. Toda conta nova começa com 100 requisições grátis, o suficiente para até 10.000 tweets ou 20.000 perfis, sem cartão e sem prazo de validade. Os planos pagos vão de 10.000 a 500.000 requisições por mês, com cobrança mensal ou anual (o anual economiza 16%), pagamento por cartão ou cripto, e podem ser cancelados a qualquer momento. Os detalhes de cada plano e uma calculadora de custos estão na página de preços.
Que suporte e que uptime vocês oferecem?
O suporte funciona por tickets: abra um no seu painel e a equipe responde por lá, com documentação completa e uma página de status pública à disposição. A partir de 1 milhão de requisições por mês, você pode pedir um gerente de conta pessoal, que resolve suas dúvidas mais rápido. O uptime se mantém em 99,9% desde 2022, sem grandes quedas em produção, e a latência mediana fica em torno de 300 ms. Quando o X muda a plataforma, o ajuste é feito pela Sorsa, então a maioria das equipes quase nunca precisa abrir um ticket.