Pular para o conteúdo

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 database encontra posts que contêm as duas palavras, em qualquer ordem.
  • O OR precisa 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 como cats OR (black dogs).
  • Sem espaço depois dos dois-pontos: from:nasa filtra por conta, enquanto from: nasa quebra 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.
Anatomy of an X search query with six operators "vector database" from:kestrel_db_engineering lang:en Palavras esta frase exata Conta posts escritos por ela Idioma só inglês min_faves:50 -filter:replies since:2026-10-01 until:2026-11-01 Curtidas 50 ou mais Tipo de post sem respostas Período 1 a 31 de outubro de 2026, em UTC
Uma consulta, seis trabalhos. Cada operador estreita os resultados, e todos precisam combinar para um post voltar.

#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.

OperadorEncontraExemplo
word wordPosts com as duas palavrasnasa esa
ORPosts com qualquer um dos termosrust OR golang
"phrase"A frase exata, sem correção ortográfica"state of the art"
-wordPosts sem a palavrajaguar -car
( )Termos agrupados(rust OR go) compiler
"a * b"Qualquer palavra no espaço, só entre aspas"best * for startups"
+wordA palavra exatamente como digitada+radiooooo
#tagUma hashtag#buildinpublic
$TICKERUma cashtag$NVDA
?Posts que fazem uma perguntacrm ?
  • 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.

OperadorEncontraExemplo
from:Posts escritos por uma contafrom:nasa
to:Respostas enviadas a uma contato:nasa
@handlePosts que mencionam uma conta@nasa -from:nasa
list:Posts de membros de uma List pública, pelo IDlist:1849212213712385091
filter:verifiedPosts de contas verificadasrobotics filter:verified
filter:blue_verifiedPosts de assinantes do X Premiumrobotics filter:blue_verified
filter:followsPosts de contas que você segue; só no x.com logadopricing filter:follows
filter:socialA seleção do X da sua rede mais ampla; aba Top, logadorust 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.

OperadorEncontraExemplo
min_faves:No mínimo N curtidasmin_faves:100
min_retweets:No mínimo N repostsmin_retweets:50
min_replies:No mínimo N respostasmin_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_engagementPosts 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.

OperadorEncontraExemplo
filter:repliesSó respostasfrom:nasa filter:replies
-filter:repliesSó posts de nível principal-filter:replies from:nasa
filter:self_threadsRespostas de um autor aos próprios postsfrom:nasa filter:self_threads
conversation_id:Todos os posts de uma threadconversation_id:2110405289047048193
filter:quoteQuotes"launch" filter:quote
quoted_tweet_id:Quotes de um postquoted_tweet_id:2110405289047048193
quoted_user_id:Quotes de posts de uma conta, pelo ID numéricoquoted_user_id:1592041833471827968
include:nativeretweetsReposts além dos postsfrom:nasa include:nativeretweets
filter:nativeretweetsSó os reposts feitos com o botãofrom:nasa filter:nativeretweets
filter:retweetsRetweets antigos no estilo "RT" e quotesfrom: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.

OperadorEncontraExemplo
filter:mediaQualquer imagem, vídeo ou GIF#nyc filter:media
filter:imagesImagens, as de links incluídas#nyc filter:images
filter:twimgImagens enviadas ao X#nyc filter:twimg
filter:videosQualquer vídeo, links do YouTube incluídoskeynote filter:videos
filter:native_videoVídeos enviados ao Xkeynote filter:native_video
card_name:animated_gifGIFsmonday card_name:animated_gif
filter:spacesLinks para X Spacesai filter:spaces
filter:linksQualquer link, links de mídia incluídos-filter:media filter:links
url:Links para um domínio; hifens viram sublinhadosurl:github.com
filter:newsLinks para sites de notíciaselection filter:news
filter:hashtagsPosts com qualquer hashtagfrom:nasa filter:hashtags
filter:mentionsPosts que mencionam qualquer contafrom:nasa filter:mentions
filter:safeDeixa de fora posts marcados como sensíveisanime 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.

OperadorEncontraExemplo
lang:Posts em um idiomaramen lang:ja
lang:undPosts que o X não consegue classificar, como só emojilang:und filter:images
lang:qmePosts feitos só de links de mídialang:qme from:nasa
source:Posts enviados de um app; sublinhados no lugar de espaçossource: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.

