Operadores de busca do Twitter em 2026
Os operadores de busca do Twitter são comandos curtos como from:, since:, min_faves: e filter:images que você digita na caixa de busca do x.com para filtrar posts por conta, data, engajamento e mídia; uma consulta comporta cerca de 22 deles.
Resposta curta: Escreva cada operador sem espaço depois dos dois-pontos, OR em maiúsculas e as datas como since:2026-10-01 until:2026-11-01: a data final fica de fora, e as duas contam em UTC. A API oficial do X renomeia vários filtros. Para rodar consultas do x.com por código como estão escritas, use o POST /search-tweets da Sorsa API: a partir de US$ 0,07 por 1.000 tweets, com 100 requisições grátis.
- Endpoint
POST /search-tweets- Tamanho da página
- cerca de 20 tweets por requisição
- Preço
- a partir de US$ 0,07 por 1.000
#Como funcionam os operadores de busca do Twitter
Um operador de busca é uma palavra-chave com dois-pontos, como from: ou lang:, ou um símbolo, como aspas ou um sinal de menos, que transforma uma busca simples no X em um filtro. Você o digita na caixa de busca do x.com ou do app, ao lado das suas palavras comuns, e o X devolve só os posts que cumprem todas as condições.
Para montar uma consulta clicando em vez de digitar, abra a ferramenta grátis Busca avançada do Twitter. Cada filtro que você define ali escreve o seu operador na consulta, e ela mostra os 20 primeiros posts encontrados. O formulário do próprio X em x.com/search-advanced cobre palavras, contas, lugares e datas, e só abre para contas logadas (Central de Ajuda do X (abre em uma nova aba)).
Sete regras decidem se uma consulta funciona:
- Um espaço significa AND:
vector databaseencontra posts que contêm as duas palavras, em qualquer ordem. - O
ORprecisa estar em maiúsculas. Um "or" em minúsculas é buscado como palavra. - Um sinal de menos na frente exclui uma palavra, uma frase ou um operador:
-crypto. - Aspas duplas combinam uma frase exata e impedem o X de corrigir a ortografia.
- Parênteses agrupam termos. O AND tem precedência sobre o OR, então
cats OR black dogsé lido comocats OR (black dogs). - Sem espaço depois dos dois-pontos:
from:nasafiltra por conta, enquantofrom: nasaquebra o operador. - Os operadores ignoram maiúsculas e minúsculas, e o X deixa de devolver resultados depois de cerca de 22 deles numa consulta.
#Todos os operadores de busca do Twitter, por aquilo que filtram
As tabelas abaixo trazem os operadores que a busca web do X aceita, agrupados pelo que filtram. O X documenta só o básico nas suas páginas de ajuda; o restante vem de anos de testes públicos reunidos na referência de Igor Brigadir no GitHub (abre em uma nova aba), então experimente um operador raro numa consulta pequena antes de um relatório depender dele.
Palavras, frases e lógica
Palavras e frases combinam com o texto do post, o nome e o handle do autor e a forma completa dos links encurtados.
| Operador | Encontra | Exemplo |
|---|---|---|
word word | Posts com as duas palavras | nasa esa |
OR | Posts com qualquer um dos termos | rust OR golang |
"phrase" | A frase exata, sem correção ortográfica | "state of the art" |
-word | Posts sem a palavra | jaguar -car |
( ) | Termos agrupados | (rust OR go) compiler |
"a * b" | Qualquer palavra no espaço, só entre aspas | "best * for startups" |
+word | A palavra exatamente como digitada | +radiooooo |
#tag | Uma hashtag | #buildinpublic |
$TICKER | Uma cashtag | $NVDA |
? | Posts que fazem uma pergunta | crm ? |
word word- Encontra
- Posts com as duas palavras
- Exemplo
nasa esa
OR- Encontra
- Posts com qualquer um dos termos
- Exemplo
rust OR golang
"phrase"- Encontra
- A frase exata, sem correção ortográfica
- Exemplo
"state of the art"
-word- Encontra
- Posts sem a palavra
- Exemplo
jaguar -car
( )- Encontra
- Termos agrupados
- Exemplo
(rust OR go) compiler
"a * b"- Encontra
- Qualquer palavra no espaço, só entre aspas
- Exemplo
"best * for startups"
+word- Encontra
- A palavra exatamente como digitada
- Exemplo
+radiooooo
#tag- Encontra
- Uma hashtag
- Exemplo
#buildinpublic
$TICKER- Encontra
- Uma cashtag
- Exemplo
$NVDA
?- Encontra
- Posts que fazem uma pergunta
- Exemplo
crm ?
Contas
Os operadores de conta recebem o handle sem o @, exceto o próprio operador de menção.
| Operador | Encontra | Exemplo |
|---|---|---|
from: | Posts escritos por uma conta | from:nasa |
to: | Respostas enviadas a uma conta | to:nasa |
@handle | Posts que mencionam uma conta | @nasa -from:nasa |
list: | Posts de membros de uma List pública, pelo ID | list:1849212213712385091 |
filter:verified | Posts de contas verificadas | robotics filter:verified |
filter:blue_verified | Posts de assinantes do X Premium | robotics filter:blue_verified |
filter:follows | Posts de contas que você segue; só no x.com logado | pricing filter:follows |
filter:social | A seleção do X da sua rede mais ampla; aba Top, logado | rust filter:social |
from:- Encontra
- Posts escritos por uma conta
- Exemplo
from:nasa
to:- Encontra
- Respostas enviadas a uma conta
- Exemplo
to:nasa
@handle- Encontra
- Posts que mencionam uma conta
- Exemplo
@nasa -from:nasa
list:- Encontra
- Posts de membros de uma List pública, pelo ID
- Exemplo
list:1849212213712385091
filter:verified- Encontra
- Posts de contas verificadas
- Exemplo
robotics filter:verified
filter:blue_verified- Encontra
- Posts de assinantes do X Premium
- Exemplo
robotics filter:blue_verified
filter:follows- Encontra
- Posts de contas que você segue; só no x.com logado
- Exemplo
pricing filter:follows
filter:social- Encontra
- A seleção do X da sua rede mais ampla; aba Top, logado
- Exemplo
rust filter:social
Engajamento
Os operadores de engajamento definem um mínimo de curtidas, reposts ou respostas, e um sinal de menos na frente transforma o mínimo em máximo. As contagens acima de cerca de 1.000 são aproximadas, então resultados perto de um limite alto podem ficar um pouco fora.
| Operador | Encontra | Exemplo |
|---|---|---|
min_faves: | No mínimo N curtidas | min_faves:100 |
min_retweets: | No mínimo N reposts | min_retweets:50 |
min_replies: | No mínimo N respostas | min_replies:20 |
-min_faves: | Menos de N curtidas | -min_faves:10 |
-min_retweets: | Menos de N reposts | -min_retweets:5 |
-min_replies: | Menos de N respostas | -min_replies:3 |
filter:has_engagement | Posts com qualquer curtida, resposta ou repost | -filter:has_engagement |
min_faves:- Encontra
- No mínimo N curtidas
- Exemplo
min_faves:100
min_retweets:- Encontra
- No mínimo N reposts
- Exemplo
min_retweets:50
min_replies:- Encontra
- No mínimo N respostas
- Exemplo
min_replies:20
-min_faves:- Encontra
- Menos de N curtidas
- Exemplo
-min_faves:10
-min_retweets:- Encontra
- Menos de N reposts
- Exemplo
-min_retweets:5
-min_replies:- Encontra
- Menos de N respostas
- Exemplo
-min_replies:3
filter:has_engagement- Encontra
- Posts com qualquer curtida, resposta ou repost
- Exemplo
-filter:has_engagement
Respostas, reposts, quotes e threads
A busca do X deixa os reposts nativos de fora por padrão e mantém as respostas, então os dois filtros de tipo mais usados são -filter:replies e include:nativeretweets.
| Operador | Encontra | Exemplo |
|---|---|---|
filter:replies | Só respostas | from:nasa filter:replies |
-filter:replies | Só posts de nível principal | -filter:replies from:nasa |
filter:self_threads | Respostas de um autor aos próprios posts | from:nasa filter:self_threads |
conversation_id: | Todos os posts de uma thread | conversation_id:2110405289047048193 |
filter:quote | Quotes | "launch" filter:quote |
quoted_tweet_id: | Quotes de um post | quoted_tweet_id:2110405289047048193 |
quoted_user_id: | Quotes de posts de uma conta, pelo ID numérico | quoted_user_id:1592041833471827968 |
include:nativeretweets | Reposts além dos posts | from:nasa include:nativeretweets |
filter:nativeretweets | Só os reposts feitos com o botão | from:nasa filter:nativeretweets |
filter:retweets | Retweets antigos no estilo "RT" e quotes | from:nasa filter:retweets |
filter:replies- Encontra
- Só respostas
- Exemplo
from:nasa filter:replies
-filter:replies- Encontra
- Só posts de nível principal
- Exemplo
-filter:replies from:nasa
filter:self_threads- Encontra
- Respostas de um autor aos próprios posts
- Exemplo
from:nasa filter:self_threads
conversation_id:- Encontra
- Todos os posts de uma thread
- Exemplo
conversation_id:2110405289047048193
filter:quote- Encontra
- Quotes
- Exemplo
"launch" filter:quote
quoted_tweet_id:- Encontra
- Quotes de um post
- Exemplo
quoted_tweet_id:2110405289047048193
quoted_user_id:- Encontra
- Quotes de posts de uma conta, pelo ID numérico
- Exemplo
quoted_user_id:1592041833471827968
include:nativeretweets- Encontra
- Reposts além dos posts
- Exemplo
from:nasa include:nativeretweets
filter:nativeretweets- Encontra
- Só os reposts feitos com o botão
- Exemplo
from:nasa filter:nativeretweets
filter:retweets- Encontra
- Retweets antigos no estilo "RT" e quotes
- Exemplo
from:nasa filter:retweets
Mídia e links
Os filtros de mídia combinam com o que está anexado a um post; os de link combinam com aquilo para onde ele aponta. Todo operador card_name: só volta cerca de 7 dias, enquetes incluídas: card_name:poll2choice_text_only encontra enquetes de texto com duas opções.
| Operador | Encontra | Exemplo |
|---|---|---|
filter:media | Qualquer imagem, vídeo ou GIF | #nyc filter:media |
filter:images | Imagens, as de links incluídas | #nyc filter:images |
filter:twimg | Imagens enviadas ao X | #nyc filter:twimg |
filter:videos | Qualquer vídeo, links do YouTube incluídos | keynote filter:videos |
filter:native_video | Vídeos enviados ao X | keynote filter:native_video |
card_name:animated_gif | GIFs | monday card_name:animated_gif |
filter:spaces | Links para X Spaces | ai filter:spaces |
filter:links | Qualquer link, links de mídia incluídos | -filter:media filter:links |
url: | Links para um domínio; hifens viram sublinhados | url:github.com |
filter:news | Links para sites de notícias | election filter:news |
filter:hashtags | Posts com qualquer hashtag | from:nasa filter:hashtags |
filter:mentions | Posts que mencionam qualquer conta | from:nasa filter:mentions |
filter:safe | Deixa de fora posts marcados como sensíveis | anime filter:safe |
filter:media- Encontra
- Qualquer imagem, vídeo ou GIF
- Exemplo
#nyc filter:media
filter:images- Encontra
- Imagens, as de links incluídas
- Exemplo
#nyc filter:images
filter:twimg- Encontra
- Imagens enviadas ao X
- Exemplo
#nyc filter:twimg
filter:videos- Encontra
- Qualquer vídeo, links do YouTube incluídos
- Exemplo
keynote filter:videos
filter:native_video- Encontra
- Vídeos enviados ao X
- Exemplo
keynote filter:native_video
card_name:animated_gif- Encontra
- GIFs
- Exemplo
monday card_name:animated_gif
filter:spaces- Encontra
- Links para X Spaces
- Exemplo
ai filter:spaces
filter:links- Encontra
- Qualquer link, links de mídia incluídos
- Exemplo
-filter:media filter:links
url:- Encontra
- Links para um domínio; hifens viram sublinhados
- Exemplo
url:github.com
filter:news- Encontra
- Links para sites de notícias
- Exemplo
election filter:news
filter:hashtags- Encontra
- Posts com qualquer hashtag
- Exemplo
from:nasa filter:hashtags
filter:mentions- Encontra
- Posts que mencionam qualquer conta
- Exemplo
from:nasa filter:mentions
filter:safe- Encontra
- Deixa de fora posts marcados como sensíveis
- Exemplo
anime filter:safe
Idioma e app
O lang: recebe um código de idioma de duas letras e confia no palpite do próprio X, que é mais fraco em posts muito curtos.
| Operador | Encontra | Exemplo |
|---|---|---|
lang: | Posts em um idioma | ramen lang:ja |
lang:und | Posts que o X não consegue classificar, como só emoji | lang:und filter:images |
lang:qme | Posts feitos só de links de mídia | lang:qme from:nasa |
source: | Posts enviados de um app; sublinhados no lugar de espaços | source:tweetdeck |
lang:- Encontra
- Posts em um idioma
- Exemplo
ramen lang:ja
lang:und- Encontra
- Posts que o X não consegue classificar, como só emoji
- Exemplo
lang:und filter:images
lang:qme- Encontra
- Posts feitos só de links de mídia
- Exemplo
lang:qme from:nasa
source:- Encontra
- Posts enviados de um app; sublinhados no lugar de espaços
- Exemplo
source:tweetdeck
Localização
Os operadores de localização só enxergam posts que levam um lugar ou coordenadas, o que é uma parcela pequena do que as pessoas publicam, então uma consulta por localização devolve uma fatia fina da conversa.
| Operador | Encontra | Exemplo |
|---|---|---|
near: | Posts marcados perto de um lugar; aspas para duas palavras | coffee near:boston |
within: | Um raio para o near:, em km ou mi | coffee near:tokyo within:15km |
geocode: | Posts dentro de um raio a partir de coordenadas | geocode:40.7128,-74.0060,5km |
place: | Posts marcados com o ID de um lugar do X | place:96683cc9126741d1 |
near:- Encontra
- Posts marcados perto de um lugar; aspas para duas palavras
- Exemplo
coffee near:boston
within:- Encontra
- Um raio para o
near:, em km ou mi - Exemplo
coffee near:tokyo within:15km
geocode:- Encontra
- Posts dentro de um raio a partir de coordenadas
- Exemplo
geocode:40.7128,-74.0060,5km
place:- Encontra
- Posts marcados com o ID de um lugar do X
- Exemplo
place:96683cc9126741d1
Os operadores de data e hora vêm a seguir, numa seção própria.
#Como buscar no Twitter por data
Para buscar no X por data, acrescente since: com o primeiro dia e until: com o dia seguinte ao último, os dois na forma YYYY-MM-DD: o since: inclui a sua data, o until: para no início da sua data, e os dois dias começam à meia-noite UTC.
-
Comece pelo assunto ou pela conta.
"solar eclipse", oufrom:nasapara os posts de uma conta. -
Acrescente o primeiro dia.
since:2026-10-01inclui 1º de outubro. -
Acrescente o dia seguinte ao último.
until:2026-11-01cobre todo o mês de outubro, porque o próprio 1º de novembro fica de fora. -
Leia a aba Latest. Ela lista todas as correspondências em ordem de tempo; a Top mostra uma seleção ranqueada.
A consulta inteira fica from:nasa since:2026-10-01 until:2026-11-01. Um dia é since:2026-10-15 until:2026-10-16. No formulário de busca avançada do X, os campos From e To em Dates escrevem os mesmos dois operadores.
Bom saber
As datas seguem o UTC, não o seu relógio. O dia UTC de 15 de outubro vai das 20h de 14 de outubro às 20h de 15 de outubro em Nova York, então uma busca por essa data pega a noite anterior e perde a noite do próprio dia. Para um dia de Nova York, dê as horas em UTC:
since:2026-10-15_04:00:00_UTC until:2026-10-16_04:00:00_UTC.
Escolha uma janela abaixo e copie os operadores na forma de que precisa, para o x.com, para a Sorsa API ou para a API oficial do X.
31 dias: de 1 de outubro a 31 de outubro de 2026, da meia-noite à meia-noite UTC.
from:nasa since:2026-10-01 until:2026-11-01
from:nasa since_time:1790812800 until_time:1793491200
start_time=2026-10-01T00:00:00Z&end_time=2026-11-01T00:00:00Z
Datas entram, operadores saem: o último dia avança em um e todo horário é convertido para UTC.
Horas, tempo Unix e IDs de posts
Para janelas menores que um dia, a busca do X aceita horários e IDs de posts além de datas. Cada linha abaixo é um operador com o que ele encontra:
since:2026-10-01 # on or after a UTC date
until:2026-11-01 # before a UTC date
since:2026-10-15_14:00:00_UTC # from a time of day, in UTC
until:2026-10-15_18:00:00_UTC # before a time of day
since_time:1792072800 # from a Unix second
until_time:1792087200 # before a Unix second
within_time:2d # the last 2 days; also h, m and s
since_id:2108468174910472193 # newer than a post ID
max_id:2110405289047048193 # that post ID and older
Todo ID de post desde novembro de 2010 carrega o momento em que foi criado, e é por isso que since_id: e max_id: funcionam como limites de tempo precisos. O Conversor de ID de tweet para data grátis extrai esse horário de qualquer ID. Os operadores de data precisam de pelo menos outro termo na consulta para devolver algo.
Até quando a busca do X volta
A busca do X volta até o primeiro post público, de março de 2006, e a forma de data aceita qualquer dia desde então. Os resultados antigos ficam ralos onde posts foram apagados ou contas ficaram privadas, porque a busca do X só devolve o que é público hoje. Para ver o que uma conta publicou em um dia, use a ferramenta grátis Buscar tweets por data; para anos de resultados em massa, o nosso guia de dados históricos do Twitter cobre os backfills.
#Operadores de busca na API oficial do X
A API oficial do X v2 lê um dialeto próprio desses operadores: renomeia a maioria dos filtros, recebe as datas como parâmetros da requisição e rejeita os nomes da web min_faves: e min_retweets: com um erro 400 (referência de operadores do X (abre em uma nova aba)). A Sorsa API lê os mesmos operadores da caixa de busca do x.com, então uma consulta passa de uma para a outra sem mudar.
| O que você quer | Sorsa API e x.com | API oficial do X v2 |
|---|---|---|
| No mínimo 100 curtidas | min_faves:100 | min_likes:100 |
| No mínimo 20 reposts | min_retweets:20 | min_reposts:20 |
| No mínimo 10 respostas | min_replies:10 | min_replies:10 |
| Só outubro de 2026 | since:2026-10-01 until:2026-11-01 | parâmetros start_time, end_time |
| Os últimos 2 dias | within_time:2d | parâmetro start_time |
| Só respostas | filter:replies | is:reply |
| Só quotes | filter:quote | is:quote |
| Quotes de um post | quoted_tweet_id: | quotes_of_tweet_id: |
| Posts com imagens | filter:images | has:images |
| Posts com qualquer mídia | filter:media | has:media |
| Posts com links | filter:links | has:links |
| Autores verificados | filter:verified | is:verified |
| Reposts | Ficam de fora por padrão | Ficam de fora das buscas por palavra-chave |
| Contas que você segue | Só no x.com, logado | Nenhum operador |
Palavras, from:, to:, @, #, $, lang:, list:, url: | Os mesmos | Os mesmos |
No mínimo 100 curtidas
- Sorsa API e x.com
min_faves:100- API oficial do X v2
min_likes:100
No mínimo 20 reposts
- Sorsa API e x.com
min_retweets:20- API oficial do X v2
min_reposts:20
No mínimo 10 respostas
- Sorsa API e x.com
min_replies:10- API oficial do X v2
min_replies:10
Só outubro de 2026
- Sorsa API e x.com
since:2026-10-01 until:2026-11-01- API oficial do X v2
- parâmetros
start_time,end_time
Os últimos 2 dias
- Sorsa API e x.com
within_time:2d- API oficial do X v2
- parâmetro
start_time
Só respostas
- Sorsa API e x.com
filter:replies- API oficial do X v2
is:reply
Só quotes
- Sorsa API e x.com
filter:quote- API oficial do X v2
is:quote
Quotes de um post
- Sorsa API e x.com
quoted_tweet_id:- API oficial do X v2
quotes_of_tweet_id:
Posts com imagens
- Sorsa API e x.com
filter:images- API oficial do X v2
has:images
Posts com qualquer mídia
- Sorsa API e x.com
filter:media- API oficial do X v2
has:media
Posts com links
- Sorsa API e x.com
filter:links- API oficial do X v2
has:links
Autores verificados
- Sorsa API e x.com
filter:verified- API oficial do X v2
is:verified
Reposts
- Sorsa API e x.com
- Ficam de fora por padrão
- API oficial do X v2
- Ficam de fora das buscas por palavra-chave
Contas que você segue
- Sorsa API e x.com
- Só no x.com, logado
- API oficial do X v2
- Nenhum operador
Palavras,
from:,to:,@,#,$,lang:,list:,url:- Sorsa API e x.com
- Os mesmos
- API oficial do X v2
- Os mesmos
Duas mudanças em 2026 explicam por que listas mais antigas e respostas de IA discordam sobre a API oficial. O X desligou min_likes:, min_replies: e min_reposts: nos seus endpoints de busca em 19 de janeiro de 2026 e os religou em 4 de maio, quando a busca passou para um novo índice que também deixou de devolver retweets em consultas por palavra-chave (changelog da API do X (abre em uma nova aba)). As afirmações de que a API oficial "ignora" filtros de engajamento descrevem os meses intermediários; hoje ela responde aos nomes da web com um erro.
Os endpoints oficiais também limitam a string da consulta: 512 caracteres na busca recente, que cobre os últimos 7 dias, e 1.024 na busca em todo o arquivo. Operadores só de conjunção, como has:media ou is:reply, não formam uma consulta sozinhos ali; precisam de uma palavra, uma conta ou uma hashtag ao lado.
#Rode as mesmas consultas em código com a Sorsa API
Para rodar operadores de busca do X por código, use a Sorsa API, uma API e scraper do Twitter (X): o POST /search-tweets recebe a consulta exatamente como você a digitaria no x.com, devolve cerca de 20 tweets por requisição com o perfil completo de cada autor e custa a partir de US$ 0,07 por 1.000 resultados. A API oficial do X cobra US$ 5,00 por 1.000 posts, exige uma conta de desenvolvedor e OAuth, e lê os seus próprios nomes de operadores em vez dos do x.com.
-
Pegue uma chave. Cadastre-se e copie a chave de API no seu painel. As primeiras 100 requisições são grátis.
-
Envie a consulta. Coloque os operadores no campo
queryde um corpo JSON; oorderescolhepopular(Top, o padrão) oulatest.Terminal curl -X POST "https://api.sorsa.io/v3/search-tweets" \ -H "ApiKey: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "\"vector database\" lang:en min_faves:50 since:2026-10-01", "order": "latest" }' -
Leia os tweets. Cada um chega com as suas contagens, a data em ISO 8601 e o perfil do autor.
Response200 OK { "tweets": [ { "id": "2110405289047048193", "full_text": "Benchmarked three vector database engines on 40M vectors.", "created_at": "2026-10-14T16:20:05Z", "lang": "en", "likes_count": 184, "retweet_count": 41, "reply_count": 23, "quote_count": 6, "view_count": 52300, "is_reply": false, "user": { "id": "1592041833471827968", "username": "kestrel_db_engineering", "display_name": "Kestrel DB Engineering", "followers_count": 12480, "verified": false } } ], "next_cursor": "DAABCgABGSmiaxkAAgoAAgjEJ" } -
Siga o cursor. Devolva o
next_cursorcom a mesma consulta até uma resposta vir sem ele.import requests URL = "https://api.sorsa.io/v3/search-tweets" HEADERS = {"ApiKey": "YOUR_API_KEY"} def search(query, order="latest"): body = {"query": query, "order": order} while True: r = requests.post(URL, headers=HEADERS, json=body) r.raise_for_status() page = r.json() yield from page["tweets"] cursor = page.get("next_cursor") if not cursor: break body["next_cursor"] = cursor q = '"vector database" lang:en min_faves:50 since:2026-10-01' for tweet in search(q): print(tweet["created_at"], tweet["user"]["username"])
Um 403 significa que a chave está ausente ou sem requisições, e um 429 significa mais de 20 requisições em um segundo; requisições com falha nunca são cobradas. A referência do POST /search-tweets (abre em uma nova aba) lista todos os campos, e o nosso guia da API de busca do Twitter cobre como consultar uma busca em intervalos regulares.
O custo de um trabalho de busca acompanha o número de resultados. A Sorsa API cobra por requisição, cerca de 20 resultados cada, enquanto a API oficial do X cobra cada post que devolve:
| Resultados de busca | Sorsa API, a partir de | API oficial do X |
|---|---|---|
| 1.000 | US$ 0,07 | US$ 5,00 |
| 100 mil | US$ 7 | US$ 500 |
| 1 milhão | US$ 70 | US$ 5.000 |
1.000
- Sorsa API, a partir de
- US$ 0,07
- API oficial do X
- US$ 5,00
100 mil
- Sorsa API, a partir de
- US$ 7
- API oficial do X
- US$ 500
1 milhão
- Sorsa API, a partir de
- US$ 70
- API oficial do X
- US$ 5.000
As suas 100 requisições grátis cobrem cerca de 2.000 resultados de busca, então um primeiro teste de qualquer consulta acima não custa nada.
#Consultas de busca prontas
Estas consultas cobrem as buscas que as pessoas mais fazem; cada uma funciona na caixa de busca do x.com e no campo query da Sorsa API como está escrita. Troque pelas suas palavras, contas e datas. No x.com, o endereço de uma página de resultados guarda a consulta, então um favorito salva a busca, e um &f=live no fim do endereço abre a aba Latest.
# What people say about a brand, without its own posts
("acme cloud" OR @acme_cloud_status) -from:acme_cloud_status -filter:replies
# Questions in a niche that nobody has answered yet
("any recommendations" OR "what do you use") crm ? -min_replies:1 lang:en
# The most liked posts on a topic this month
"vector database" min_faves:200 -filter:replies since:2026-10-01
# One account's posts on a subject in October 2026
from:kestrel_db_engineering benchmark since:2026-10-01 until:2026-11-01
# Complaints about a competitor
@brightpath_analytics (broken OR outage OR refund OR "not working")
# Every reply in one thread
conversation_id:2110405289047048193
# Quote posts of one post
quoted_tweet_id:2110405289047048193
# Images under a hashtag, original posts only
#buildinpublic filter:images -filter:replies
# Posts that link to your site, from other accounts
url:acmecloud.dev -from:acme_cloud_status
# Hiring posts with links, from the last 2 days
(hiring OR "we're hiring") "rust engineer" filter:links within_time:2d
Para acompanhar todos os posts que marcam uma conta, com filtros de curtidas, respostas e data na própria requisição, veja o nosso guia da API de menções do Twitter.
#Por que uma busca não devolve nada
Quando uma consulta volta vazia, a causa costuma estar na sintaxe, não no X. Confira primeiro:
- Um espaço depois dos dois-pontos, um
orem minúsculas, ou uma data que não está escrita comoYYYY-MM-DD. - A data final. O
until:deixa o próprio dia de fora, entãountil:2026-10-31perde o dia 31 de outubro. - A aba Top. A Top ranqueia e corta resultados; mude para a Latest, ou envie
"order": "latest"à Sorsa API. - Contas privadas. Contas protegidas e suspensas nunca aparecem na busca, para ninguém.
- Alcance curto. O
card_name:cobre cerca dos últimos 7 dias, e os filtros de localização só enxergam posts marcados. - Operadores demais. Passando de cerca de 22, divida a consulta em duas e una os resultados.
- Hifens no
url:. Escrevaurl:t_mobile.compara t-mobile.com. - Palavras que o X lê como filtros. Buscar photo ou video pode virar um filtro de mídia; coloque a palavra entre aspas.
- Nomes da API oficial.
has:media,is:replyemin_likes:pertencem à API oficial do X; no x.com e na Sorsa API usefilter:media,filter:repliesemin_faves:.
Cinco pares causam a maior parte dos resultados errados:
| Estes dois | A diferença |
|---|---|
to: e @ | O to: encontra respostas à conta; o @ encontra qualquer post que a marque |
filter:retweets e filter:nativeretweets | Retweets antigos em texto "RT" e quotes, contra reposts feitos com o botão |
filter:nativeretweets e include:nativeretweets | Só os reposts, contra reposts somados aos resultados normais |
filter:images e filter:twimg | Qualquer imagem, as de links incluídas, contra imagens enviadas ao X |
min_faves: e min_likes: | O mesmo mínimo: o nome do x.com e o nome da API oficial do X |
to:e@- A diferença
- O
to:encontra respostas à conta; o@encontra qualquer post que a marque
filter:retweetsefilter:nativeretweets- A diferença
- Retweets antigos em texto "RT" e quotes, contra reposts feitos com o botão
filter:nativeretweetseinclude:nativeretweets- A diferença
- Só os reposts, contra reposts somados aos resultados normais
filter:imagesefilter:twimg- A diferença
- Qualquer imagem, as de links incluídas, contra imagens enviadas ao X
min_faves:emin_likes:- A diferença
- O mesmo mínimo: o nome do x.com e o nome da API oficial do X
Nenhum operador lista as contas que curtiram um post, e nenhum busca mensagens privadas ou contas protegidas. A busca cobre o que é público no X hoje.
#Busque no X com operadores a partir do seu código
Os operadores de busca do Twitter transformam uma busca por palavra-chave em um filtro preciso, e a mesma consulta que funciona no x.com roda em código pela Sorsa API como está escrita. Monte a consulta na caixa de busca ou na ferramenta Busca avançada do Twitter e depois envie-a ao POST /search-tweets: cerca de 20 tweets por requisição, qualquer data até 2006, 20 requisições por segundo em todos os planos e a partir de US$ 0,07 por 1.000 resultados. As suas primeiras 100 requisições são grátis.
#FAQ
O X ainda tem busca avançada em 2026?
Sim. O formulário de busca avançada do X, em x.com/search-advanced, ainda abre para contas logadas, e a caixa de busca na web e no app ainda aceita operadores digitados, como from:, since: e min_faves:. Os operadores de engajamento também voltaram à API oficial do X em 4 de maio de 2026, com os nomes min_likes:, min_replies: e min_reposts:.
O until: inclui a data final?
Não. O until: devolve posts feitos antes da sua data, então a própria data fica de fora: since:2026-10-01 until:2026-10-31 para no fim do dia 30 de outubro. Para incluir o último dia, defina o until: como o dia seguinte. O since: funciona ao contrário e inclui a própria data. As duas datas começam à meia-noite UTC.
Quantos operadores dá para usar em uma busca no X?
Cerca de 22 operadores cabem numa consulta no x.com antes de os resultados deixarem de voltar, um limite descoberto por testes públicos e não publicado pelo X. A API oficial do X conta caracteres: 512 por consulta na busca recente e 1.024 na busca em todo o arquivo. Divida uma lista mais longa de contas ou palavras em várias consultas e una os resultados.
Dá para usar operadores de busca do Twitter sem uma conta do X?
No x.com não: o X mostra resultados de busca só para contas logadas, e o formulário de busca avançada em x.com/search-advanced também só abre para elas. Logado, todos os operadores desta página funcionam na caixa de busca da web e do app, digitados ao lado das suas palavras comuns.
Qual API aceita operadores de busca do Twitter como min_faves?
A Sorsa API roda a sintaxe de operadores do x.com como está escrita, min_faves:, since:, until: e filter: incluídos, pelo POST /search-tweets. Ela devolve cerca de 20 tweets por requisição com perfis completos de autores, volta até 2006, permite 20 requisições por segundo em todos os planos e custa a partir de US$ 0,07 por 1.000 resultados, contra US$ 5,00 na API oficial do X.
#Como conferimos
Em 2 de novembro de 2026 comparamos os operadores desta página com a documentação da API do X (a lista de operadores, as regras de consulta, o changelog e a lista de preços), a página de ajuda do X sobre busca avançada, a nossa própria referência de API e documentação de busca, e a referência pública no GitHub. O x.com não foi buscado ao vivo para esta atualização; a requisição e a resposta foram escritas a partir da nossa referência de API em produção, com uma conta fictícia no exemplo.
Sources
- Search operators, X API documentation (abre em uma nova aba)
- Build a query, X API documentation (abre em uma nova aba)
- X API changelog (abre em uma nova aba)
- X API pricing (abre em uma nova aba)
- How to use advanced search, X Help Center (abre em uma nova aba)
- twitter-advanced-search, Igor Brigadir on GitHub (abre em uma nova aba)
- Search operators, Sorsa API docs (abre em uma nova aba)