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.
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
{"rank": 1,"name": "#NBAOpeningNight","isHashtag": true,"query": "%23NBAOpeningNight","promoted": false,"url": "https://x.com/search?q=%23NBAOpeningNight"}
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.
Essayer
Obtenez X / Twitter Tendances en une requê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.
Réponse
JSON, une valeur d’exemple par champ.
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.
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.
- 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.
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.