Threadsпоиск в Threadsответы в Threadsруководство по API

Threads Search API: поиск публикаций и пользователей, сбор ответов и репостов

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

SocQОбновлено 19 ноября 2026 г.6 мин чтения

Первые эндпоинты SocQ для Threads читали публичные профили, отдельные публикации и публикации пользователя. 2026-11-17 запустились еще пять. Два из них — поиск: публикации по ключевому слову или хештегу и аккаунты по имени. Остальные три читают разговоры и распространение: ответы под публикацией, ответы, которые аккаунт оставляет в других местах, и публикации, которые он репостит.

В этом руководстве описано, что возвращает каждый новый эндпоинт, как выглядит запрос, сколько он стоит и когда его использовать. Как они соотносятся с собственным API Threads от Meta и другими поставщиками, читайте в статье Альтернативы API Threads.

Коротко: отправьте query на POST /v1/threads/search или /search-users либо URL Threads в urls на /post-replies, /user-replies или /user-reposts с заголовком Authorization: Bearer $SOCQ_API_KEY. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте data.results.items. Цены — от 0.3 до 0.6 кредита за результат (от $0.0015 до $0.003 при цене $0.005 за кредит), без базовой платы.

Пять новых эндпоинтов Threads

ЭндпоинтЧто возвращаетВходЦена
SearchТоповые публикации по ключевому слову или хештегу, около 20, с текстом, автором, лайками, ответами, репостами, медиа и временемquery0.6 кредита ($0.003) за публикацию
User SearchАккаунты, совпадающие с именем или юзернеймом, обычно до 10, с отображаемым именем, аватаром и верификациейquery0.6 кредита ($0.003) за аккаунт
Post RepliesОтветы под публикацией, около 20 на публикацию, с автором, лайками, ответами, медиа и временемURL публикаций0.3 кредита ($0.0015) за ответ
User RepliesПоследние публичные ответы аккаунта, примерно до 25, с вовлеченностью и медиаURL профилей0.5 кредита ($0.0025) за ответ
User RepostsПубликации, которые аккаунт недавно репостнул, примерно до 25, каждая с исходным авторомURL профилей0.5 кредита ($0.0025) за публикацию

Поиск в Threads

Threads Search: публикации по ключевому слову или хештегу

Threads Search API ищет в Threads так же, как приложение, и возвращает топовые публикации по ключевому слову или хештегу. Каждая публикация возвращается с текстом, автором, лайками, ответами, репостами, медиа и временем публикации. Это самый быстрый способ увидеть, как в Threads обсуждают тему, продукт или событие, и найти аккаунты, которые задают тон обсуждению.

curl -X POST "https://api.socq.ai/v1/threads/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "basketball"
  }'

Каждый поиск возвращает топовые публикации, которые Threads показывает по запросу, около 20. Показатели вовлеченности находятся в metrics: likes_count, comments_count и shares_count. См. документацию Search.

Threads User Search: аккаунты по имени

Threads User Search API находит аккаунты по имени или юзернейму. Каждое совпадение возвращает юзернейм, отображаемое имя, URL профиля, аватар и статус верификации. Используйте его, чтобы уточнить правильный хендл перед получением публикаций или ответов, или чтобы превратить список имен в профили Threads для исследования инфлюенсеров.

curl -X POST "https://api.socq.ai/v1/threads/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "shams"
  }'

Каждый поиск возвращает аккаунты, которые предлагает Threads, обычно до 10. См. документацию User Search.

Чтение разговоров и репостов

Threads Post Replies: разговор под публикацией

Threads Post Replies API читает разговор под публикацией. Каждый ответ содержит текст, автора, число лайков и ответов, прикрепленные медиа и время, а также post_id публикации, на которую он отвечает. Используйте его, чтобы оценить реакцию на анонс, собрать отзывы клиентов из публикаций бренда или найти самых вовлеченных людей в аудитории автора.

curl -X POST "https://api.socq.ai/v1/threads/post-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]
  }'

Используйте URL публикаций в форме /@{username}/post/{code}. Каждая публикация возвращает ответы, которые Threads показывает под ней, около 20. См. документацию Post Replies.

