API X / Twitter

X / Twitter Тренды API

Возвращает текущие тренды X (Twitter) для всего мира, страны или города в порядке ранжирования X, включая определённое местоположение.

0,10 USD/1 тыс. запросов, оплата за запрос, без подписки.

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

Что вернул APIitems[0]
{
"rank": 1,
"name": "#NBAOpeningNight",
"isHashtag": true,
"query": "%23NBAOpeningNight",
"promoted": false,
"url": "https://x.com/search?q=%23NBAOpeningNight"
}
Доступность
99,93%
30d · Вызовов: 10 352
Запросы
11 798
30 дн. · по неделям, последние недель: 12
Ответ
1,0s
медиана · 30d

Цены и поставщики

Цена API X / Twitter Тренды: один API, поставщиков 2, и любой может заменить другого

Первым обслуживает самый дешёвый поставщик. Если он не отвечает, его заменяет следующий в том же вызове.

Вы платите
1,00 USD
0,10 USD/1 тыс. запросов, только за то, чем пользуетесь. Без ежемесячного тарифа.
Ваши первые запросы (1 000) бесплатны за счёт стартового баланса 0,10 USD.

Попробовать

Получите X / Twitter Тренды одним запросом

requireFieldsarray
Необязательно; если не указывать, маршрутизация не меняется и обслуживает самый дешёвый источник. Назовите выходные поля, которые этот запрос должен уметь вернуть, например `promoted`, и его обслужит только источник, который возвращает каждое из них. Поля, которые вы не назвали, по-прежнему возвращаются, когда они есть у обслуживающего источника. Это может поднять вашу цену: если самый дешёвый источник не может вернуть названное поле, обслуживает более дорогой, и вам называют и списывают его цену. Названное поле всё равно может отсутствовать в тренде, где его действительно нет. Указание сочетания полей, которые вместе не возвращает ни один источник, отклоняется как неверный ввод, без списания.
Открыть в
Пример ответа
Бесплатные запуски возвращают только первые результаты: 3. Пополните ключ, чтобы получить полный ответ.

В этом примере показано полей: 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. Показанные значения это примеры, замените их своими.

Ответ

JSON, по одному примеру значения на поле.

datadata

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.

each itemdata.items[]

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.

top level
  • 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.

Это стоит от 0,10 USD за 1000 запросов, в долларах США, без подписки и без ежемесячного минимума. Вы пополняете один кошелёк в долларах США, и каждый вызов списывает с него. По некоторым неудавшимся запросам, оплаченным из кошелька, возникают расходы на обработку; мы передаём их по себестоимости, без наценки, а сумма списания указана в ответе с ошибкой.

Возвращает текущие тренды X (Twitter) для всего мира, страны или города в порядке ранжирования X, включая определённое местоположение. Ответ это нормализованный JSON с тем же конвертом, что возвращает каждый эндпоинт AnyAPI, поэтому разбор второго эндпоинта это смена URL и ничего больше.

За последние 30 дней 99,9% вызовов X / Twitter Тренды через AnyAPI завершились успешно, медианное время ответа 1,0 с, измерено вызовов: 10 352. Это собственные измерения AnyAPI по трафику через шлюз, пересчитываемые непрерывно, а не опубликованный целевой уровень обслуживания.

Да. Новый аккаунт AnyAPI стартует с бесплатным балансом 0,10 USD, карта не нужна. Этого хватает на 1 000 вызовов X / Twitter Тренды по 0,0001 USD за каждый.

AnyAPI в том же запросе обращается к следующему из источников (их 2), начиная с самого дешёвого, поэтому отказ одного источника не ломает ваш вызов.

Отправьте запрос POST на https://api.getanyapi.com/v1/run/twitter.trends с вашим ключом AnyAPI в заголовке "Authorization: Bearer" и входными данными в теле JSON. Один и тот же ключ и один и тот же кошелёк работают на каждом эндпоинте AnyAPI.

Нет. Вы пополняете один предоплаченный баланс AnyAPI в долларах США, и каждый запрос списывает с него. Ежемесячного тарифа и минимума нет, а один и тот же баланс оплачивает каждый эндпоинт AnyAPI.

Да. Установите @getanyapi/sdk из npm для TypeScript или getanyapi из pip для Python. Оба вызывают любой эндпоинт AnyAPI с одним и тем же ключом, а ещё подойдёт любой HTTP-клиент.

Да. Агент может подключиться к MCP-серверу AnyAPI по адресу https://api.getanyapi.com/mcp или создать собственный бесплатный пробный ключ одним POST без аутентификации на https://api.getanyapi.com/agent/signup и вызывать этот эндпоинт по HTTP.