API X / Twitter

X / Twitter Tendances API

Obtenez les tendances actuelles de X (Twitter) pour le monde entier, un pays ou une ville dans l’ordre de classement de X, y compris le lieu résolu.

0,10 $US/1k req, paiement à la requête, sans abonnement.

Explore / X
x.com/explore/tabs/trending

Trending

United States

Trending in United States

#NBAOpeningNight

Trending in United States

Federal Reserve

Promoted

iPhone 18

Trending in United States

#MondayMotivation

Trending in United States

Coachella 2027

Ce que l’API a renvoyéitems[0]
{
"rank": 1,
"name": "#NBAOpeningNight",
"isHashtag": true,
"query": "%23NBAOpeningNight",
"promoted": false,
"url": "https://x.com/search?q=%23NBAOpeningNight"
}
Disponibilité
99,93%
30d · 10 352 appels
Requêtes
11 798
30 j · par semaine, 12 dernières sem.
Réponse
1,0s
médiane · 30d

Tarifs et fournisseurs

Tarifs de l’API X / Twitter Tendances : une API, 2 fournisseurs interchangeables

Le fournisseur le moins cher répond en premier. S’il échoue, le suivant prend le relais dans le même appel.

Vous payez
1,00 $US
0,10 $US/1k req, seulement pour ce que vous utilisez. Aucun forfait mensuel.
Vos 1 000 premières requêtes sont gratuites avec le solde de départ de 0,10 $US.

Essayer

Obtenez X / Twitter Tendances en une requête

requireFieldsarray
Facultatif ; omettez-le et le routage est inchangé, la source la moins chère répondant. Nommez les champs de sortie que cette requête doit pouvoir renvoyer, par exemple `promoted`, et elle n’est servie que par une source qui les renvoie tous. Les champs que vous ne nommez pas sont quand même renvoyés chaque fois que la source qui répond les possède. Cela peut augmenter votre prix : quand la source la moins chère ne peut pas renvoyer un champ nommé, une source plus chère répond, et vous êtes facturé à son prix. Un champ nommé peut quand même être absent sur une tendance qui en est réellement dépourvue. Nommer une combinaison qu’aucune source unique ne renvoie ensemble est refusé comme entrée invalide, sans frais.
Ouvrir dans
Obtenir une clé gratuite
Exemple de réponse
Les exécutions gratuites ne renvoient que les 3 premiers résultats. Alimentez une clé pour obtenir la réponse complète.

Cet exemple affiche 12 champs sur 13. Voir tous les champs

{
  "found": true,
  "data": {
    "location": "United States",
    "locationId": "23424977",
    "asOfUtc": 1727366400,
    "items": [
      {
        "rank": 1,
        "name": "#NBAOpeningNight",
        "isHashtag": true,
        "query": "%23NBAOpeningNight",
        "promoted": false,
        "url": "https://x.com/search?q=%23NBAOpeningNight"
      },
      {
        "rank": 2,
        "name": "Federal Reserve",
        "isHashtag": false,
        "query": "%22Federal%20Reserve%22",
        "promoted": false,
        "url": "https://x.com/search?q=%22Federal%20Reserve%22"
      },
      {
        "rank": 3,
        "name": "iPhone 18",
        "isHashtag": false,
        "query": "%22iPhone%2018%22",
        "promoted": true,
        "url": "https://x.com/search?q=%22iPhone%2018%22"
      },
      {
        "rank": 4,
        "name": "#MondayMotivation",
        "isHashtag": true,
        "query": "%23MondayMotivation",
        "promoted": false,
        "url": "https://x.com/search?q=%23MondayMotivation"
      },
      {
        "rank": 5,
        "name": "Coachella 2027",
        "isHashtag": false,
        "query": "%22Coachella%202027%22",
        "promoted": false,
        "url": "https://x.com/search?q=%22Coachella%202027%22"
      }
    ]
  }
}

Référence complète des paramètres et de la réponse : chaque champ, type et exemple de cet endpoint.

Référence

Une requête, une seule forme de réponse.

Chaque champ que vous envoyez et chaque champ que vous recevez, avec un vrai exemple.

Dernière vérification : 2026-11-21 · disponibilité et latence mesurées sur 30d

Corps de la requête

JSON, envoyé à cet endpoint.

  • limitinteger

    10

    Nombre maximal de tendances classées à renvoyer (1-50, 50 par défaut).

  • locationstring

    United States

    Nom de pays, nom de ville ou code pays ISO. Omettez pour les tendances mondiales.

  • requireFieldsarray

    Facultatif ; omettez-le et le routage est inchangé, la source la moins chère répondant. Nommez les champs de sortie que cette requête doit pouvoir renvoyer, par exemple `promoted`, et elle n’est servie que par une source qui les renvoie tous. Les champs que vous ne nommez pas sont quand même renvoyés chaque fois que la source qui répond les possède. Cela peut augmenter votre prix : quand la source la moins chère ne peut pas renvoyer un champ nommé, une source plus chère répond, et vous êtes facturé à son prix. Un champ nommé peut quand même être absent sur une tendance qui en est réellement dépourvue. Nommer une combinaison qu’aucune source unique ne renvoie ensemble est refusé comme entrée invalide, sans frais.

