Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API X (Twitter)

Поиск постов, профилей пользователей и ответов в обсуждениях по ключевым словам или никнеймам для наблюдения за обсуждениями и подбора контента.

Посты по ключевому слову и профили пользователей по никнейму. По умолчанию поиск возвращает результаты вкладки «Популярное» (Top) в X.

Доступность платформы

Состояние за 24 ч
87%
Доступно

За последние 30 дней

Доступные возможности

Все действия X (Twitter): что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.

ВозможностьОписаниеЗа 1000Состояние за 24 часа
ПоискsearchИщите твиты по ключевому слову и получайте их в формате JSON.$0.56 за 1 000 запросовРаботает стабильно · состояние 99%
ПрофилиprofileПроверьте аккаунт X (Twitter) по имени пользователя: био, местоположение, число подписчиков, подписок и постов, статус верификации и дату создания аккаунта.$0.56 за 1 000 запросовНорма
Посты пользователяuser_postsВыгрузите посты аккаунта X (Twitter) с числом лайков, репостов, ответов и просмотров по каждому, а также временем публикации.$0.56 за 1 000 запросовНорма
Сведения о постеpostПолучите один пост X (Twitter) по числовому ID: полный текст, автора, время публикации, число лайков, репостов, ответов и просмотров.$0.56 за 1 000 запросовНорма
КомментарииcommentsСоберите ответы на пост в X (Twitter).$0.56 за 1 000 запросовНорма
ТрендыtrendingПолучите список трендов X (Twitter) с позицией, объёмом обсуждения, периодом и временем сбора.$0.56 за 1 000 запросовНорма
Список подписчиковfollowers_listИзучите аудиторию аккаунта X (Twitter) через его подписчиков.$0.56 за 1 000 запросовНорма
Список подписокfollowing_listПолучите аккаунты, на которые подписан пользователь X (Twitter), с био, местоположением, числом подписчиков и постов и статусом верификации каждого.$0.56 за 1 000 запросовНорма
Посты с медиаuser_mediaПолучите посты из вкладки «Медиа» аккаунта X (Twitter) по username: посты с фото или видео, сначала новые.$0.81 за 1 000 запросовНорма
Вкладка «Ответы»user_repliesПолучите посты из вкладки «Ответы» аккаунта X (Twitter) по username, сначала новые.$0.81 за 1 000 запросовНорма
Пользователи, сделавшие репостretweetersПолучите список аккаунтов, сделавших репост одного поста X (Twitter), по его числовому id.$0.81 за 1 000 запросовНорма
Профили по ID пользователейprofiles_by_idsНайдите до 20 аккаунтов X (Twitter) за раз по числовым ID пользователей в user_ids.$0.81 за 1 000 запросовНорма
Об этом аккаунтеuser_aboutЧитайте страницу «Об этом аккаунте» пользователя X (Twitter) по username: страну, в которой находится аккаунт, и точны ли эти данные, способ регистрации, сколько раз менялось имя пользователя и когда в последний раз, а также с какого момента аккаунт верифицирован.$0.81 за 1 000 запросовНорма
Проверка подпискиcheck_followПроверьте, подписан ли один аккаунт X (Twitter) на другой.$0.81 за 1 000 запросовНорма
Проверка репостаcheck_retweetПроверьте, сделал ли аккаунт X (Twitter) репост поста.$0.81 за 1 000 запросовНорма
Сведения о сообществеcommunity_infoПолучите данные сообщества X (Twitter) по числовому community_id: название, описание, тему, число участников, флаг NSFW, баннер, дату создания и правила.$0.81 за 1 000 запросовНорма
Поиск сообществsearch_communitiesИщите сообщества X (Twitter) по keyword.$0.81 за 1 000 запросовНорма
Поиск пользователейsearch_usersИщите аккаунты X (Twitter) по keyword, как во вкладке «Люди»: поиск идёт по именам пользователей, отображаемым именам и био.$0.56 за 1 000 запросовНорма
Расшифровка видеоvideo_transcriptПреобразуйте речь из видеопоста X (Twitter) в текст по ссылке на пост или его ID.$0.96 за 1 000 запросовНорма
ВеткаthreadПередайте ссылку на пост X (Twitter) и получите всю ветку, опубликованную его автором, начиная с первого поста, до 100 постов.$2.15 за 1 000 запросовНорма
Посты сообществаcommunity_postsЧитайте последние посты одного сообщества X (Twitter) по числовому community_id.$0.81 за 1 000 запросовНорма

Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.

