Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Threads: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Получите посты Threads с упоминанием ключевого слова: текст, автор, число лайков и комментариев и время публикации. | $0.56 за 1 000 запросов | Норма |
Профилиprofile | Получите данные аккаунта Threads по имени пользователя: отображаемое имя, описание, число подписчиков, внешнюю ссылку и флаги верификации и приватности. | $0.56 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Получите список постов аккаунта Threads с отдельными счётчиками лайков, комментариев, репостов, цитат, отправок и просмотров, а также хештегами и упоминаниями. | $0.56 за 1 000 запросов | Норма |
Сведения о постеpost_detail | Получите один пост Threads по полному URL: текст, автора, показатели вовлечённости, хештеги, медиа и флаг платного партнёрства. | $0.56 за 1 000 запросов | Норма |
Комментарииcomments | Соберите ответы на пост в Threads. | $0.56 за 1 000 запросов | Норма |
Подбор профилейdiscover_profiles | Находите профили авторов Threads по ключевому слову: описание, число подписчиков, верификация, внешние ссылки и указанные email или телефоны. | $0.56 за 1 000 запросов | Норма |
Подписчикиfollowers | Получите число подписчиков, подписок, постов и лайков аккаунта Threads с флагом precision, который отмечает округлённые значения. | $0.56 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Threads?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Получите посты Threads с упоминанием ключевого слова: текст, автор, число лайков и комментариев и время публикации. Поиск профилей по имени не выполняется, полная история и охват в реальном времени не гарантируются. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=15, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · url · text · author_name · author_username · author_id · like_count · comment_count · posted_at · author_is_verified · media · hashtags · mentions · links · platform |
profileПрофили Получите данные аккаунта Threads по имени пользователя: отображаемое имя, описание, число подписчиков, внешнюю ссылку и флаги верификации и приватности. Передайте имя пользователя с @ или без, а не URL профиля. Закрытые профили не открываются. | username | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | user_id · username · display_name · bio · follower_count · is_verified · is_private · url · avatar_url · platform · external_url |
user_postsПосты пользователя Получите список постов аккаунта Threads с отдельными счётчиками лайков, комментариев, репостов, цитат, отправок и просмотров, а также хештегами и упоминаниями. Передайте имя пользователя, а не URL профиля. Один пакет может не охватывать всю историю и не включает ответы аккаунта. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · platform · media_type · hashtags · mentions |
post_detailСведения о посте Получите один пост Threads по полному URL: текст, автора, показатели вовлечённости, хештеги, медиа и флаг платного партнёрства. Возвращается только сам пост, без всей ветки вокруг него. | url | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · code · url · text · author_username · author_name · author_is_verified · like_count · comment_count · repost_count · quote_count · share_count · view_count · posted_at · is_paid_partnership · author_id · author_avatar_url · image_count · image_urls · platform · media_url · hashtags |
commentsКомментарии Соберите ответы на пост в Threads. У каждого ответа есть текст, автор, верификация, число лайков и то, на что он отвечает. Передайте полный URL поста. Вложенные ответы могут вернуться не все. | url | — | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · url · text · author_username · author_name · author_is_verified · like_count · comment_count · reply_to · posted_at · platform |
discover_profilesПодбор профилей Находите профили авторов Threads по ключевому слову: описание, число подписчиков, верификация, внешние ссылки и указанные email или телефоны. Действие выполняется как асинхронная задача, поэтому читайте готовый результат, а не первый ответ со статусом. Совпадение не подтверждает ни личность, ни соответствие задаче. | keyword | since, until | Режим выдачи: Async | Значения в каталоге: defaultLimit=10, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | username · display_name · bio · follower_count · is_verified · url · avatar_url · platform · emails · phones · external_links |
followersПодписчики Получите число подписчиков, подписок, постов и лайков аккаунта Threads с флагом | username | channel | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | id · username · url · follower_count · following_count · post_count · like_count · connection_count · precision · platform |
Что означают параметры действия search в API Threads?
Получите посты Threads с упоминанием ключевого слова: текст, автор, число лайков и комментариев и время публикации. Поиск профилей по имени не выполняется, полная история и охват в реальном времени не гарантируются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковый запрос для поиска публичных постов в search или профилей авторов в discover_profiles. Действие discover_profiles работает асинхронно, поэтому первоначальный ответ со статусом задачи нельзя интерпретировать как итоговый список авторов.Официальная документация Meta: поиск в Threads по ключевым словам и метрики вовлечённости — Официальные источники Meta описывают поиск публичных публикаций по ключевым словам и различают ответы, репосты, цитаты и пересылки за пределы платформы. Это определяет объекты и термины Threads, но не означает, что этот эндпоинт API поддерживает все официальные возможности фильтрации, операций записи или аналитики. · Проверено
Что означают параметры действия profile в API Threads?
Получите данные аккаунта Threads по имени пользователя: отображаемое имя, описание, число подписчиков, внешнюю ссылку и флаги верификации и приватности. Передайте имя пользователя с @ или без, а не URL профиля. Закрытые профили не открываются.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Имя пользователя Threads (с @ или без) для действий profile, user_posts и followers. Действия profile и user_posts не принимают полные URL профилей. Действие followers возвращает общее число подписчиков, а не список пользователей.Официальная документация Meta: профили Threads, число подписчиков и ограничения доступа — Официальные источники Meta определяют `username`, отображаемое имя, описание профиля и `follower_count`. В них отмечается, что для поиска публичных профилей нужны отдельные разрешения, стандартный доступ ограничен некоторыми официальными аккаунтами, а также действуют пороговые требования к статусу публичного аккаунта и числу подписчиков. Источник приведён только для пояснения терминов платформы и не означает, что этот API имеет такие разрешения или повторяет возможности официальных эндпоинтов. · Проверено
Что означают параметры действия user_posts в API Threads?
Получите список постов аккаунта Threads с отдельными счётчиками лайков, комментариев, репостов, цитат, отправок и просмотров, а также хештегами и упоминаниями. Передайте имя пользователя, а не URL профиля. Один пакет может не охватывать всю историю и не включает ответы аккаунта.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Имя пользователя Threads (с @ или без) для действий profile, user_posts и followers. Действия profile и user_posts не принимают полные URL профилей. Действие followers возвращает общее число подписчиков, а не список пользователей.Официальная документация Meta: как найти публикации Threads по имени пользователя — Официальные источники Meta разделяют эндпоинты профиля пользователя и эндпоинты публикаций пользователя: `profile_posts` находит публикации по точному имени пользователя и возвращает отдельные поля, например `id`, `shortcode` и `permalink`. Не следует считать, что этот эндпоинт API поддерживает официальные параметры `access_token`, пагинации и дат. · Проверено
Что означают параметры действия post_detail в API Threads?
Получите один пост Threads по полному URL: текст, автора, показатели вовлечённости, хештеги, медиа и флаг платного партнёрства. Возвращается только сам пост, без всей ветки вокруг него.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Полный URL поста (например, https://www.threads.com/@username/post/POST_CODE) для действий post_detail и comments. Действие comments не гарантирует получение всех вложенных веток комментариев.Официальная документация Meta: репосты, цитаты и пересылки за пределы Threads — Официальные источники Meta разделяют репосты, цитаты и пересылки, причём пересылками считаются именно публикации за пределами платформы. Это поясняет метрики вовлечённости исходной публикации, но не гарантирует, что каждая метрика будет присутствовать в каждом ответе или что поддерживаются действия по публикации. · Проверено
Что означают параметры действия comments в API Threads?
Соберите ответы на пост в Threads. У каждого ответа есть текст, автор, верификация, число лайков и то, на что он отвечает. Передайте полный URL поста. Вложенные ответы могут вернуться не все.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Полный URL поста (например, https://www.threads.com/@username/post/POST_CODE) для действий post_detail и comments. Действие comments не гарантирует получение всех вложенных веток комментариев.Официальная документация Meta: ответы верхнего уровня и полные деревья обсуждений — Официальные источники Meta отличают ответы верхнего уровня от полных обсуждений неограниченной глубины и определяют `replied_to` как ID непосредственного родительского контента. В этом API `reply_to` содержит имя пользователя, которому адресован ответ, а не официальное поле `replied_to`, и не гарантирует полного дерева комментариев. Кроме того, поля могут отсутствовать из-за ограничений видимости и авторского права. · ПровереноОфициальная документация Meta: какие разрешения нужны для чтения ответов в Threads — Официальная документация Meta по управлению ответами относится к собственным публикациям аккаунта в Threads и требует соответствующего токена доступа и разрешений на чтение. Ссылка на неё не гарантирует доступа к произвольным публикациям третьих лиц и не доказывает, что продукт получил разрешение платформы. · Проверено
Что означают параметры действия discover_profiles в API Threads?
Находите профили авторов Threads по ключевому слову: описание, число подписчиков, верификация, внешние ссылки и указанные email или телефоны. Действие выполняется как асинхронная задача, поэтому читайте готовый результат, а не первый ответ со статусом. Совпадение не подтверждает ни личность, ни соответствие задаче.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Поисковый запрос для поиска публичных постов в search или профилей авторов в discover_profiles. Действие discover_profiles работает асинхронно, поэтому первоначальный ответ со статусом задачи нельзя интерпретировать как итоговый список авторов.Официальная документация Meta: поиск публичных профилей не является точным поиском пользователей по ключевым словам — Официальный `profile_lookup` Meta требует точного имени пользователя и зависит от разрешений, уровня доступа и соответствия аккаунта требованиям. Поиск потенциально подходящих профилей по ключевому слову в этом API нельзя считать эквивалентом официального поиска по точному имени пользователя, а официальная документация не гарантирует охвата всех пользователей. · Проверено
sinceНеобязательный- Общий параметр нижней границы даты для discover_profiles. Фильтрация найденных профилей не гарантируется, а по дате создания аккаунта он не фильтрует.
untilНеобязательный- Общий параметр верхней границы даты для discover_profiles. Полный охват авторов за этот период не гарантируется; у search нет фильтра по дате.
Что означают параметры действия followers в API Threads?
Получите число подписчиков, подписок, постов и лайков аккаунта Threads с флагом precision, который отмечает округлённые значения. Возвращаются только числа, без списка подписчиков и без динамики.
usernameОбязательный- Имя пользователя Threads (с @ или без) для действий profile, user_posts и followers. Действия profile и user_posts не принимают полные URL профилей. Действие followers возвращает общее число подписчиков, а не список пользователей.Официальная документация Meta: профили Threads, число подписчиков и ограничения доступа — Официальные источники Meta определяют `username`, отображаемое имя, описание профиля и `follower_count`. В них отмечается, что для поиска публичных профилей нужны отдельные разрешения, стандартный доступ ограничен некоторыми официальными аккаунтами, а также действуют пороговые требования к статусу публичного аккаунта и числу подписчиков. Источник приведён только для пояснения терминов платформы и не означает, что этот API имеет такие разрешения или повторяет возможности официальных эндпоинтов. · Проверено
channelНеобязательный- Запасной параметр совместимости для имени аккаунта в действии followers. Приоритет ниже, чем у username. Возвращает число подписчиков, а не списки участников каналов или групп.
Как использовать API Threads
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"threads","action":"search","params":{"keyword":"<keyword>"}}'
Руководства по API Threads
Практические примеры и методики на основе этих действий. Сначала сверьтесь с актуальными действиями, параметрами и полями на этой странице: примеры и ограничения из статьи не заменяют актуальный каталог.
Как мониторить репутацию на нескольких платформах: сначала определите охват, потом оценивайте рост негатива
Спроектируйте прослеживаемый процесс мониторинга репутации на основе списков целей, идентификаторов комментариев и инкрементальных курсоров; офлайн-примеры показывают дедупликацию и пробелы в сборе данных при сохранении ручной проверки.
Читать статьюБыстрый старт с единым API данных: от каталога возможностей к первому полученному результату
Получайте данные с разных платформ через platform, action и params: изучите каталог возможностей, выполните минимальные запросы, обработайте асинхронные задачи и частичные результаты, учтите оплату и обеспечьте прослеживаемость записей данных.
Читать статьюВопросы об API Threads
Какие данные можно получить через API Threads?
Укажите в platform значение threads. В текущем каталоге: поиск, профили, посты пользователя, сведения о посте, комментарии и more. Эти названия действий соответствуют разным объектам или представлениям Threads; это не взаимозаменяемые режимы поиска.
Есть ли у Threads официальный API?
Да. Threads API от Meta предназначен для публикации собственных постов пользователя в Threads и управления ими. Для поиска публичных постов по ключевым словам и просмотра публичных профилей нужны разрешения threads_keyword_search и threads_profile_discovery. Их выдают только после проверки приложения в Meta App Review, а на каждого пользователя действуют лимиты: 2 200 поисковых запросов и 1 000 запросов профилей за 24 часа.
Официальные источники: «Meta: Threads keyword search» · «Meta: Threads API overview» · Проверено
Нужен ли аккаунт разработчика Threads или API-ключ?
Нет. Запросы идут через EveryInfra с API-ключом EveryInfra: зарегистрируйтесь, создайте ключ в консоли и передавайте его в заголовке Authorization: Bearer <API_KEY>. Вам не нужно регистрировать приложение разработчика Threads, запрашивать доступ к API Threads или входить через аккаунт Threads. Действия возвращают только публичные данные Threads.
Сколько стоит Threads API за 1 000 запросов?
$0.56 за 1 000 запросов в зависимости от действия; цена каждого действия указана в таблице на этой странице и в публичном каталоге. Подписки нет: вы пополняете баланс в USD и платите за каждый вызов, а неудачные вызовы и пустые результаты не оплачиваются.
Какие входные данные нужны для запроса search к платформе Threads?
Поисковый запрос для поиска публичных постов в search или профилей авторов в discover_profiles. Действие discover_profiles работает асинхронно, поэтому первоначальный ответ со статусом задачи нельзя интерпретировать как итоговый список авторов. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Threads?
Объявленная схема включает text, author_name, author_username и author_id. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Threads возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync и режим выдачи: async.