Como buscar no Twitter por localização

#Como buscar no Twitter por localização

Você pode buscar no X por localização de três jeitos, todos na caixa de busca comum do x.com ou no app do X, e cada um funciona melhor ao lado de uma palavra-chave como "power outage" ou "concert". Se o que você precisa é saber onde uma conta está baseada, e não o que as pessoas publicam de um lugar, essa é outra pergunta: o Localizador de conta do Twitter grátis lê o rótulo "Account based in" do X de qualquer conta pública.

Para encontrar posts de um lugar:

1. Ative Perto de você. Busque uma palavra-chave, abra os filtros de busca (a coluna da direita no desktop, o ícone de filtro ao lado da barra de busca no app) e escolha Perto de você. O X então usa a localização do seu dispositivo, segundo a Central de Ajuda do X (abre em uma nova aba).

2. Digite near: com um raio. "street food" near:"Mexico City" within:10km pede posts ligados a esse lugar. Coloque aspas em nomes de duas ou mais palavras e dê o within: em km ou mi.

3. Digite geocode: com coordenadas. "power outage" geocode:30.2672,-97.7431,25km traça um círculo de 25 km em torno do centro de Austin. A latitude vem primeiro, depois a longitude, depois o raio, sem espaços.

Depois abra a aba Latest. A página Search Recommendations (abre em uma nova aba) do X diz que a Latest devolve os posts encontrados em ordem de tempo, sem ranking, enquanto a Top escolhe candidatos pela sua própria localização e pelos seus interesses. Um desenvolvedor no fórum do X encontrou o filtro geocode: funcionando na Latest, mas não na Top, em 2025.

O formulário de busca avançada do X, em x.com/search-advanced, também tem um campo Places que acrescenta o lugar à sua consulta.

#O que o X considera a localização de um post

O X liga um post a um lugar de duas formas: a marcação de lugar que o autor adiciona e a localização digitada no perfil do autor. As duas são opcionais, então uma busca por localização cobre só a parte da conversa que leva uma delas.

• A marcação de lugar. Um autor pode marcar um post com uma área geral ou, em algumas cidades, um local do Foursquare ou do Yelp; posts dos apps de iOS e Android também podem levar coordenadas de GPS (Central de Ajuda do X (abre em uma nova aba)). Estudos anteriores a 2019 contaram cerca de 0,85% dos tweets com coordenadas (Sloan e Morgan, PLOS ONE (abre em uma nova aba)), e o Twitter removeu a geotag precisa dos posts comuns em junho de 2019 (Nieman Lab (abre em uma nova aba)).
• A localização do perfil. O campo de texto livre de um perfil. O dicionário de dados (abre em uma nova aba) do X diz que ela "may be fuzzily evaluated when performing searches with location queries" (pode ser avaliada de forma aproximada em buscas com consultas de localização), então "Austin, TX" numa bio pode puxar os posts desse autor para uma busca em Austin.

Duas coisas nunca fazem um post combinar. O país "Account based in" de um perfil, que o X deduz de endereços IP, não participa da busca por localização, segundo o kit de investigação da Bellingcat (abre em uma nova aba). Uma cidade citada no texto combina só como palavra-chave: near:"Austin, TX" não encontra um post que apenas diga "Austin".

A janela de 7 dias

As localizações de perfil só contam para posts recentes. Nos testes da Bellingcat (abre em uma nova aba), o X usou as localizações de perfil por cerca de 7 a 8 dias; os resultados mais antigos traziam só posts com marcação de lugar, então o volume recente parecia muito maior.

#Operadores de busca por localização, com exemplos

A busca do X lê cinco operadores de localização. Cada um fica ao lado das suas palavras-chave, sem espaço depois dos dois-pontos, e pode ser combinado com todos os outros operadores, datas incluídas.

• near:

  O que encontra

  Posts ligados a um lugar com nome; aspas para duas palavras

  Exemplo

  jazz near:"New Orleans"

• within:

  O que encontra

  Um raio para o near:, em km ou mi

  Exemplo

  jazz near:"New Orleans" within:5mi

• geocode:

  O que encontra

  Posts dentro de um raio a partir de um ponto: latitude, longitude, raio

  Exemplo

  "heat wave" geocode:51.5072,-0.1276,20km

• near:me

  O que encontra

  Posts perto da sua própria localização; só no x.com logado e no app

  Exemplo

  "lost dog" near:me

• place:

  O que encontra

  Posts marcados com um lugar do X, pelo ID

  Exemplo

  place:96683cc9126741d1 (os Estados Unidos)

A API oficial do X não aceita esses operadores: ela responde ao near: com um erro de operador inválido e lista os seus próprios operadores de localização na referência de operadores de busca (abre em uma nova aba). São o place: com um nome ou ID de lugar, o place_country: com um código de duas letras, o point_radius: e o bounding_box: com coordenadas, e o has:geo para qualquer post com dados geográficos. Todos combinam apenas com posts que levam uma marcação de lugar ou coordenadas.