Какие параметры принимает каждое действие API X (Twitter)?

Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.

Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.

ДействиеОбязательныеНеобязательныеСпособ получения результатаЛимитЗа 1 000Поля ответа
search

Поиск

Ищите твиты по ключевому слову и получайте их в формате JSON. Для каждого поста возвращаются текст, автор, число его подписчиков и счётчики вовлечённости. В запросе можно использовать операторы вроде from: или since:. По умолчанию сначала идут популярные результаты. В режиме «Последние» посты могут идти не строго по времени.

keywordsortРежим выдачи: SyncЗначения в каталоге: defaultLimit=25, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовid · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
profile

Профили

Проверьте аккаунт X (Twitter) по имени пользователя: био, местоположение, число подписчиков, подписок и постов, статус верификации и дату создания аккаунта. Передавайте имя пользователя с @ или без, но не URL профиля. Результат не подтверждает личность, текущую активность или состав аудитории.

username—Режим выдачи: Sync—$0.56 за 1 000 запросовuser_id · username · display_name · bio · url · follower_count · following_count · post_count · is_verified · location · avatar_url · created_at · platform
user_posts

Посты пользователя

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

username—Режим выдачи: SyncЗначения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовid · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
post

Сведения о посте

Получите один пост X (Twitter) по числовому ID: полный текст, автора, время публикации, число лайков, репостов, ответов и просмотров. Передавайте ID строкой, чтобы JavaScript его не округлил, и не передавайте полную ссылку.

idtweet_idРежим выдачи: Sync—$0.56 за 1 000 запросовid · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
comments

Комментарии

Соберите ответы на пост в X (Twitter). У каждого ответа есть текст, автор, число подписчиков автора и собственные показатели вовлечённости. Передайте числовой id исходного поста. Полнота обсуждения не гарантируется.

idtweet_idРежим выдачи: SyncЗначения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовid · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · reply_to_user_id · reply_to · source · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
trending

Тренды

Получите список трендов X (Twitter) с позицией, объёмом обсуждения, периодом и временем сбора. Регион задаётся через country, по умолчанию весь мир. rank и volume отражают одно наблюдение, а не алгоритм или историю.

countryРежим выдачи: Sync—$0.56 за 1 000 запросовid · name · rank · volume · period · collected_at · platform
followers_list

Список подписчиков

Изучите аудиторию аккаунта X (Twitter) через его подписчиков. Для каждого подписчика возвращаются био, местоположение, счётчики, статус верификации и признак защищённого аккаунта. Список включает только тех подписчиков, которых показывает X, и может быть неполным. Счётчики в каждой записи относятся к самому подписчику.

username—Режим выдачи: SyncЗначения в каталоге: defaultLimit=200, maxLimit=2000. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовid · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform
following_list

Список подписок

Получите аккаунты, на которые подписан пользователь X (Twitter), с био, местоположением, числом подписчиков и постов и статусом верификации каждого. Подписки могут измениться в любой момент и не доказывают ни симпатии, ни взаимодействия.

username—Режим выдачи: SyncЗначения в каталоге: defaultLimit=200, maxLimit=2000. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.56 за 1 000 запросовid · username · url · name · text · location · avatar_url · follower_count · following_count · post_count · is_verified · is_protected · created_at · platform
user_media

Посты с медиа

Получите посты из вкладки «Медиа» аккаунта X (Twitter) по username: посты с фото или видео, сначала новые. Для каждого поста возвращаются текст, media, число лайков, репостов, ответов и просмотров, время публикации и данные автора. Около 12 постов на странице, их число может меняться; для следующих страниц используйте next_page_token.