Threads User Replies: как аккаунт общается с другими

Threads User Replies API возвращает последние публичные ответы аккаунта с текстом, лайками, ответами, медиа, временем и ссылкой на каждый ответ. Ответы показывают тон и экспертизу прямее, чем отполированные публикации, поэтому они полезны для проверки авторов, мониторинга представителя компании или изучения того, как бренд ведет разговоры с клиентами.

curl -X POST "https://api.socq.ai/v1/threads/user-replies" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.threads.com/@reuters"]
  }'

Используйте URL профилей вида https://www.threads.com/@username. Каждый профиль возвращает примерно до 25 ответов. См. документацию User Replies.

Threads User Reposts: кого продвигает аккаунт

Threads User Reposts API возвращает публикации, которые аккаунт решил репостнуть. Каждая строка — это исходная публикация с автором, текстом, вовлеченностью и медиа. История репостов — прямой сигнал близости: она показывает, каким голосам доверяет автор, каких партнеров продвигает бренд и какой контент распространяется в сообществе.

curl -X POST "https://api.socq.ai/v1/threads/user-reposts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": ["https://www.threads.com/@shams"]
  }'

Каждый профиль возвращает примерно до 25 недавних репостов; author — это автор исходной публикации, а не аккаунт, который сделал репост. См. документацию User Reposts.

Простой сценарий исследования

  1. Запустите Search по названию продукта или хештегу, чтобы найти публикации, с которыми взаимодействуют люди.
  2. Передайте URL самых сильных публикаций в Post Replies, чтобы прочитать реакции.
  3. Используйте User Search, чтобы превратить всплывающие имена в хендлы, затем User Replies и User Reposts для этих профилей, чтобы увидеть, как они общаются и кого продвигают.
  4. Для собственных публикаций аккаунта или данных профиля используйте ранее выпущенные эндпоинты User Posts и Profiles.

Аутентификация и асинхронные задачи

Каждый запрос содержит ваш API-ключ и тип содержимого JSON:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Каждый вызов отправки запускает фоновую задачу:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Ответ на отправку возвращает data.task_id и data.status. Опрашивайте задачу с тем же ключом:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Пока задача находится в состоянии queued, running или failed, ответ содержит только метаданные задачи; при failed читайте error_message. Когда задача в состоянии succeeded, тот же ответ содержит первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500. Если has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. fields принимает до 50 полей или путей через точку, разделенных запятыми.

Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же task_id, а не отправляйте и не оплачивайте дубликат. Также можно добавить callback_url в тело запроса, чтобы получить один POST со сводкой задачи после ее завершения.

Сколько стоит типичная задача

  • Один поиск по ключевому слову, вернувший 20 публикаций: 20 × 0.6 = 12 кредитов, $0.06.
  • Ответы под 10 публикациями, примерно по 20 на каждую: 200 × 0.3 = 60 кредитов, $0.30.
  • Ответы и репосты 10 аккаунтов, примерно по 25 на каждый: 500 × 0.5 = 250 кредитов, $1.25.

FAQ

Можно ли получить больше первых 20 результатов поиска?

Search возвращает топовые публикации, которые Threads показывает по запросу, около 20 за поиск. Чтобы расширить охват, запускайте связанные ключевые слова или хештеги отдельными поисками.

Нужен ли вход в Threads или Instagram?

Нет. Запрос содержит только ваш API-ключ SocQ и поисковый запрос или публичные URL Threads; учетные данные аккаунта Threads в нем не участвуют.

Показывает ли User Reposts, кто сделал репост?

Вы запрашиваете данные для одного профиля, поэтому каждую строку репостнул именно этот профиль. author каждой строки — автор исходной публикации.

Можно ли отправить сразу несколько профилей или публикаций?

Да. Post Replies, User Replies и User Reposts принимают список в urls, а лимиты результатов применяются к каждому URL.

Где посмотреть все эндпоинты Threads и цены?

На странице платформы Threads и на странице цен.

THREADS API

Проверить сценарий на публичном URL Threads

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

API для Threads