A ordem dos números se inverte entre as duas famílias. O geocode: recebe a latitude primeiro (geocode:40.7128,-74.0060,10km), enquanto o point_radius: recebe a longitude primeiro (point_radius:[-74.0060 40.7128 10km]). Troque-os e Nova York vira um ponto na Antártida, com zero resultados e nenhum erro.

O construtor abaixo escreve todas as formas a partir de um único lugar, confere as coordenadas e dá o corpo da requisição para código.

Para os filtros de data, engajamento e mídia que se combinam com estes, veja a lista completa de operadores de busca do Twitter. Para montar uma consulta clicando, a ferramenta grátis Busca avançada do Twitter escreve near: e within: a partir dos campos Near city e Within radius.

#near: e geocode: ainda funcionam em 2026?

O X ainda aceita near:, within: e geocode:, mas não documenta nenhum deles, e os resultados mudaram durante 2026. Teste cada consulta antes de montar um relatório ou um painel sobre ela.

O que foi relatado este ano:

• 3 de março de 2026. O post de um pesquisador de OSINT, visto 13,5 mil vezes, dizia que as buscas com geocode: tinham parado de funcionar desde 25 de fevereiro (abre em uma nova aba).
• 23 de maio de 2026. Um usuário do Reddit contornou o filtro Perto de você quebrado com o geocode:, escrevendo que ele funciona com coordenadas decimais simples e um raio, sem N, S, E ou W.
• 1º de junho de 2026. Um desenvolvedor no fórum do X (abre em uma nova aba) chamou o filtro geocode de "currently dead" (morto no momento).

Para conferir se uma consulta de localização funciona hoje, rode duas buscas na aba Latest: a sua palavra-chave com o operador de localização e a mesma palavra-chave sem ele. Se as duas devolverem os mesmos posts, o X ignorou o operador. Se a busca com o operador devolver posts, abra os perfis de alguns autores para ver se a marcação de lugar ou a localização do perfil combina.

Bom saber

Uma busca por localização vazia não significa que ninguém publicou daquele lugar. Significa que nenhum post levou uma marcação de lugar no seu recorte e nenhum autor recente listou uma cidade correspondente, ou que o X pulou o operador. Busque a seguir os nomes do lugar, como mostra a seção depois do código.

#Busque posts por localização com a Sorsa API

Para buscas por localização em código, use o POST /search-tweets (abre em uma nova aba) da Sorsa API: ele aceita as mesmas consultas near:, within: e geocode: do x.com, devolve cerca de 20 posts por requisição e coloca o perfil completo de cada autor, location incluída, dentro de cada post. Custa a partir de US$ 0,07 por 1.000 posts, e a Sorsa API nunca pede o seu login do X, então a sua própria conta nunca corre risco.

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

2. Envie a consulta. Coloque a consulta de localização em query e peça latest, a ordem sem ranking.

   curl -X POST "https://api.sorsa.io/v3/search-tweets" \
     -H "ApiKey: YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
       "query": "\"power outage\" near:\"Austin, TX\" within:25km",
       "order": "latest"
     }'
   

   {
     "tweets": [
       {
         "id": "1985120440187539712",
         "full_text": "Whole block on South Congress is dark again",
         "created_at": "2026-11-01T22:14:09Z",
         "lang": "en",
         "likes_count": 14,
         "reply_count": 3,
         "retweet_count": 2,
         "view_count": 1820,
         "user": {
           "id": "1630221874001645568",
           "username": "southcongress_grid_log",
           "display_name": "SoCo Grid Log",
           "location": "Austin, TX",
           "followers_count": 412
         }
       }
     ],
     "next_cursor": "DAADDAABCgABG4z1bJ9W0DsKAAIbjPVs"
   }
   

   Ver resposta completa

3. Percorra os resultados. Devolva o next_cursor no corpo até a resposta não trazer nenhum.

4. Confira a localização de cada autor. Mantenha os posts cujo user.location cita o seu lugar e guarde o texto bruto para ver o que combinou.

   import re
   import requests
   
   URL = "https://api.sorsa.io/v3/search-tweets"
   HEADERS = {"ApiKey": "YOUR_API_KEY"}
   QUERY = '"power outage" near:"Austin, TX" within:25km'
   PLACE = re.compile(r"\b(austin|atx|travis county)\b", re.I)
   
   
   def search(query, max_pages=10):
       body = {"query": query, "order": "latest"}
       for _ in range(max_pages):
           r = requests.post(URL, headers=HEADERS, json=body, timeout=30)
           r.raise_for_status()
           page = r.json()
           yield from page.get("tweets", [])
           cursor = page.get("next_cursor")
           if not cursor:
               break
           body["next_cursor"] = cursor
   
   
   for t in search(QUERY):
       where = t["user"].get("location") or ""
       tag = "profile" if PLACE.search(where) else "other"
       print(tag, t["created_at"], t["user"]["username"], repr(where))
   

   const URL = "https://api.sorsa.io/v3/search-tweets";
   const headers = {
     ApiKey: "YOUR_API_KEY",
     "Content-Type": "application/json",
   };
   const place = /\b(austin|atx|travis county)\b/i;
   const body = {
     query: '"power outage" near:"Austin, TX" within:25km',
     order: "latest",
   };
   
   for (let page = 0; page < 10; page++) {
     const res = await fetch(URL, {
       method: "POST",
       headers,
       body: JSON.stringify(body),
     });
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
     const data = await res.json();
     for (const t of data.tweets ?? []) {
       const where = t.user?.location ?? "";
       const tag = place.test(where) ? "profile" : "other";
       console.log(tag, t.created_at, t.user?.username, where);
     }
     if (!data.next_cursor) break;
     body.next_cursor = data.next_cursor;
   }
   