usernamepage_tokenРежим выдачи: SyncКаждый вызов возвращает одну страницу; максимум записей на странице — 12. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет.$0.81 за 1 000 запросовnext_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_quote · is_repost · is_pinned · source · media · author_id · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
user_replies

Вкладка «Ответы»

Получите посты из вкладки «Ответы» аккаунта X (Twitter) по username, сначала новые. Для каждого поста возвращаются текст, is_reply и reply_to_id, счётчики вовлечённости, хештеги, упоминания и ссылки. Возвращаются только собственные посты аккаунта, без постов, на которые он отвечал. Около 30 на странице, их число может меняться; для следующих страниц используйте next_page_token.

usernamepage_tokenРежим выдачи: SyncКаждый вызов возвращает одну страницу; максимум записей на странице — 30. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет.$0.81 за 1 000 запросовnext_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · is_quote · is_repost · is_pinned · reply_to_id · media · hashtags · mentions · links · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_post_count · author_media_count · author_created_at · author_banner_url · platform
retweeters

Пользователи, сделавшие репост

Получите список аккаунтов, сделавших репост одного поста X (Twitter), по его числовому id. Для каждого аккаунта возвращаются имя пользователя, имя, био, число подписчиков, подписок и постов. До 100 на странице; для следующих страниц используйте next_page_token. В список попадают только репосты, которые X ещё показывает.

idpage_token, urlРежим выдачи: SyncКаждый вызов возвращает одну страницу; максимум записей на странице — 100. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет.$0.81 за 1 000 запросовmedia_count · next_page_token · id · username · url · name · text · follower_count · following_count · post_count · platform
profiles_by_ids

Профили по ID пользователей

Найдите до 20 аккаунтов X (Twitter) за раз по числовым ID пользователей в user_ids. Для каждого аккаунта возвращаются имя пользователя, отображаемое имя, ссылка на профиль, местоположение, статус верификации, признак защищённого аккаунта, аватар, дата создания и account_status. Био и число подписчиков не включаются: для них вызовите profile с полученным именем пользователя.

user_ids—Режим выдачи: SyncЗначения в каталоге: defaultLimit=20, maxLimit=20. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$0.81 за 1 000 запросовuser_id · username · display_name · url · location · is_verified · is_protected · affiliation · avatar_url · created_at · account_status · platform
user_about

Об этом аккаунте

Читайте страницу «Об этом аккаунте» пользователя X (Twitter) по username: страну, в которой находится аккаунт, и точны ли эти данные, способ регистрации, сколько раз менялось имя пользователя и когда в последний раз, а также с какого момента аккаунт верифицирован. Страна, источник регистрации и последнее изменение появляются, только если X их показывает.

username—Режим выдачи: Sync—$0.81 за 1 000 запросовuser_id · username · display_name · url · account_based_in · is_location_accurate · signup_source · username_change_count · last_username_change_at · is_verified · verified_since · is_protected · affiliation · avatar_url · account_status · platform
check_follow

Проверка подписки

Проверьте, подписан ли один аккаунт X (Twitter) на другой. Передайте предполагаемого подписчика в username, а аккаунт, на который он предположительно подписан, — в target_username; is_following вернёт true или false. Результат отражает статус подписки на момент вызова.

username, target_username—Режим выдачи: Sync—$0.81 за 1 000 запросовusername · target_username · is_following · platform
check_retweet

Проверка репоста

Проверьте, сделал ли аккаунт X (Twitter) репост поста. Передайте аккаунт в username и числовой id поста; is_retweeted вернёт true или false. Результат отражает репосты, которые X показывает на момент вызова.

username, idurlРежим выдачи: Sync—$0.81 за 1 000 запросовusername · post_id · is_retweeted · platform
community_info

Сведения о сообществе

Получите данные сообщества X (Twitter) по числовому community_id: название, описание, тему, число участников, флаг NSFW, баннер, дату создания и правила.

community_idurlРежим выдачи: Sync—$0.81 за 1 000 запросовid · url · name · description · topic · member_count · is_nsfw · banner_url · created_at · rules · platform
search_communities

Поиск сообществ