Vous envoyez. Un petit corps JSON. Les valeurs affichées sont des exemples à remplacer par les vôtres.

Réponse

JSON, une valeur d’exemple par champ.

datadata

The resolved location and its current ranked trends, or null when unavailable.

  • asOfUtcnumber

    1727366400

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds. Populated whenever the provider has data for the entity.

  • locationstring

    United States

    Resolved X trend-location name. Populated whenever the provider has data for the entity.

  • locationIdstring

    23424977

    Resolved Yahoo WOEID used by X, exposed as a stable location identifier. Populated whenever the provider has data for the entity.

each itemdata.items[]

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.

  • isHashtagbooleanpeut exiger

    true

    Whether the trend text is a hashtag.

  • namestring

    #NBAOpeningNight

    Trend text displayed by X. Populated whenever the provider has data for the entity.

  • promotedbooleanpeut exiger

    false

    Whether X marks the trend as promoted.

  • querystring

    %23NBAOpeningNight

    Search query corresponding to the trend. Populated whenever the provider has data for the entity.

  • rankinteger

    1

    One-based position in X's trend ranking. Populated whenever the provider has data for the entity.

  • urlstring

    https://x.com/search?q=%23NBAOpeningNight

    X search URL for the trend.

top level
  • foundboolean

    true

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

Vous recevez. Des champs nommés et typés, dans la même forme quelle que soit la source qui répond.

FAQ

À propos de l’API X / Twitter Tendances

L’API X / Twitter Tendances d’AnyAPI renvoie des données X / Twitter en JSON normalisé à partir d’un appel POST à /v1/run/twitter.trends. Obtenez les tendances actuelles de X (Twitter) pour le monde entier, un pays ou une ville dans l’ordre de classement de X, y compris le lieu résolu. AnyAPI route chaque requête sur 2 sources et bascule automatiquement quand l’une échoue. Elle coûte à partir de 0,10 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Ces 30 derniers jours, 99,9% des appels X / Twitter Tendances passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,0 secondes, sur 10 352 appels mesurés.

Elle coûte à partir de 0,10 $US pour 1 000 requêtes, en dollars US, sans abonnement et sans minimum mensuel. Vous alimentez un portefeuille en USD et chaque appel le débite. Certaines requêtes échouées financées par le portefeuille entraînent des frais de traitement que nous répercutons au prix coûtant, sans marge ; la réponse d’erreur indique le montant facturé.

Obtenez les tendances actuelles de X (Twitter) pour le monde entier, un pays ou une ville dans l’ordre de classement de X, y compris le lieu résolu. La réponse est du JSON normalisé avec la même enveloppe que celle de tous les endpoints AnyAPI, donc analyser un second endpoint revient à changer l’URL et rien d’autre.

Ces 30 derniers jours, 99,9% des appels X / Twitter Tendances passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,0 secondes, sur 10 352 appels mesurés. Ce sont les propres mesures d’AnyAPI du trafic passant par la passerelle, recalculées en continu, et non un objectif de niveau de service publié.

Oui. Un nouveau compte AnyAPI démarre avec 0,10 $US de solde gratuit, sans carte, ce qui couvre 1 000 appels X / Twitter Tendances à 0,0001 $US chacun.

AnyAPI interroge la suivante de ses 2 sources dans la même requête, la moins chère d’abord, donc la panne d’une source ne fait pas échouer votre appel.

Envoyez une requête POST à https://api.getanyapi.com/v1/run/twitter.trends avec votre clé AnyAPI dans un en-tête « Authorization: Bearer » et l’entrée en corps JSON. La même clé et le même portefeuille fonctionnent sur tous les endpoints AnyAPI.

Non. Vous ajoutez des dollars US à un solde AnyAPI prépayé unique et chaque requête le débite. Il n’y a ni forfait mensuel ni minimum, et le même solde paie tous les endpoints AnyAPI.

Oui. Installez @getanyapi/sdk depuis npm pour TypeScript ou getanyapi depuis pip pour Python. Les deux appellent chaque endpoint AnyAPI avec la même clé, et n’importe quel client HTTP fonctionne aussi.

Oui. Un agent peut se connecter au serveur MCP d’AnyAPI à https://api.getanyapi.com/mcp, ou créer sa propre clé d’essai gratuit avec un seul POST non authentifié vers https://api.getanyapi.com/agent/signup et appeler cet endpoint en HTTP.