Um 403 significa que a chave está ausente ou sem requisições; um 429 significa mais de 20 requisições em um segundo, então espere um segundo e tente de novo. Requisições com falha nunca são cobradas. Para todos os outros parâmetros de busca e para execuções de milhares de páginas, veja o guia da API de busca do Twitter.

#Busque nomes de lugares quando o near: falha

Quando near: ou geocode: voltam vazios, busque o lugar em palavras e confira você mesmo os perfis dos autores. Os posts locais costumam citar a cidade, um bairro ou uma hashtag local, e todo resultado da Sorsa API traz a location do autor, então o mesmo filtro do passo 4 separa quem é local.

Uma consulta montada com nomes, por exemplo "power outage" (Austin OR ATX OR #atxwx OR "South Congress") lang:en, alcança posts que não levam nenhuma marcação de lugar. Rode-a pelo POST /search-tweets e mantenha os posts cujo user.location combina com a sua lista de apelidos: a cidade, seu apelido, o código do aeroporto e o condado.

Os dois métodos respondem a perguntas diferentes, então registre qual deles encontrou cada post:

• Um operador de localização encontra posts que o X liga ao lugar: marcados ali, ou escritos recentemente por alguém cujo perfil o lista.
• Nomes de lugares mais um filtro de perfil encontram posts sobre o lugar escritos por pessoas que dizem morar lá, em qualquer data até 2006.

Para acompanhar um lugar ao longo de dias, em vez de buscá-lo uma vez, rode a consulta de novo em intervalos regulares e guarde só os posts mais novos que a última execução; o monitoramento do Twitter em tempo real cobre a parte do polling. E para ver sobre o que uma cidade inteira está falando, em vez de um só assunto, a API de trends do Twitter devolve a lista de trending do X para aquele lugar.

#Encontre contas do Twitter em uma cidade

Para encontrar contas em um lugar, busque perfis em vez de posts. No x.com, rode uma consulta de localização e abra a aba People, ou busque o nome de uma cidade junto com o seu assunto para achar perfis que mencionam os dois.

Em código, o POST /search-users (abre em uma nova aba) da Sorsa API recebe uma palavra-chave como coffee roaster Austin e devolve os perfis correspondentes, cada um com o seu campo location, página por página com o next_cursor. Filtre esses perfis com a mesma lista de apelidos de antes.

A localização de um perfil é o que o dono digitou. O país em que o próprio X coloca uma conta é outro campo: a linha "Account based in" em About this account, que o X deduz de endereços IP. O GET /about (abre em uma nova aba) da Sorsa API o devolve como country, uma conta por requisição. Veja o que "Account based in" significa no X para saber até onde confiar nele, e o guia da API de localização do Twitter para mapear uma lista inteira de seguidores por país.

#Quanto custa uma busca por localização

Na Sorsa API, uma busca por localização custa a partir de US$ 0,07 por 1.000 posts, perfis de autores incluídos. Na API oficial do X, os mesmos posts com seus autores custam US$ 15,00 por 1.000 a partir de 22 de novembro de 2026, quando o X passa a cobrar cada usuário que uma expansion devolve a US$ 0,010, além dos US$ 0,005 por post (aviso do X (abre em uma nova aba)).

A rota oficial soma mais coisas. O objeto de lugar de um post conta como mais uma expansion de US$ 0,005, o que leva um post marcado com o seu autor e o lugar a US$ 0,020. Os operadores de localização dela combinam só com posts que têm marcação de lugar, então as combinações por localização de perfil que o x.com mostra na última semana nunca voltam. E ela para em 3 milhões de leituras de posts por mês nos preços de pagamento por uso (abre em uma nova aba), com um contrato Enterprise a partir de cerca de US$ 42 mil por mês acima disso.

Na Sorsa API você paga por requisição: uma requisição devolve até cerca de 20 posts, as requisições com falha são grátis e todos os planos rodam a 20 requisições por segundo. As 100 requisições grátis cobrem cerca de 2.000 posts.

#Comece a buscar no Twitter por localização

Uma busca por localização no X é uma palavra-chave mais near: ou geocode:, lida na aba Latest e conferida com os perfis dos autores. Para rodá-la em código para uma cidade ou para cem, use a Sorsa API: o POST /search-tweets aceita as mesmas consultas com uma chave de API, devolve a localização de cada autor e custa a partir de US$ 0,07 por 1.000 posts.

#FAQ