OperadorEncontraExemplo
near:Posts marcados perto de um lugar; aspas para duas palavrascoffee near:boston
within:Um raio para o near:, em km ou micoffee near:tokyo within:15km
geocode:Posts dentro de um raio a partir de coordenadasgeocode:40.7128,-74.0060,5km
place:Posts marcados com o ID de um lugar do Xplace: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.

  1. Comece pelo assunto ou pela conta. "solar eclipse", ou from:nasa para os posts de uma conta.

  2. Acrescente o primeiro dia. since:2026-10-01 inclui 1º de outubro.

  3. Acrescente o dia seguinte ao último. until:2026-11-01 cobre todo o mês de outubro, porque o próprio 1º de novembro fica de fora.

  4. 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.

since: includes its date, until: leaves its date out, both at midnight UTC since:2026-10-15 inclui 15 out until:2026-10-18 exclui 18 out UTC 14 out 15 out 16 out 17 out 18 out 19 out Nova York 14 out 15 out 16 out 17 out 18 out 19 out A janela cobre 15, 16 e 17 out em UTC. Um dia em Nova York em outubro começa às 04:00 UTC, então a mesma consulta começa às 20h de 14 out em Nova York.
since: abre a janela à meia-noite UTC da sua data; until: a fecha à meia-noite UTC da sua data, então esse dia fica de fora.

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.

Caixa de busca do x.com e Sorsa API
from:nasa since:2026-10-01 until:2026-11-01
A mesma janela em segundos Unix
from:nasa since_time:1790812800 until_time:1793491200
Parâmetros da API oficial do X
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:

Date, time and ID operators
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ê querSorsa API e x.comAPI oficial do X v2
No mínimo 100 curtidasmin_faves:100min_likes:100
No mínimo 20 repostsmin_retweets:20min_reposts:20
No mínimo 10 respostasmin_replies:10min_replies:10
Só outubro de 2026since:2026-10-01 until:2026-11-01parâmetros start_time, end_time
Os últimos 2 diaswithin_time:2dparâmetro start_time
Só respostasfilter:repliesis:reply
Só quotesfilter:quoteis:quote
Quotes de um postquoted_tweet_id:quotes_of_tweet_id:
Posts com imagensfilter:imageshas:images
Posts com qualquer mídiafilter:mediahas:media
Posts com linksfilter:linkshas:links
Autores verificadosfilter:verifiedis:verified
RepostsFicam de fora por padrãoFicam de fora das buscas por palavra-chave
Contas que você segueSó no x.com, logadoNenhum operador
Palavras, from:, to:, @, #, $, lang:, list:, url:Os mesmosOs 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.

  1. Pegue uma chave. Cadastre-se e copie a chave de API no seu painel. As primeiras 100 requisições são grátis.

  2. Envie a consulta. Coloque os operadores no campo query de um corpo JSON; o order escolhe popular (Top, o padrão) ou latest.

    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"
      }'
    
  3. 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"
    }
    
  4. Siga o cursor. Devolva o next_cursor com 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 buscaSorsa API, a partir deAPI oficial do X
1.000US$ 0,07US$ 5,00
100 milUS$ 7US$ 500
1 milhãoUS$ 70US$ 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.

Search queries
# 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 or em minúsculas, ou uma data que não está escrita como YYYY-MM-DD.
  • A data final. O until: deixa o próprio dia de fora, então until:2026-10-31 perde 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:. Escreva url:t_mobile.com para 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:reply e min_likes: pertencem à API oficial do X; no x.com e na Sorsa API use filter:media, filter:replies e min_faves:.

Cinco pares causam a maior parte dos resultados errados:

Estes doisA diferença
to: e @O to: encontra respostas à conta; o @ encontra qualquer post que a marque
filter:retweets e filter:nativeretweetsRetweets antigos em texto "RT" e quotes, contra reposts feitos com o botão
filter:nativeretweets e include:nativeretweetsSó os reposts, contra reposts somados aos resultados normais
filter:images e filter:twimgQualquer 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:retweets e filter:nativeretweets

    A diferença
    Retweets antigos em texto "RT" e quotes, contra reposts feitos com o botão
  • filter:nativeretweets e include:nativeretweets

    A diferença
    Só os reposts, contra reposts somados aos resultados normais
  • filter:images e filter:twimg

    A diferença
    Qualquer imagem, as de links incluídas, contra imagens enviadas ao X
  • min_faves: e min_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.

Pela equipe da Sorsa API. Construímos e operamos a Sorsa API, a API e scraper somente leitura do Twitter (X), em produção desde 2022 (antiga TweetScout API), com mais de 6 bilhões de requisições atendidas. Sobre a Sorsa API

O que mudou
  • Reescrito do zero: operadores reagrupados em tabelas, uma seção de busca por data vinda do guia de busca por data que foi retirado, com um construtor de janela de datas, uma tabela de três vias para o x.com, a Sorsa API e a API oficial do X conferida com o changelog do X, receitas de consultas e correções.
  • Primeira publicação.