API de tendências do Twitter: obtenha trending topics em 2026

Por Sorsa Editorial

Atualizado em 8 de julho de 2026: adicionamos a franquia inicial de 100 requisições grátis, atualizamos o preço atual por requisição contra a tarifa de tendência de pagamento por uso oficial e reconfirmamos o contador padrão de resultados do endpoint e o campo de contagem de tweets frequentemente vazio.

Em resumo: Para obter trending topics do Twitter (X) por uma API em 2026, envie uma requisição GET autenticada com um WOEID, o Where On Earth IDentifier numérico de uma localização. A API oficial do X serve isso em GET /2/trends/by/woeid/{woeid} nos níveis pagos usando um Bearer token, cobrindo cerca de 470 localizações de tendência no mundo todo.

Uma API de tendências do Twitter não precisa significar OAuth, uma fila de revisão de app ou um contrato de cinco dígitos. A Sorsa API, uma API alternativa do Twitter (X), retorna as mesmas tendências baseadas em WOEID por uma única chamada /trends autenticada com uma chave de API. Cada tendência volta já pareada com uma consulta de busca pronta para rodar e uma URL direta, e a cobrança é fixa por requisição: uma extração de tendências custa cerca de US$ 0,002 no plano Pro (US$ 199 por 100.000 requisições) contra cerca de US$ 0,20 na API oficial, que lê as mesmas 20 tendências a US$ 0,010 cada. O rate limit é um fixo de 20 requisições por segundo em todo plano, sem janelas de 15 minutos.

Os trending topics são um dos poucos sinais em tempo real na web aberta que mostram no que milhões de pessoas estão prestando atenção agora. Times de marketing os usam para cronometrar campanhas, redações os usam para farejar notícias de última hora, e mesas quantitativas os tratam como uma camada de sinal antecipado. A parte difícil em 2026 raramente é o caso de uso. É tirar o dado de forma limpa, porque o caminho oficial é mais fragmentado e mais caro do que a maioria dos tutoriais admite.

Este guia cobre o que de fato está disponível hoje: como a recuperação baseada em WOEID funciona, como o endpoint de tendências da API oficial do X v2 se comporta (incluindo onde ele fica aquém), como puxar tendências com uma única chave de API e código funcional em Python, Node.js e curl. A maioria dos tutoriais existentes ainda referencia o endpoint depreciado da v1.1 e o fluxo OAuth 1.0a do Tweepy, que não se aplica mais a tendências.

Índice

1. O que é a API de tendências do Twitter?
2. Duas formas de obter tendências do X por código em 2026
3. Como o WOEID funciona (e por que toda chamada de tendências precisa de um)
4. Obtendo trending topics com a Sorsa API
5. Referência de WOEID: principais países e cidades
6. Exemplos de código: Python, Node.js e curl
7. Combinando tendências com busca para análise mais profunda
8. Problemas comuns com o endpoint de tendências oficial do X
9. Casos de uso para dados de tendência
10. Rate limits, cache e boas práticas
11. Na prática: polling de tendências para uma mesa de redação
12. Perguntas frequentes
13. Primeiros passos

