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}
Цены и поставщики
Цена API X / Twitter Тренды: один API, поставщиков 2, и любой может заменить другого
Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.
Попробовать
Получите X / Twitter Тренды одним запросом
{
"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"
}
}Полный справочник по параметрам и ответу: каждое поле, тип и пример для этого эндпоинта.
Справочник
Один запрос, один формат ответа.
Каждое поле, которое вы отправляете, и каждое поле, которое получаете, с реальным примером.
Проверено 2026-10-07 · доступность и задержка измерены за 30d
Тело запроса
JSON, отправляется на этот эндпоинт.
- limitinteger
10
Максимальное число возвращаемых ранжированных трендов (1-50, по умолчанию 50).
- locationstring
United States
Название страны, название города или код страны по ISO. Не указывайте, чтобы получить тренды по всему миру.
- requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `promoted`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в тренде, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.
Ответ
JSON, по одному примеру значения на поле.
- foundboolean
true
- locationstring
United States
- locationIdstring
23424977
- asOfUtcnumber
1727366400
- urlstring
https://x.com/search?q=%23NBAOpeningNight
- ranknumber
1
- namestring
#NBAOpeningNight
- isHashtagbooleanможет потребовать
true
- querystring
%23NBAOpeningNight
- promotedbooleanможет потребовать
false
Вопросы и ответы
Об 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,6% вызовов X / Twitter Тренды через AnyAPI завершились успешно, медианное время ответа 1,6 с, измерено вызовов: 678.