X / Twitter-Trends-API
Hole aktuelle X-(Twitter-)Trends weltweit, für ein Land oder eine Stadt in der Rangfolge von X, einschließlich des aufgelösten Standorts.
0,10 USD/1k Anfr., Zahlung pro Anfrage, kein Abo.
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"}
Preise und Anbieter
Preise der X / Twitter-Trends-API: eine API, 2 austauschbare Anbieter
Der günstigste Anbieter bedient zuerst. Fällt er aus, übernimmt der nächste im selben Aufruf.
Ausprobieren
X / Twitter Trends mit einer Anfrage abrufen
Dieses Beispiel zeigt 12 von 13 Feldern. Alle Felder ansehen
{
"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"
}
]
}
}Vollständige Parameter- und Antwortreferenz: jedes Feld, jeder Typ und jedes Beispiel für diesen Endpoint.
Referenz
Eine Anfrage, eine Antwortstruktur.
Jedes Feld, das du sendest, und jedes Feld, das du zurückbekommst, jeweils mit einem echten Beispiel.
Zuletzt geprüft 2026-11-21 · Verfügbarkeit und Latenz gemessen über 30d
Request-Body
JSON, per POST an diesen Endpoint gesendet.
- limitinteger
10
Maximale Zahl der zurückgegebenen gerankten Trends (1-50, Standard 50).
- locationstring
United States
Ländername, Stadtname oder ISO-Ländercode. Weglassen für weltweite Trends.
- requireFieldsarray
Optional; wenn weggelassen, bleibt das Routing unverändert, und die günstigste Quelle bedient. Nenne die Ausgabefelder, die diese Anfrage zurückgeben können muss, zum Beispiel `promoted`, und sie wird nur von einer Quelle bedient, die jedes davon zurückgibt. Felder, die du nicht nennst, werden weiterhin zurückgegeben, sobald die bedienende Quelle sie hat. Das kann deinen Preis erhöhen: Wenn die günstigste Quelle ein genanntes Feld nicht zurückgeben kann, bedient eine teurere Quelle, und dir wird ihr Preis genannt und berechnet. Ein genanntes Feld kann bei einem Trend, der es tatsächlich nicht hat, trotzdem fehlen. Eine Kombination zu nennen, die keine einzelne Quelle zusammen zurückgibt, wird als ungültige Eingabe ohne Berechnung abgelehnt.
Antwort
JSON, ein Beispielwert pro Feld.
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.
- isHashtagbooleankann erfordern
true
Whether the trend text is a hashtag.
- namestring
#NBAOpeningNight
Trend text displayed by X. Populated whenever the provider has data for the entity.
- promotedbooleankann erfordern
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
Über die X / Twitter-Trends-API
Die AnyAPI-X / Twitter-Trends-API liefert X / Twitter-Daten als normalisiertes JSON aus einem POST-Aufruf an /v1/run/twitter.trends. Hole aktuelle X-(Twitter-)Trends weltweit, für ein Land oder eine Stadt in der Rangfolge von X, einschließlich des aufgelösten Standorts. AnyAPI routet jede Anfrage über 2 Quellen und weicht automatisch aus, wenn eine ausfällt. Sie kostet ab 0,10 USD pro 1.000 Anfragen, in US-Dollar, ohne Abo und ohne monatliches Minimum. In den letzten 30 Tagen waren 99,9% der X / Twitter Trends-Aufrufe über AnyAPI erfolgreich, bei einer mittleren Antwortzeit von 1,0 Sekunden über 10.352 gemessene Aufrufe.