O que é a API de tendências do Twitter? {#what-is-the-twitter-trends-api}

Uma API de tendências do Twitter é um endpoint HTTP que retorna os tópicos atualmente em tendência no X (antigo Twitter) para uma área geográfica específica. Uma resposta típica é uma lista ranqueada de cerca de 20 a 50 tópicos para uma localização, recomputada pela plataforma a cada poucos minutos. As tendências acessadas dessa forma são escopadas por localização, não personalizadas.

A distinção importa. A visão personalizada "Tendências para você" no site do X mistura contas que você segue e a sua atividade, e ela não é exposta por nenhuma API. O que uma API retorna é a lista escopada por localização e de toda a plataforma que o X computa para uma região, que é exatamente o que você quer para análise, monitoramento e pesquisa.

A lista é recomputada a cada poucos minutos. Para quase toda carga, fazer polling de cada localização uma vez a cada 5 a 15 minutos pega novas entradas conforme aparecem sem desperdiçar requisições.

Duas formas de obter tendências do X por código em 2026 {#two-ways-to-get-x-trends-through-code-in-2026}

Dois caminhos práticos existem para recuperar trending topics do X por código em 2026: o endpoint de tendências da API oficial do X v2, autenticado com um Bearer token OAuth 2.0 em um nível pago, e APIs REST de terceiros que embrulham os mesmos dados baseados em WOEID atrás de uma única chave de API. Ambos retornam tendências escopadas por localização; eles diferem em autenticação, preço e no que cada objeto de tendência inclui.

Opção 1: o endpoint de tendências da API oficial do X v2

O X expõe o endpoint de tendências dele em GET /2/trends/by/woeid/{woeid}. Ele aceita um WOEID como parâmetro de caminho e retorna uma lista de objetos de tendência, cada um carregando um trend_name e um tweet_count opcional que você solicita pelo parâmetro trend.fields. A referência completa vive na documentação oficial de tendências do X.

A autenticação é um Bearer token OAuth 2.0, o que significa registrar um app de desenvolvedor e ficar em um nível pago da API do X. Não há acesso gratuito a tendências em 2026, e a plataforma agora cobra as leituras por recurso, então cada tendência retornada é uma unidade medida à parte. Para o contexto mais amplo de como esse preço funciona, veja nosso detalhamento de preços da API do X em 2026 e de por que a API oficial é tão cara.

Para ir de um trending topic aos posts de fato por trás dele, você constrói a sua própria consulta de busca e chama o endpoint de busca à parte.

Opção 2: um endpoint de tendências de chave única

O endpoint de tendências da Sorsa é construído em torno de uma prioridade diferente: tornar o dado de tendência aproveitável no próprio passo seguinte de um pipeline. A resposta inclui o nome da tendência mais uma consulta de busca pré-construída e uma URL direta, então você pode fluir direto para uma análise mais profunda sem escrever nenhum código de montagem de consulta.

A autenticação é uma única chave de API no cabeçalho ApiKey. Não há fluxo OAuth, nem registro de app, nem revisão de desenvolvedor. Cadastre-se, copie uma chave, envie a requisição, e as primeiras 100 requisições são grátis sem cartão. O preço é fixo por requisição em todo endpoint, incluindo tendências, então uma busca de lista de tendências custa o mesmo que uma consulta de usuário ou uma chamada de busca.

Lado a lado: tendências da API oficial do X contra Sorsa

Uma comparação factual para recuperação de tendências especificamente, com os limites genuínos de cada opção declarados sem rodeios.

O padrão que segue dos números: em qualquer volume real de polling, a cobrança fixa por requisição é muito mais barata do que pagar por cada tendência individual, e uma única chave de API remove o overhead do OAuth e da revisão de app. As ressalvas honestas são que nenhuma opção retorna tendências históricas, e o endpoint da Sorsa não anexa um número de volume de tweets a cada tendência. As próximas seções mostram como trabalhar com os dois, e a seção de Problemas Comuns cobre por que o tweet_count oficial é não confiável de início.

Como o WOEID funciona (e por que toda chamada de tendências precisa de um) {#how-woeid-works-and-why-every-trends-call-needs-one}

Um WOEID (Where On Earth IDentifier) é um ID numérico que rotula unicamente um lugar geográfico. O Twitter adotou WOEIDs para tendências por volta de 2010 e ainda os usa, então toda chamada de API de tendências exige um WOEID para a localização que você quer. Há cerca de 470 WOEIDs de tendência válidos, cobrindo os níveis mundial, de país e de cidade.

Alguns exemplos deixam o formato claro:

• 1 é Mundial (tendências globais)
• 23424977 são os Estados Unidos
• 23424975 é o Reino Unido
• 23424900 é o México
• 2459115 é a Cidade de Nova York
• 44418 é Londres

IDs de nível de país cobrem um país inteiro, enquanto IDs de nível de cidade cobrem uma única área metropolitana. Nem todo país tem tendências de nível de cidade; mercados menores muitas vezes retornam apenas uma única lista nacional. Você não se autentica de forma diferente por região e não há preço por região. Se você sabe o inteiro, pode buscar as tendências dele.

Como achar o WOEID de uma localização

Para os mercados mais comuns, use a tabela de referência abaixo. Para qualquer coisa além dos principais mercados, uma lista completa das localizações de tendência suportadas pelo X é mantida como um gist público de WOEID no GitHub com todas as entradas válidas. A Sorsa API não expõe um endpoint separado de "localizações disponíveis", então o gist é a consulta canônica; se uma localização não está nele, o X não publica dados de tendência para aquele lugar no nível da API.

Obtendo trending topics com a Sorsa API {#getting-trending-topics-with-the-sorsa-api}

O endpoint de tendências aceita um único parâmetro de query, woeid, e retorna uma lista de objetos de tendência. Não há modo histórico e nem paginação: cada chamada retorna a lista atual no momento da requisição.

Requisição:

GET https://api.sorsa.io/v3/trends?woeid=23424977
Header: ApiKey: YOUR_API_KEY

Resposta:

{
  "trends": [
    {
      "name": "#FedDecision",
      "query": "%23FedDecision",
      "url": "https://twitter.com/search?q=%23FedDecision"
    },
    {
      "name": "Powell",
      "query": "Powell",
      "url": "https://twitter.com/search?q=Powell"
    },
    {
      "name": "rate cut",
      "query": "%22rate+cut%22",
      "url": "https://twitter.com/search?q=%22rate+cut%22"
    }
  ]
}

Cada objeto de tendência tem três campos:

• name: o rótulo legível por humanos do trending topic. Exiba isto na sua interface.
• query: a string de busca com URL-encode. Passe-a ao endpoint de busca para recuperar os posts de fato por trás da tendência.
• url: um link direto para a página de resultados de busca do X, útil para referências clicáveis em painéis ou alertas.

Para construir um registro histórico, faça polling na sua própria programação e armazene cada snapshot. Uma execução a cada 10 a 15 minutos por localização, escrita em um armazenamento de série temporal, vira um dataset aproveitável em poucas semanas. O formato completo de requisição e resposta está documentado na referência do endpoint de tendências, e o guia de quickstart percorre a obtenção de uma chave.

Referência de WOEID: principais países e cidades {#woeid-reference-top-countries-and-cities}

As tabelas abaixo cobrem os WOEIDs que aparecem com mais frequência em produção. Para toda localização suportada, use o gist público de WOEID.

Global

Países

Principais cidades

Para cidades menores e mercados regionais, use o gist completo de WOEID.

Exemplos de código: Python, Node.js e curl {#code-examples-python-nodejs-and-curl}

Os três exemplos abaixo batem no mesmo endpoint e exigem apenas uma chave de API no cabeçalho ApiKey.

curl

curl -H "ApiKey: YOUR_API_KEY" \
  "https://api.sorsa.io/v3/trends?woeid=23424977"

Python

import requests

API_KEY = "YOUR_API_KEY"
BASE = "https://api.sorsa.io/v3"
headers = {"ApiKey": API_KEY}

# US trends (WOEID 23424977)
resp = requests.get(f"{BASE}/trends", headers=headers, params={"woeid": 23424977})
trends = resp.json()["trends"]

for t in trends[:10]:
    print(t["name"], "->", t["url"])

Node.js

const API_KEY = "YOUR_API_KEY";

async function getTrends(woeid) {
  const res = await fetch(`https://api.sorsa.io/v3/trends?woeid=${woeid}`, {
    headers: { ApiKey: API_KEY },
  });
  const { trends } = await res.json();
  return trends;
}

// US trends
getTrends(23424977).then((trends) => {
  trends.slice(0, 10).forEach((t) => console.log(t.name, t.url));
});

Fazendo polling de várias regiões em paralelo

Quando você acompanha vários mercados de uma vez, dispare as requisições concorrentemente em vez de em um loop. O limite fixo de 20 requisições por segundo torna um punhado de regiões trivial.

import asyncio
import aiohttp

API_KEY = "YOUR_API_KEY"
BASE = "https://api.sorsa.io/v3"
WOEIDS = {"US": 23424977, "UK": 23424975, "Japan": 23424856, "Brazil": 23424768}

async def fetch_trends(session, name, woeid):
    url = f"{BASE}/trends"
    async with session.get(url, headers={"ApiKey": API_KEY}, params={"woeid": woeid}) as r:
        data = await r.json()
        return name, [t["name"] for t in data["trends"][:10]]

async def main():
    async with aiohttp.ClientSession() as session:
        tasks = [fetch_trends(session, n, w) for n, w in WOEIDS.items()]
        for name, tops in await asyncio.gather(*tasks):
            print(name, tops)

asyncio.run(main())

Combinando tendências com busca para análise mais profunda {#combining-trends-with-search-for-deeper-analysis}

Um nome de tendência por si só te diz que uma frase está quente. O valor vem de puxar os posts por trás dela, e o campo query pré-construído transforma isso em uma chamada extra em vez de um exercício de montagem de consulta. Quando você de fato precisa elaborar filtros à mão, o construtor de consulta de busca monta a sintaxe por você. O query chega com URL-encode, então decode-o antes de passá-lo ao endpoint de busca, que espera texto simples.

import requests
from urllib.parse import unquote_plus

API_KEY = "YOUR_API_KEY"
BASE = "https://api.sorsa.io/v3"
headers = {"ApiKey": API_KEY}

# 1. Get current US trends
trends = requests.get(
    f"{BASE}/trends", headers=headers, params={"woeid": 23424977}
).json()["trends"]

# 2. For the top few trends, pull the posts driving each one
for trend in trends[:5]:
    body = {"query": unquote_plus(trend["query"]), "order": "popular"}
    posts = requests.post(f"{BASE}/search-tweets", headers=headers, json=body).json()["tweets"]
    print(trend["name"], "->", len(posts), "top posts")

Daqui você pode ranquear contas por engajamento naqueles posts, classificar o sentimento ou rotear qualquer coisa que case com uma watchlist para o Slack. O passo de busca é coberto de ponta a ponta no nosso guia da API de busca do Twitter, e uma versão sempre ligada roda no passo a passo de monitoramento em tempo real. Como tanto a extração de tendências quanto cada busca são requisições únicas fixas, um pipeline de tendências para posts permanece barato mesmo em alta frequência.

Problemas comuns com o endpoint de tendências oficial do X {#common-issues-with-the-official-x-trends-endpoint}

O endpoint de tendências oficial do X comumente retorna menos tendências do que o esperado, cerca de 20 por localização por padrão em vez das 50 que o endpoint mais antigo da v1.1 retornava, e ocasionalmente retorna uma lista vazia durante problemas na própria plataforma. O campo tweet_count dele é frequentemente nulo mesmo quando solicitado pelo trend.fields, e o acesso é restrito a níveis pagos da API.

Estes não são casos de borda. Eles aparecem repetidamente nos próprios fóruns de desenvolvedor do X:

• Apenas cerca de 20 tendências. Desenvolvedores chamando GET /2/trends/by/woeid/{woeid} na v2 reportam receber cerca de 20 itens, enquanto a documentação não promete as 50 que a v1.1 costumava retornar. Se você especificamente precisa de uma lista mais longa, tem de trabalhar dentro desse padrão e do parâmetro de contagem de resultados do endpoint.
• Respostas vazias. Durante incidentes de plataforma, o endpoint retornou listas de tendência em branco para cada WOEID de uma vez. Isso reflete o dado upstream, não o seu código, então qualquer poller de produção precisa lidar com um array vazio de forma graciosa.
• Volume de tweets ausente. O campo tweet_count deveria carregar o volume por tendência, mas vários desenvolvedores reportam que ele retorna nulo mesmo quando trend.fields está definido corretamente. Tratar esse número como confiável é um erro.
• Overhead de nível pago e de OAuth. As tendências não fazem parte de nenhum plano gratuito, e cada chamada precisa de um Bearer token atrelado a um app registrado, que é a parte mais lenta de começar.
• A trilha da v1.1 é um beco sem saída. Tutoriais mais antigos apontam para GET trends/place na v1.1, que o X depreciou. Código copiado desses guias não vai funcionar.

Esta é a razão prática pela qual existe uma alternativa de chave única. Puxar tendências por uma API alternativa do Twitter (X) como a Sorsa contorna a configuração de OAuth e a cobrança por recurso, retorna a lista atual completa em uma requisição e pareia cada tendência com uma consulta de busca pronta. A lacuna de volume de tweets se aplica aos dois caminhos, e a resposta honesta para qualquer um deles é a mesma: derive o volume contando resultados de busca de uma tendência ao longo de uma janela de tempo, que é uma medida mais fiel do que um campo que a plataforma deixa vazio.

Casos de uso para dados de tendência {#use-cases-for-trend-data}

O dado de tendência parece decorativo até se sentar dentro de um pipeline real. Estes são os padrões que movem a maior parte do uso de produção.

Marketing de conteúdo em tempo real. Times de social puxam tendências regionais a cada 10 a 15 minutos, pontuam-nas contra regras de voz da marca e fazem emergir as que são seguras para engajar. O momento original da Oreo no Super Bowl foi uma versão manual disto; a versão automatizada roda em um feed de tendências.

Alerta de redação. Mesas de notícias observam um mercado primário mais alguns vizinhos e disparam um alerta no Slack quando um tópico desconhecido entra no top dez, muitas vezes pegando uma história antes que ela chegue às agências.

Pesquisa de sinal de trading. Times quantitativos puxam tendências em mercados-alvo em um intervalo apertado e cruzam contra tickers e palavras-chave de setor. Um trending topic às vezes precede o movimento de preço correspondente, o que o torna uma camada de entrada útil.

Planejamento de campanha localizada. Agências puxam tendências para cada mercado em que um cliente opera, uma ou duas vezes por dia, para decidir qual criativo vai para onde. A saída costuma ser uma planilha ou painel de BI em vez de um sistema ao vivo.

Monitoramento de marca e de crise. A aparição súbita de uma marca ou produto nas tendências regionais é muitas vezes o sinal mais antigo de um evento de PR. Parear tendências com acompanhamento de menções transforma isso em um alarme barato e confiável, e combina naturalmente com um fluxo de social listening ou de acompanhamento de concorrentes.

Em cada um destes, a chamada de tendência é a parte barata. O trabalho é o que você faz com o resultado, que é por que o preço fixo por requisição importa mais aqui do que parece de início.

Rate limits, cache e boas práticas {#rate-limits-caching-and-best-practices}

Algumas notas práticas para rodar isto em escala.

Faça cache agressivamente. As tendências mudam a cada poucos minutos no máximo, então fazer cache dos resultados por 5 a 10 minutos por WOEID cobre quase todo caso de uso e corta o volume de requisições em ordens de grandeza. Redis com um TTL é a implementação mais simples.

Respeite o rate limit. A Sorsa impõe um fixo de 20 requisições por segundo por chave de API em todos os endpoints, incluindo /trends. Fazer polling de 20 regiões a cada 30 segundos serve; fazer polling de 200 regiões a cada segundo não, e retorna 429 Too Many Requests. Para vazão maior, a página de rate limits cobre limites customizados.

Trate listas vazias. Alguns WOEIDs menores ocasionalmente retornam arrays curtos ou vazios. Isto é normal e reflete o dado subjacente do X, então codifique defensivamente.

Use o campo query, não name, para busca. O name é legível por humanos mas pode conter caracteres que precisam de escape. O query já tem URL-encode e é o que o X usa internamente; decode-o antes de passá-lo ao endpoint de busca.

Escalone os pollings agendados. Ao acompanhar 50 WOEIDs, não dispare todos os 50 na virada do minuto. Espalhe-os por uma janela de 30 segundos para evitar carga em rajada. A documentação também cobre padrões de requisição para otimizar o uso da API em escala.

Na prática: polling de tendências para uma mesa de redação {#in-practice-trend-polling-for-a-newsroom-desk}

As equipes que mais se apoiam em dados de tendência são redações sociais e mesas de monitoramento de marca. Um grupo de análise de mídia de cerca de 12 pessoas com quem trabalhamos fazia polling de tendências regionais em oito mercados a cada poucos minutos para pegar notícias de última hora cedo.

No modelo de pagamento por uso da API oficial, ler cerca de 30 tendências por mercado em oito mercados a cada cinco minutos soma rápido, porque cada tendência retornada é um recurso cobrado à parte e um mês movimentado empurra rumo aos tetos de leitura da plataforma. Mover o mesmo polling para um plano fixo por requisição colapsou isso em um único número mensal previsível e removeu a contabilidade por recurso por completo, já que uma extração de localização conta como uma requisição não importa quantas tendências voltem. A economia não foi uma otimização esperta; ela segue diretamente de a cobrança de tarifa fixa ser muito mais barata do que a cobrança por recurso neste volume, a mesma diferença de cerca de 100x por extração mostrada na tabela de comparação acima.

Perguntas frequentes {#frequently-asked-questions}

A API do X v2 tem um endpoint de tendências?

Sim. O endpoint de tendências da API do X v2 é GET /2/trends/by/woeid/{woeid}. Ele aceita um WOEID como parâmetro de caminho, retorna uma lista de objetos de tendência e aceita um campo tweet_count opcional pelo parâmetro trend.fields. A autenticação usa um Bearer token OAuth 2.0, e o acesso é limitado a níveis pagos da API do X. O endpoint legado trends/place da v1.1 foi depreciado.

Por que o endpoint de tendências do X retorna apenas 20 tendências ou uma resposta vazia?

O endpoint de tendências da API do X v2 retorna cerca de 20 tendências por localização por padrão, menos do que as 50 que o endpoint aposentado da v1.1 retornava, e a documentação dele não garante uma contagem fixa. Ele também pode retornar um array vazio durante incidentes na própria plataforma, o que afeta todos os WOEIDs de uma vez em vez de indicar um bug na sua requisição. Pollers de produção devem lidar com listas curtas e vazias de forma graciosa.

Existe uma API de tendências do Twitter gratuita?

Não há acesso gratuito a tendências pela API oficial do X em 2026, já que as tendências ficam atrás de níveis pagos e as leituras são cobradas por recurso. Scrapers gratuitos e endpoints não oficiais existem mas tendem a ter rate limit e ser não confiáveis. Para acesso confiável a baixo custo, uma API alternativa do Twitter (X) como a Sorsa te começa com 100 requisições grátis, sem cartão, e depois cobra uma tarifa fixa, então uma extração de tendências custa cerca de US$ 0,002 no plano Pro e cargas pequenas rodam por alguns dólares por mês.

Qual é a diferença entre a API de tendências oficial do X e a Sorsa?

O endpoint de tendências oficial do X retorna nomes de tendência com uma contagem de tweets opcional e frequentemente vazia e exige um Bearer token OAuth 2.0 em um nível pago cobrado por leitura de tendência. O endpoint /trends da Sorsa retorna cada nome de tendência com uma consulta de busca pré-construída e uma URL direta, autentica com uma única chave de API e cobra uma tarifa fixa por requisição. Para pipelines que combinam tendências com busca, o campo query pronto remove o passo de construir a sintaxe de busca à mão.

As tendências do Twitter incluem volume ou contagens de tweets?

O endpoint de tendências oficial do X expõe um campo tweet_count, mas os desenvolvedores reportam que ele retorna nulo mesmo quando solicitado pelo trend.fields, então é não confiável. O endpoint da Sorsa não anexa um número de volume a cada tendência. A forma mais fiel de medir volume em qualquer caminho é consultar o endpoint de busca com a query da tendência e contar resultados ao longo de uma janela de tempo fixa.

Dá para obter tendências de uma cidade específica?

Sim, quando o X oferece tendências para aquela cidade. WOEIDs de nível de cidade cobrem a maioria das grandes áreas metropolitanas do mundo, de um total de cerca de 470 localizações de tendência suportadas. Cidades menores geralmente não têm lista dedicada e recorrem ao dado de nível de país. O gist público de WOEID lista toda localização suportada, e qualquer cidade nele pode ser passada diretamente como o parâmetro woeid.

Como achar o WOEID de um país ou cidade?

Confira a tabela de referência neste guia para mercados comuns. Para qualquer outra coisa, o gist público de WOEID no GitHub lista toda localização de tendência suportada pelo X e o seu ID numérico. Se um lugar não está nessa lista, o X não publica dados de tendência para ele no nível da API, então não há WOEID para consultar.

Dá para obter tendências históricas do Twitter?

Nenhuma API de tendências retorna dados históricos; tanto o endpoint oficial do X quanto o endpoint da Sorsa retornam apenas a lista atual. Para construir histórico, faça polling em uma programação e armazene cada snapshot, tipicamente a cada 10 a 15 minutos por localização, escrito em um banco de dados de série temporal. Como a Sorsa cobra uma tarifa fixa por requisição, o polling frequente para um arquivo histórico permanece barato.

Primeiros passos {#getting-started}

O caminho mais rápido para a sua primeira lista de tendências:

1. Crie uma conta no painel da Sorsa e copie uma chave de API, sem aprovação de conta de desenvolvedor para esperar.
2. Envie uma requisição GET para https://api.sorsa.io/v3/trends com a sua chave no cabeçalho ApiKey e um WOEID como 1 (Mundial) ou 23424977 (EUA).
3. Passe o campo query pré-construído de cada tendência ao endpoint de busca para recuperar os posts de fato movendo a tendência.

Toda conta nova inclui 100 requisições grátis para começar, sem cartão, e os planos pagos começam em US$ 49 por mês por 10.000 requisições, com um fixo de 20 requisições por segundo em todo nível. A API já serviu mais de 5 bilhões de requisições desde 2022. Você pode experimentar qualquer endpoint sem escrever código no Playground da Sorsa, ler a referência de API completa ou comparar as opções no nosso guia de alternativa à API do Twitter. Para volume além dos planos padrão, a equipe trata limites customizados por fale com o time de vendas.

Revisado por Keksich, fundador da Sorsa, profissional de marketing e pesquisador da API do X.

Este guia se apoia no nosso trabalho prático construindo e operando a Sorsa, uma API alternativa do Twitter (X), e em testar o endpoint /trends ao vivo contra o oficial durante esta atualização. O caminho, o comportamento de resultado e a cobrança do endpoint oficial foram verificados contra a documentação oficial de tendências do X e as threads do fórum de desenvolvedor do X sobre limites de resultado e o campo de contagem de tweets; a cobertura de WOEID foi checada contra o gist público de WOEID. O preço dos dois provedores reflete os números vigentes em 9 de junho de 2026. Verificado pela última vez em 9 de junho de 2026.