Ищите сообщества X (Twitter) по keyword. Для каждого сообщества возвращаются ID, ссылка, название, тема, число участников, признак NSFW и баннер. Около 10 на странице; для следующих страниц используйте next_page_token.

keywordpage_tokenРежим выдачи: SyncКаждый вызов возвращает одну страницу; максимум записей на странице — 10. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет.$0.81 за 1 000 запросовid · url · name · topic · member_count · is_nsfw · banner_url · platform · next_page_token
search_users

Поиск пользователей

Ищите аккаунты X (Twitter) по keyword, как во вкладке «Люди»: поиск идёт по именам пользователей, отображаемым именам и био. Для каждого аккаунта возвращаются био, аватар, число подписчиков, подписок и постов, статус верификации и дата создания. Около 20 на странице; для следующих страниц используйте next_page_token. Посты не возвращаются.

keywordpage_tokenРежим выдачи: SyncКаждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет.$0.56 за 1 000 запросовnext_page_token · id · username · url · name · text · avatar_url · follower_count · following_count · post_count · is_verified · created_at · platform
video_transcript

Расшифровка видео

Преобразуйте речь из видеопоста X (Twitter) в текст по ссылке на пост или его ID. Вы получите ID поста, ссылку, полную расшифровку в text и её word_count. Временных меток по сегментам нет. Для поста без видео или видео без речи возвращается пустой результат.

urlidРежим выдачи: Sync—$0.96 за 1 000 запросовid · url · text · word_count
thread

Ветка

Передайте ссылку на пост X (Twitter) и получите всю ветку, опубликованную его автором, начиная с первого поста, до 100 постов. Для каждого поста возвращаются текст, медиа, счётчики вовлечённости, время публикации и данные автора. Ответы других аккаунтов не включаются.

urlidРежим выдачи: SyncЗначения в каталоге: defaultLimit=100, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей.$2.15 за 1 000 запросовid · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · author_follower_count · quote_count · bookmark_count · language · conversation_id · is_reply · reply_to_id · source · media · author_id · author_avatar_url · author_bio · author_is_verified · author_following_count · author_created_at · author_banner_url · platform
community_posts

Посты сообщества

Читайте последние посты одного сообщества X (Twitter) по числовому community_id. Для каждого поста возвращаются текст, медиа, счётчики вовлечённости, время публикации, имя пользователя автора и статус его верификации. Около 20 постов на странице; для следующих страниц используйте next_page_token.

community_idpage_token, urlРежим выдачи: SyncКаждый вызов возвращает одну страницу; максимум записей на странице — 20. Число записей меняется от страницы к странице, поэтому неполная страница ещё не означает конец. Для следующей страницы передайте next_page_token с верхнего уровня ответа как page_token; когда его нет, остановитесь. Параметр limit принимается, но ни на что не влияет.$0.81 за 1 000 запросовnext_page_token · id · url · text · like_count · retweet_count · reply_count · view_count · posted_at · author_username · author_name · author_url · quote_count · language · is_quote · is_repost · is_pinned · source · media · author_id · author_is_verified · platform

Что означают параметры действия search в API X (Twitter)?

Ищите твиты по ключевому слову и получайте их в формате JSON. Для каждого поста возвращаются текст, автор, число его подписчиков и счётчики вовлечённости. В запросе можно использовать операторы вроде from: или since:. По умолчанию сначала идут популярные результаты. В режиме «Последние» посты могут идти не строго по времени.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
keywordОбязательный
Поисковый запрос по постам X; может содержать операторы поиска платформы, например from: или since:. Порядок результатов задаётся параметром sort.
sortНеобязательный
Предпочтительный порядок. latest запрашивает сначала самые новые посты. По умолчанию X возвращает результаты Top, и latest не гарантирует строго хронологический порядок.

Что означают параметры действия profile в API X (Twitter)?

