API de verificação de sorteios e concursos no Twitter
Confirme que cada participante realmente seguiu, deu retweet, citou, comentou ou entrou. Uma chamada booleana por ação. Sem OAuth, sem conta de desenvolvedor, sem teto de 100 retweets.
100 requisições grátis · Sem cartão de crédito · Não expiram
curl -X POST "https://api.sorsa.io/v3/check-retweet" \
-H "ApiKey: YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"tweet_link": "https://x.com/YourBrand/status/123", "username": "participant"}'{ "retweet": true, "user_protected": false }Como funciona
Três passos, da inscrição ao prêmio
- 1
Junte as inscrições
Recolha os @ do jeito que você já faz: um formulário, um bot ou uma planilha exportada da sua campanha.
- 2
Rode uma verificação por ação
Para cada tarefa exigida, mande o @ do participante para o endpoint correspondente e leia de volta um único booleano.
- 3
Premie quem passou
Fique só com quem passou em todas as verificações e sorteie um ganhador a partir de uma lista que você consegue defender.
O problema
Inscrição na base da confiança estraga o sorteio
@ falsos e bots
Lá pelo participante trezentos, o seu formulário já está cheio de @ falsos, tarefas pela metade e bots atrás do prêmio. A revisão manual é lenta e a caixinha marcada na base da confiança não vale nada.
Sorteadores prontos ficam devendo
A maioria dos sorteadores grátis para nos 100 retweets mais recentes, tira um ganhador e acabou. Quase nenhum verifica seguidas, citações, comentários ou campanhas de várias tarefas, inscrição por inscrição.
A API oficial não tem essa verificação
A API oficial do X não tem um endpoint direto de "esse usuário fez isso", então você acaba puxando listas inteiras de quem deu retweet e de seguidores para filtrar por conta própria.
A Sorsa API responde a única pergunta que importa, para cada participante, em uma chamada: essa pessoa fez o que disse que fez?
Um sorteador tira um ganhador da lista que ele consegue enxergar. Uma API de verificação é outra coisa: ela confirma cada participante individualmente, antes do sorteio, contra cada ação exigida, para que o ganhador do concurso seja alguém que você consegue defender.
O que dá para verificar
Cada ação da campanha, um booleano para cada
Passe o @ do participante e a ação. Receba um sim ou um não de volta. Sem OAuth, JSON puro.
| Ação | Endpoint | Devolve |
|---|---|---|
| Seguiu a sua conta | /check-follow | follow: true ou false |
| Deu retweet em um post | /check-retweet | retweet: true ou false (paginado, sem limite de 100 retweets) |
| Citou um post | /check-quoted | quoted, retweet ou not_found, com o texto da citação |
| Comentou em um post | /check-comment | commented: true ou false, com o comentário |
| Entrou na sua Comunidade do X | /check-community-member | is_member: true ou false |
| É dono do @ que informou | /user-tweets | publique um código de uso único para confirmar a posse do @ |
| Curtiu um post | não verificável | o X tornou as curtidas privadas em 2024, nenhuma API confirma uma curtida |
Vai montar o pipeline completo, com processamento em lote, regras de qualidade e pontuação? O guia de implementação percorre o fluxo inteiro com código Python funcional, ou veja a documentação de verificação.
Quer testar uma verificação sozinha na mão antes? O Follow Checker grátis roda a mesma chamada de /check-follow no navegador.
Feita para verificar
Por que os times verificam na Sorsa API
Um booleano por ação
A API oficial do X não tem endpoint de verificação direta, então você precisa puxar a lista inteira de quem deu retweet ou de seguidores e procurar dentro dela. A Sorsa API devolve a resposta em uma chamada.
Sem teto de 100 retweets
Montagens ingênuas e boa parte dos sorteadores prontos só enxergam os 100 retweets mais recentes. A Sorsa API pagina, então quem entrou cedo nunca fica de fora.
Sem OAuth e sem créditos adiantados
Um único header ApiKey. A API oficial do X exige OAuth 2.0, compra de créditos adiantada e cobra US$ 0,01 por perfil buscado, então varrer uma lista de seguidores para confirmar um participante pode custar mais que um plano inteiro da Sorsa.
Feita para escala
Preço fixo por requisição e 20 requisições por segundo verificam dezenas de milhares de inscrições da noite para o dia.
Antifraude na camada da API
/info-batch devolve 100 perfis completos por requisição, incluindo created_at, tweets_count e followers_count, para que as regras de qualidade rodem antes de gastar uma única verificação.
Barre o uso de @ alheio
Confirme que o participante é mesmo dono do @ que enviou antes de entregar o prêmio.
Comparação
Sorsa API contra a API oficial do X para verificação
| API oficial do X | A Sorsa API | |
|---|---|---|
| Verificação direta de "o usuário fez X" | Não tem, puxe a lista inteira e filtre | Uma chamada booleana por ação |
| Profundidade de retweets | Parede nos 100 mais recentes | Paginado, sem teto |
| Autenticação | OAuth 2.0 mais uma conta de desenvolvedor aprovada | Um único header ApiKey |
| Custo real em escala | Pagamento por uso: US$ 0,01 por seguidor ou perfil buscado, e as listas precisam ser puxadas inteiras | A partir de US$ 49/mês, fixo por requisição |
| Custo para confirmar uma seguida em uma conta de 50 mil seguidores | Até ~US$ 500 (puxada da lista inteira a US$ 0,01 por perfil) | US$ 0,002 (uma chamada de /check-follow no Pro) |
| Verificar curtidas | Privadas desde 2024 | Privadas desde 2024 (nenhuma ferramenta consegue) |
| Grátis para começar | Não tem | 100 requisições grátis |
Quem usa
Feita para campanhas de todo formato
- Plataformas de sorteios e concursos: verificam que cada inscrição cumpriu todas as tarefas exigidas.
- Agências de marketing de criadores: tocam campanhas de marca sem dias de revisão manual das inscrições.
- Quests e airdrops de Web3: liberam recompensas apenas com ações verificadas na plataforma.
- Programas de embaixadores e indicações: confirmam engajamento contínuo, não um retweet isolado.
- Discord e liberação de acesso: dão cargos apenas a seguidores verificados.
Preços na escala da campanha
Preço fixo que acompanha o tamanho da campanha
Uma campanha típica de 5 tarefas, mais a verificação de posse e um filtro de qualidade de perfil, dá cerca de 7 requisições por participante, por volta de US$ 0,014 no Pro. 1 requisição equivale a 1 chamada em todos os endpoints, sem conta de créditos e sem taxa por recurso.
cobrado por mês
Economize US$ 950 em relação à API oficial
- Até ~1.400 participantes verificados
- 20 req/s de rate limit
- Todos os 40 endpoints inclusos
- Crie várias chaves de API
cobrado por mês
Economize US$ 9.800 em relação à API oficial
- Até ~14.000 participantes verificados
- 20 req/s de rate limit
- Todos os 40 endpoints inclusos
- Análise de uso detalhada
cobrado por mês
Economize US$ 49.000 em relação à API oficial
- Até ~71.000 participantes verificados
- 20 req/s de rate limit
- Todos os 40 endpoints inclusos
- Suporte prioritário
Não sabe qual plano serve? Toda conta começa com 100 requisições grátis: até 10.000 tweets ou 20.000 perfis. Sem cartão, sem prazo de validade, em todos os 40 endpoints.
Vai rodar uma campanha em escala de verdade?
Planos de alto volume de 1 milhão a 10 milhões de requisições por mês, infraestrutura sob medida e linha direta com o nosso time, feito para plataformas de alto throughput que verificam inscrições em produção.
- Volume
- Acima de 500 mil requisições / mês
- Infra
- Rate limits maiores, dedicada
- Preço
- Descontos por volume e condições sob medida
- Suporte
- Gerente de conta dedicado
Perguntas frequentes
Perguntas frequentes
Verifique a sua próxima campanha em uma chamada
Pegue uma chave, passe o @ de um participante e uma ação, e receba um sim ou não verificado. Suas primeiras 100 requisições são grátis: sem cartão e sem prazo de validade.
Vai montar o pipeline de verificação por conta própria? Guia de implementação completo, com código Python.