threads/
post-replies

Собирайте ответы под публикациями Threads по их URL: текст ответа, автор и отметка верификации, число лайков и ответов, медиа, время и ID публикации, на которую дан ответ.

Threads Post Replies API

URL публикации на входе
Около 20 ответов на публикацию
Лайки и число ответов
Отметка верифицированного автора
0,3 кредита за результат
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Threads Post Replies

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

Возможности Threads Post Replies API

  • Ответы прямо по ссылкам на публикацииПередайте в urls одну или несколько ссылок /@{username}/post/{code} на threads.com или threads.net и получите ответы, которые Threads показывает под каждой публикацией, около 20 на публикацию.
  • Вовлеченность каждого ответаmetrics.likes_count показывает, сколько поддержки получил ответ, а metrics.replies_count — сколько дальнейшего обсуждения он вызвал.
  • Авторы ответов с верификациейauthor содержит имя пользователя, отображаемое имя, url профиля и аватар каждого отвечающего, а is_verified отделяет владельцев галочки от остальных.
  • Привязка к публикации, на которую дан ответpost_id указывает публикацию, к которой относится каждый ответ, а url открывает сам ответ, так что смешанные пакеты легко разделить и проверить.

Параметры Threads Post Replies API

ПараметрыОбязательныйОписание
urlsОбязательныйСсылки на публикации Threads в формате /@{username}/post/{code} на threads.com или threads.net, например https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1.

Как использовать Threads Post Replies API

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

  1. Отправьте {"urls": ["https://www.threads.com/@unrivaledbasketball/post/Dfa88pLDs_1"]} методом POST на /v1/threads/post-replies и запишите task_id.
  2. Опрашивайте GET /v1/tasks/{task_id}; ответы готовы, когда status становится succeeded.
  3. Читайте ответы из results.items, а если has_more равно true, продолжайте с results.next_cursor.
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"]}'

# 0.3 credits per reply; posts without replies are free.

Сценарии использования Threads Post Replies API

  • Оценка реакции на анонс: Читайте текст ответов под публикацией о запуске или новости и взвешивайте его по likes_count, чтобы увидеть, какие реакции поддержала аудитория.
  • Сбор отзывов клиентов под публикациями бренда: Собирайте ответы под публикациями бренда вместе с published_at, чтобы фиксировать вопросы, жалобы и запросы по мере их появления.
  • Поиск самых вовлеченных людей в аудитории: Посчитайте, как часто каждый author.username отвечает на публикации автора и сколько лайков собирают эти ответы, чтобы найти постоянных участников, с которыми стоит связаться.
  • Сравнение реакции на разные публикации: Отправьте несколько публикаций вместе и сгруппируйте ответы по post_id, чтобы сравнить объем и тон реакции на каждую.

Практические советы по Threads Post Replies API

  • Копируйте ссылку на саму публикацию: адрес профиля вроде /@username здесь отклоняется, а собственные ответы аккаунта в других обсуждениях возвращает Threads User Replies API.
  • Рассчитывайте примерно на 20 ответов на публикацию, то есть около 6 кредитов при 0,3 кредита за ответ, и оценивайте бюджет пакета, умножая это на число публикаций.
  • Удаляйте дубликаты по id при повторном сборе той же публикации: ответы, которые показывает Threads, могут пересекаться от запуска к запуску.

Помимо Threads Post Replies API, используйте эти API, когда нужен другой тип публичных данных Threads.

  • Threads Posts API — Собирайте по поддерживаемым URL публикаций Threads текст публичных публикаций, контекст автора, медиа, метки времени и видимую вовлеченность.
  • Threads Profiles API — Собирайте по поддерживаемым URL профилей Threads публичные данные аккаунта, описания, изображения, сайты, видимые счетчики и контекст сбора.
  • Threads User Posts API — Находите публичные публикации по URL профилей Threads с лимитом на профиль: нормализованный контент, авторы, медиа, метки времени, видимая вовлеченность и контекст источника.
  • Threads Search API — Ищите в Threads по ключевому слову или хештегу топовые публикации с текстом, авторами, лайками, ответами, репостами, медиа и временем.
  • Threads User Search API — Находите аккаунты Threads по имени или нику: имена пользователей, отображаемые имена, URL профилей, аватары и статус верификации.
  • Threads User Replies API — Собирайте последние публичные ответы аккаунта по URL профилей Threads: текст, вовлеченность, медиа и ссылки.

Другие платформы

Объединяйте данные Threads с публичными данными других поддерживаемых соцсетей.

Threads Post Replies API — FAQ

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

Используйте собственную ссылку публикации в формате /@{username}/post/{code}. Подходят адреса как threads.com, так и threads.net.

Каждая публикация возвращает ответы, которые Threads показывает под ней, — около 20, поэтому в запросе достаточно передать только ссылки на публикации.

Добавьте все ссылки на публикации в urls. Каждый ответ содержит post_id, по которому видно, к какой публикации он относится.

Каждый возвращенный ответ стоит 0,3 кредита, так что публикация, под которой около 20 ответов, обойдется примерно в 6 кредитов.