Проверьте аккаунт X (Twitter) по имени пользователя: био, местоположение, число подписчиков, подписок и постов, статус верификации и дату создания аккаунта. Передавайте имя пользователя с @ или без, но не URL профиля. Результат не подтверждает личность, текущую активность или состав аудитории.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя X, при желании с префиксом @; полный URL профиля вводить не нужно. profile собирает данные об авторе из его недавних постов, а followers_list и following_list возвращают видимых подписчиков и видимые подписки соответственно.
X: чем имя пользователя (handle) отличается от отображаемого имени — X разделяет имя пользователя (handle) и отображаемое имя: имя пользователя образует идентификатор с @ и ссылку на профиль, а после его смены прежнее имя может занять кто-то другой. При архивировании не полагайтесь только на отображаемые имена или изменяемые имена пользователей для подтверждения личности. · Проверено

Что означают параметры действия user_posts в API X (Twitter)?

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

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя X, при желании с префиксом @; полный URL профиля вводить не нужно. profile собирает данные об авторе из его недавних постов, а followers_list и following_list возвращают видимых подписчиков и видимые подписки соответственно.
X: чем имя пользователя (handle) отличается от отображаемого имени — X разделяет имя пользователя (handle) и отображаемое имя: имя пользователя образует идентификатор с @ и ссылку на профиль, а после его смены прежнее имя может занять кто-то другой. При архивировании не полагайтесь только на отображаемые имена или изменяемые имена пользователей для подтверждения личности. · Проверено

Что означают параметры действия post в API X (Twitter)?

Получите один пост X (Twitter) по числовому ID: полный текст, автора, время публикации, число лайков, репостов, ответов и просмотров. Передавайте ID строкой, чтобы JavaScript его не округлил, и не передавайте полную ссылку.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
idОбязательный
Числовой ID поста для post или comments, то есть цифры после x.com/username/status/. Рекомендуется хранить его как строку, чтобы избежать потери точности больших целых чисел в JavaScript; не передавайте в id полный URL.
X: число просмотров не равно числу уникальных пользователей — X поясняет, что несколько просмотров одного человека могут засчитываться несколько раз, а у некоторых постов число просмотров недоступно. Это объясняет определения метрик и не означает, что этот эндпоинт может получать защищённый контент или закрытые аналитические данные. · Проверено
tweet_idНеобязательный
Альтернативный параметр для id, оставленный для совместимости. Имеет более низкий приоритет, чем id, и не заменяет обязательное публичное поле id.

Что означают параметры действия comments в API X (Twitter)?

Соберите ответы на пост в X (Twitter). У каждого ответа есть текст, автор, число подписчиков автора и собственные показатели вовлечённости. Передайте числовой id исходного поста. Полнота обсуждения не гарантируется.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
idОбязательный
Числовой ID поста для post или comments, то есть цифры после x.com/username/status/. Рекомендуется хранить его как строку, чтобы избежать потери точности больших целых чисел в JavaScript; не передавайте в id полный URL.
X: ID исходного поста, ID беседы и связи между ответами — X обозначает через conversation_id ID исходного поста, с которого началась беседа; это значение может быть общим для ответов разных уровней. Чтобы восстановить связи «родитель — потомок», нужны идентификаторы родительских постов. Этот эндпоинт не возвращает такие поля связей, поэтому деревьев ответов, как в официальных примерах, в текущем ответе не будет. · Проверено
tweet_idНеобязательный
Альтернативный параметр для id, оставленный для совместимости. Имеет более низкий приоритет, чем id, и не заменяет обязательное публичное поле id.

Что означают параметры действия trending в API X (Twitter)?

Получите список трендов X (Twitter) с позицией, объёмом обсуждения, периодом и временем сбора. Регион задаётся через country, по умолчанию весь мир. rank и volume отражают одно наблюдение, а не алгоритм или историю.

Полный справочник API: параметры, примеры кода, пример ответа и состояние

Что означают параметры действия followers_list в API X (Twitter)?

Изучите аудиторию аккаунта X (Twitter) через его подписчиков. Для каждого подписчика возвращаются био, местоположение, счётчики, статус верификации и признак защищённого аккаунта. Список включает только тех подписчиков, которых показывает X, и может быть неполным. Счётчики в каждой записи относятся к самому подписчику.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя X, при желании с префиксом @; полный URL профиля вводить не нужно. profile собирает данные об авторе из его недавних постов, а followers_list и following_list возвращают видимых подписчиков и видимые подписки соответственно.
X: подписчики и подписки — в чём разница — X отдельно объясняет, кто подписан на вас и на кого подписаны вы, поскольку подписка не обязательно взаимна; для защищённых постов действуют дополнительные ограничения доступа. Запросы списков не выполняют массовую подписку и не расширяют права доступа. · Проверено

