threads/
user-reposts

Собирайте публикации, которые аккаунты Threads недавно репостнули, по URL профилей: каждая возвращается как оригинальная публикация с автором, текстом, вовлеченностью и медиа, около 25 на аккаунт.

Threads User Reposts API

URL профиля на входе
Оригинальный автор в каждой строке
Около 25 недавних репостов
0,5 кредита за результат
Готово
Готово

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

README

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

Threads User Reposts

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

Возможности Threads User Reposts API

  • Оригинальная публикация за каждым репостомКаждая строка — это репостнутая публикация, где author указывает ее исходного автора, так что видно, чей именно контент передал дальше аккаунт.
  • Вовлеченность оригиналаmetrics.likes_count, metrics.comments_count и metrics.shares_count дают лайки, ответы и репосты оригинальной публикации и показывают, насколько популярным уже был усиленный контент.
  • Недавние репосты по ссылке на профильurls принимает ссылки на профили, например https://www.threads.com/@shams, и каждый профиль возвращает публикации, которые он недавно репостнул, примерно до 25.

Параметры Threads User Reposts API

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

Как использовать Threads User Reposts API

Отправьте ссылку на профиль и прочитайте публикации, которые он репостнул.

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

# 0.5 credits per reposted post returned.

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

  • Определение авторов, которых усиливает аккаунт: Посчитайте author.username по репостам профиля, чтобы ранжировать авторов и издания, которыми он делится чаще всего.
  • Выявление партнеров, которых продвигает бренд: Изучите исходных авторов и text в репостах бренда, чтобы найти соавторов, амбассадоров и СМИ, которых он решает поддержать.
  • Отслеживание контента, расходящегося по сообществу: Соберите репосты группы аккаунтов из одной ниши и найдите id публикаций, которыми поделились сразу несколько из них.

Практические советы по Threads User Reposts API

  • Отправляйте один профиль на задачу, если нужно знать, какой аккаунт сделал каждый репост: author в каждой строке — это исходный автор.
  • Считайте published_at временем публикации оригинала; чтобы датировать появление репостов, собирайте данные по расписанию и фиксируйте, когда каждый id появился впервые.
  • Отправьте url строки в Threads Post Replies API, чтобы прочитать обсуждение под публикацией, которую аккаунт решил усилить.

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

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

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

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

Threads User Reposts API — FAQ

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

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

Каждый профиль возвращает публикации, которые он репостнул последними, примерно до 25.

Каждая возвращенная публикация стоит 0,5 кредита, так что профиль с 25 недавними репостами обойдется в 12,5 кредита.