API para X / Twitter

API para X / Twitter: Tendências

Obtenha as tendências atuais do X (Twitter) mundiais, de um país ou de uma cidade, na ordem de ranking do X, incluindo a localização resolvida.

POST/v1/run/twitter.trends
Disponibilidade
100,00%
30d · 489 chamadas
Requisições
505
30d · semanal, últimas 12 sem.
Resposta
1,3s
mediana · 30d

Rede de provedores

Provedores ordenados por tráfego

Teste

Faça sua primeira requisição

requireFieldsarray
Opcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `promoted`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em uma tendência que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Abrir em
Obter chave grátis
Resposta de exemplo
Execuções grátis retornam só os primeiros 3 resultados. Recarregue uma chave para receber a resposta completa.
{
  "data": {
    "asOfUtc": 12.5,
    "items": [
      {
        "isHashtag": true,
        "name": "Example title",
        "promoted": true,
        "query": "example",
        "rank": 1
      }
    ],
    "location": "example",
    "locationId": "a1b2c3d4",
    "url": "https://example.com/page"
  },
  "found": true,
  "reason": "not_found"
}
Interface da resposta
interface TwitterTrendsResponse {
  data: {
    asOfUtc: number;
    items: {
      isHashtag?: boolean;
      name: string;
      promoted?: boolean;
      query: string;
      rank: number;
    }[];
    location: string;
    locationId: string;
    url?: string;
  } | null;
  found: boolean;
  reason?: "not_found";
}

Referência completa de parâmetros e resposta - todos os campos, tipos e exemplos deste endpoint.

Referência

Requisição, resposta e preço

Última verificação em 2026-09-29 · disponibilidade e latência medidas em 30d
POST /v1/run/twitter.trends
curl -X POST https://api.getanyapi.com/v1/run/twitter.trends \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"limit":10,"location":"US"}'
CampoTipoValor de exemplo
Corpo da requisição
limitinteger10Número máximo de tendências ranqueadas a retornar (1-50, padrão 50).
locationstring"US"Nome do país, nome da cidade ou código ISO do país. Omita para tendências mundiais.
requireFieldsarrayOpcional; se omitido, o roteamento não muda e a fonte mais barata atende. Informe os campos de saída que esta requisição precisa poder retornar, por exemplo `promoted`, e ela só será atendida por uma fonte que retorne todos eles. Os campos que você não informar continuam sendo retornados sempre que a fonte que atende os tiver. Isso pode aumentar o seu preço: quando a fonte mais barata não consegue retornar um campo informado, uma fonte mais cara atende, e você recebe a cotação e é cobrado pelo preço dela. Um campo informado ainda pode vir ausente em uma tendência que realmente não o tenha. Se você informar uma combinação de campos que nenhuma fonte retorna sozinha, a requisição é recusada como entrada inválida, sem cobrança.
Resposta
dataobjectThe resolved location and its current ranked trends, or null when unavailable.
data.asOfUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.
data.itemsobject[]Current trends in X's own ranking order. Distinct ranks may carry the same trend name. Populated whenever the provider has data for the entity.
data.items[].isHashtagpode ser exigidobooleanWhether the trend text is a hashtag.
data.items[].namestringTrend text displayed by X. Populated whenever the provider has data for the entity.
data.items[].promotedpode ser exigidobooleanWhether X marks the trend as promoted.
data.items[].querystringSearch query corresponding to the trend. Populated whenever the provider has data for the entity.
data.items[].rankintegerOne-based position in X's trend ranking. Populated whenever the provider has data for the entity.
data.locationstringResolved X trend-location name. Populated whenever the provider has data for the entity.
data.locationIdstringResolved Yahoo WOEID used by X, exposed as a stable location identifier. Populated whenever the provider has data for the entity.
data.urlstringX search URL for the trend.
foundbooleanWhether X trends were resolved for the requested location.
reason"not_found"Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.
Preço
Preço por requisiçãoUSDUS$ 0,0001
Preço /mil req.USDUS$ 0,10

Dúvidas frequentes

Sobre o endpoint Tendências da API para X / Twitter

O endpoint Tendências da AnyAPI para X / Twitter retorna dados de X / Twitter em JSON normalizado com uma chamada POST para /v1/run/twitter.trends. Obtenha as tendências atuais do X (Twitter) mundiais, de um país ou de uma cidade, na ordem de ranking do X, incluindo a localização resolvida. A AnyAPI distribui cada requisição entre 2 fontes, com failover automático quando uma falha. Custa a partir de US$ 0,10 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Nos últimos 30 dias, 100,0% das chamadas ao endpoint Tendências da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,3 segundos, em 489 chamadas medidas.

Custa a partir de US$ 0,10 por mil requisições, em dólares, sem assinatura e sem mínimo mensal. Você recarrega uma carteira em dólares e cada chamada desconta dela. Algumas requisições pagas pela carteira que falham geram cobranças de processamento, que repassamos pelo custo, sem margem; a resposta de erro mostra o valor cobrado.

Obtenha as tendências atuais do X (Twitter) mundiais, de um país ou de uma cidade, na ordem de ranking do X, incluindo a localização resolvida. A resposta é JSON normalizado, com o mesmo envelope que todo endpoint da AnyAPI retorna, então processar um segundo endpoint é só trocar a URL, e nada mais.

Nos últimos 30 dias, 100,0% das chamadas ao endpoint Tendências da API para X / Twitter feitas pela AnyAPI tiveram sucesso, com tempo de resposta mediano de 1,3 segundos, em 489 chamadas medidas. Estas são medições da própria AnyAPI sobre o tráfego que passa pelo gateway, recalculadas continuamente, e não uma meta de nível de serviço publicada.
Mais para chamar

Outros endpoints de X / Twitter

Perfila partir de US$ 0,22 /mil req.Tweets do usuárioa partir de US$ 0,50 /mil req.Tweeta partir de US$ 0,22 /mil req.Artigoa partir de US$ 0,75 /mil req.Comunidadea partir de US$ 0,10 /mil req.Tweets da comunidadea partir de US$ 0,50 /mil req.Seguidoresa partir de US$ 0,50 /mil req.Seguindoa partir de US$ 0,50 /mil req.Respostasa partir de US$ 0,50 /mil req.Buscara partir de US$ 0,65 /mil req.Buscar comunidadesa partir de US$ 0,11 /mil resultadosBuscar usuáriosa partir de US$ 0,75 /mil req.Threada partir de US$ 3,75 /mil req.Transcrição do tweeta partir de US$ 1,20 /mil req.Posts do usuárioa partir de US$ 0,50 /mil req.