Что означают параметры действия following_list в API X (Twitter)?

Получите аккаунты, на которые подписан пользователь X (Twitter), с био, местоположением, числом подписчиков и постов и статусом верификации каждого. Подписки могут измениться в любой момент и не доказывают ни симпатии, ни взаимодействия.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Имя пользователя X, при желании с префиксом @; полный URL профиля вводить не нужно. profile собирает данные об авторе из его недавних постов, а followers_list и following_list возвращают видимых подписчиков и видимые подписки соответственно.
X: подписчики и подписки — в чём разница — X отдельно объясняет, кто подписан на вас и на кого подписаны вы, поскольку подписка не обязательно взаимна; для защищённых постов действуют дополнительные ограничения доступа. Запросы списков не выполняют массовую подписку и не расширяют права доступа. · Проверено

Что означают параметры действия user_media в API X (Twitter)?

Получите посты из вкладки «Медиа» аккаунта X (Twitter) по username: посты с фото или видео, сначала новые. Для каждого поста возвращаются текст, media, число лайков, репостов, ответов и просмотров, время публикации и данные автора. Около 12 постов на странице, их число может меняться; для следующих страниц используйте next_page_token.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Аккаунт, публикации с фото и видео которого нужно получить, например NASA; начальный символ @ удаляется.
page_tokenНеобязательный
Токен страницы для user_media, user_replies, retweeters, search_communities, community_posts и search_users. Для первой страницы не передавайте его, затем передавайте next_page_token из предыдущего ответа в точности как получили. У последней страницы токена нет.

Что означают параметры действия user_replies в API X (Twitter)?

Получите посты из вкладки «Ответы» аккаунта X (Twitter) по username, сначала новые. Для каждого поста возвращаются текст, is_reply и reply_to_id, счётчики вовлечённости, хештеги, упоминания и ссылки. Возвращаются только собственные посты аккаунта, без постов, на которые он отвечал. Около 30 на странице, их число может меняться; для следующих страниц используйте next_page_token.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Аккаунт, ответы которого нужно получить, например NASA; начальный символ @ удаляется.
page_tokenНеобязательный
Токен страницы для user_media, user_replies, retweeters, search_communities, community_posts и search_users. Для первой страницы не передавайте его, затем передавайте next_page_token из предыдущего ответа в точности как получили. У последней страницы токена нет.

Что означают параметры действия retweeters в API X (Twitter)?

Получите список аккаунтов, сделавших репост одного поста X (Twitter), по его числовому id. Для каждого аккаунта возвращаются имя пользователя, имя, био, число подписчиков, подписок и постов. До 100 на странице; для следующих страниц используйте next_page_token. В список попадают только репосты, которые X ещё показывает.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
idОбязательный
Числовой ID поста: цифры после /status/ в его ссылке. Передавайте его строкой.
page_tokenНеобязательный
Токен страницы для user_media, user_replies, retweeters, search_communities, community_posts и search_users. Для первой страницы не передавайте его, затем передавайте next_page_token из предыдущего ответа в точности как получили. У последней страницы токена нет.
urlНеобязательный
Параметр для совместимости: ссылка на пост https://x.com/<username>/status/<ID>. Приоритет у id.

Что означают параметры действия profiles_by_ids в API X (Twitter)?

Найдите до 20 аккаунтов X (Twitter) за раз по числовым ID пользователей в user_ids. Для каждого аккаунта возвращаются имя пользователя, отображаемое имя, ссылка на профиль, местоположение, статус верификации, признак защищённого аккаунта, аватар, дата создания и account_status. Био и число подписчиков не включаются: для них вызовите profile с полученным именем пользователя.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
user_idsОбязательный
От 1 до 20 числовых ID пользователей X для profiles_by_ids: списком или строкой через запятую, например 44196397,11348282.

