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.

Commencer gratuitementTélécharger l’exempleou JSON

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
}
Disponibilité
99,56%
30d · 678 appels
Requêtes
702
30 j · par semaine, 12 dernières sem.
Réponse
1,6s
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.
{
  "found": true,
  "data": {
    "location": "United States",
    "locationId": "23424977",
    "asOfUtc": 1727366400,
    "items": [
      {
        "rank": 1,
        "name": "#NBAOpeningNight",
        "isHashtag": true,
        "query": "%23NBAOpeningNight",
        "promoted": false
      },
      {
        "rank": 2,
        "name": "Federal Reserve",
        "isHashtag": false,
        "query": "%22Federal%20Reserve%22",
        "promoted": false
      },
      {
        "rank": 3,
        "name": "iPhone 18",
        "isHashtag": false,
        "query": "%22iPhone%2018%22",
        "promoted": true
      },
      {
        "rank": 4,
        "name": "#MondayMotivation",
        "isHashtag": true,
        "query": "%23MondayMotivation",
        "promoted": false
      },
      {
        "rank": 5,
        "name": "Coachella 2027",
        "isHashtag": false,
        "query": "%22Coachella%202027%22",
        "promoted": false
      }
    ],
    "url": "https://x.com/search?q=%23NBAOpeningNight"
  }
}

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-10-07 · 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.

  • foundboolean

    true

datadata
  • locationstring

    United States

  • locationIdstring

    23424977

  • asOfUtcnumber

    1727366400

  • urlstring

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

each itemdata.items[]
  • ranknumber

    1

  • namestring

    #NBAOpeningNight

  • isHashtagbooleanpeut exiger

    true

  • querystring

    %23NBAOpeningNight

  • promotedbooleanpeut exiger

    false

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,6% des appels X / Twitter Tendances passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,6 secondes, sur 678 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,6% des appels X / Twitter Tendances passés par AnyAPI ont réussi, avec un temps de réponse médian de 1,6 secondes, sur 678 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.
À appeler aussi

Autres endpoints X / Twitter

Profilà partir de 0,22 $US /1k reqTweets de l’utilisateurà partir de 0,45 $US /1k reqTweetà partir de 0,22 $US /1k reqArticleà partir de 0,75 $US /1k reqCommunautéà partir de 0,10 $US /1k reqTweets de la communautéà partir de 0,45 $US /1k reqAbonnésà partir de 0,45 $US /1k reqAbonnementsà partir de 0,45 $US /1k reqRéponsesà partir de 0,45 $US /1k reqRechercheà partir de 0,60 $US /1k reqRecherche de communautésà partir de 0,11 $US /1k résultatsRecherche d’utilisateursà partir de 0,70 $US /1k reqFil de discussionà partir de 3,75 $US /1k reqTranscription du tweetà partir de 1,20 $US /1k reqPublications de l’utilisateurà partir de 0,45 $US /1k req