X / Twitter Тренды API
Возвращает текущие тренды X (Twitter) для всего мира, страны или города в порядке ранжирования X, включая определённое местоположение.
0,10 USD/1 тыс. запросов, оплата за запрос, без подписки.
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"}
Цены и поставщики
Цена API X / Twitter Тренды: один API, поставщиков 2, и любой может заменить другого
Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.
Попробовать
Получите X / Twitter Тренды одним запросом
В этом примере показано полей: 12 из 13. Все поля
{
"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"
}
]
}
}Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.
Справочник
Один запрос, один формат ответа.
Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.
Проверено 2026-11-21 · доступность и задержка измерены за 30d
Тело запроса
JSON, отправляется на этот эндпоинт.
- limitinteger
10
Максимальное число возвращаемых ранжированных трендов (1-50, по умолчанию 50).
- locationstring
United States
Название страны, название города или код страны по ISO. Не указывайте, чтобы получить тренды по всему миру.
- requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `promoted`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в тренде, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.
Ответ
JSON, по одному примеру значения на поле.
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.
- isHashtagbooleanможет потребовать
true
Whether the trend text is a hashtag.
- namestring
#NBAOpeningNight
Trend text displayed by X. Populated whenever the provider has data for the entity.
- promotedbooleanможет потребовать
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.
Вопросы и ответы
Об API X / Twitter Тренды
AnyAPI X / Twitter Тренды API возвращает данные X / Twitter в виде нормализованного JSON одним вызовом POST к /v1/run/twitter.trends. Возвращает текущие тренды X (Twitter) для всего мира, страны или города в порядке ранжирования X, включая определённое местоположение. AnyAPI направляет каждый запрос по источникам (их 2) и автоматически переключается, если один из них отказывает. Это стоит от 0,10 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. За последние 30 дней 99,9% вызовов X / Twitter Тренды через AnyAPI завершились успешно, медианное время ответа 1,0 с, измерено вызовов: 10 352.