Что означают параметры действия user_about в API X (Twitter)?

Читайте страницу «Об этом аккаунте» пользователя X (Twitter) по username: страну, в которой находится аккаунт, и точны ли эти данные, способ регистрации, сколько раз менялось имя пользователя и когда в последний раз, а также с какого момента аккаунт верифицирован. Страна, источник регистрации и последнее изменение появляются, только если X их показывает.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Аккаунт, данные которого нужно получить, например NASA; начальный символ @ удаляется.

Что означают параметры действия check_follow в API X (Twitter)?

Проверьте, подписан ли один аккаунт X (Twitter) на другой. Передайте предполагаемого подписчика в username, а аккаунт, на который он предположительно подписан, — в target_username; is_following вернёт true или false. Результат отражает статус подписки на момент вызова.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Аккаунт, подписку которого нужно проверить, например NASA; начальный символ @ удаляется.
target_usernameОбязательный
Аккаунт, с которым сверяется check_follow: подписан ли на него username? Например, NASAHubble; символ @ в начале удаляется.

Что означают параметры действия check_retweet в API X (Twitter)?

Проверьте, сделал ли аккаунт X (Twitter) репост поста. Передайте аккаунт в username и числовой id поста; is_retweeted вернёт true или false. Результат отражает репосты, которые X показывает на момент вызова.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
usernameОбязательный
Аккаунт для проверки, например NASA; начальный символ @ удаляется.
idОбязательный
Числовой ID поста: цифры после /status/ в его ссылке. Передавайте его строкой.
urlНеобязательный
Параметр для совместимости: ссылка на пост https://x.com/<username>/status/<ID>. Приоритет у id.

Что означают параметры действия community_info в API X (Twitter)?

Получите данные сообщества X (Twitter) по числовому community_id: название, описание, тему, число участников, флаг NSFW, баннер, дату создания и правила.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
community_idОбязательный
Числовой ID сообщества для community_info и community_posts: цифры после /i/communities/ в его ссылке, например 1508567430188126209.
urlНеобязательный
Параметр для совместимости: ссылка на сообщество https://x.com/i/communities/<ID>. Приоритет у community_id.

Что означают параметры действия search_communities в API X (Twitter)?

Ищите сообщества X (Twitter) по keyword. Для каждого сообщества возвращаются ID, ссылка, название, тема, число участников, признак NSFW и баннер. Около 10 на странице; для следующих страниц используйте next_page_token.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
keywordОбязательный
Слова для поиска по названиям и темам сообществ, например crypto или photography.
page_tokenНеобязательный
Токен страницы для user_media, user_replies, retweeters, search_communities, community_posts и search_users. Для первой страницы не передавайте его, затем передавайте next_page_token из предыдущего ответа в точности как получили. У последней страницы токена нет.

Что означают параметры действия search_users в API X (Twitter)?

Ищите аккаунты X (Twitter) по keyword, как во вкладке «Люди»: поиск идёт по именам пользователей, отображаемым именам и био. Для каждого аккаунта возвращаются био, аватар, число подписчиков, подписок и постов, статус верификации и дата создания. Около 20 на странице; для следующих страниц используйте next_page_token. Посты не возвращаются.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
keywordОбязательный
Тема, имя или имя пользователя для поиска аккаунтов, например ai agents. Возвращаются аккаунты, а не посты.
page_tokenНеобязательный
Токен страницы для user_media, user_replies, retweeters, search_communities, community_posts и search_users. Для первой страницы не передавайте его, затем передавайте next_page_token из предыдущего ответа в точности как получили. У последней страницы токена нет.

Что означают параметры действия video_transcript в API X (Twitter)?

Преобразуйте речь из видеопоста X (Twitter) в текст по ссылке на пост или его ID. Вы получите ID поста, ссылку, полную расшифровку в text и её word_count. Временных меток по сегментам нет. Для поста без видео или видео без речи возвращается пустой результат.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
urlОбязательный
Ссылка на пост с видео (https://x.com/<username>/status/<ID>) или числовой ID поста.
idНеобязательный
Параметр для совместимости: числовой ID поста. Приоритет у url.

Что означают параметры действия thread в API X (Twitter)?

Передайте ссылку на пост X (Twitter) и получите всю ветку, опубликованную его автором, начиная с первого поста, до 100 постов. Для каждого поста возвращаются текст, медиа, счётчики вовлечённости, время публикации и данные автора. Ответы других аккаунтов не включаются.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
urlОбязательный
Ссылка на любой пост в треде (https://x.com/<username>/status/<ID>) или числовой ID поста.
idНеобязательный
Параметр для совместимости: числовой ID поста. Приоритет у url.

Что означают параметры действия community_posts в API X (Twitter)?

Читайте последние посты одного сообщества X (Twitter) по числовому community_id. Для каждого поста возвращаются текст, медиа, счётчики вовлечённости, время публикации, имя пользователя автора и статус его верификации. Около 20 постов на странице; для следующих страниц используйте next_page_token.

Полный справочник API: параметры, примеры кода, пример ответа и состояние
community_idОбязательный
Числовой ID сообщества для community_info и community_posts: цифры после /i/communities/ в его ссылке, например 1508567430188126209.
page_tokenНеобязательный
Токен страницы для user_media, user_replies, retweeters, search_communities, community_posts и search_users. Для первой страницы не передавайте его, затем передавайте next_page_token из предыдущего ответа в точности как получили. У последней страницы токена нет.
urlНеобязательный
Параметр для совместимости: ссылка на сообщество https://x.com/i/communities/<ID>. Приоритет у community_id.

Как использовать API X (Twitter)

  1. 01Выберите действие платформы в публичном каталоге.
  2. 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
  3. 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
  4. 04Сохраните поля ответа, которые нужны вашему приложению.
twitter_search.sh
curl -X POST https://api.everyinfra.com/api/v1/social \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"platform":"twitter","action":"search","params":{"keyword":"<keyword>"}}'

Руководства по API X (Twitter)

Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.

Build

Как мониторить репутацию на нескольких платформах: сначала определите охват, потом оценивайте рост негатива

Спроектируйте прослеживаемый процесс мониторинга репутации на основе списков целей, идентификаторов комментариев и инкрементальных курсоров; офлайн-примеры показывают дедупликацию и пробелы в сборе данных при сохранении ручной проверки.

Читать статью
Build

Быстрый старт с единым API данных: от каталога возможностей к первому полученному результату

Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.

Читать статью

Вопросы об API X (Twitter)

Какие данные можно получить через API X (Twitter)?

Укажите в platform значение twitter. В текущем каталоге: поиск, профили, посты пользователя, сведения о посте, комментарии и more. Эти названия действий соответствуют разным объектам или представлениям X (Twitter); это не взаимозаменяемые режимы поиска.

Есть ли у X (Twitter) официальный API?

Да. X API v2 открыт для любого разработчика через консоль разработчика X. С февраля 2026 года он оплачивается по факту использования: вы покупаете кредиты и платите за каждый ресурс, например 0,005 $ за чтение поста и 0,010 $ за чтение пользователя; без плана Enterprise можно прочитать не более 3 млн постов в месяц (цены по данным на октябрь 2026 года).

Официальные источники: «X API pricing» · «X API: getting access» · Проверено

Нужен ли аккаунт разработчика X (Twitter) или API-ключ?

Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика X (Twitter), запрашивать доступ к API X (Twitter) или входить через аккаунт X (Twitter). Действия возвращают только публичные данные X (Twitter).

Сколько стоит X (Twitter) API за 1 000 запросов?

От $0.56 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.

Какие входные данные нужны для запроса search к платформе X (Twitter)?

Поисковый запрос по постам X; может содержать операторы поиска платформы, например from: или since:. Порядок результатов задаётся параметром sort. Передайте это значение в поле keyword объекта params.

Какие поля может вернуть search на платформе X (Twitter)?

Объявленная схема включает text, like_count, retweet_count и reply_count. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.

Все ли действия X (Twitter) возвращают результат сразу?

Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.