threads/
user-posts

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

Threads User Posts API

URL профиля на входе
Лимит на каждый профиль
Нормализованные публичные посты
0,5 кредита за результат
Готово
Готово

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

README

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

Threads User Posts

Threads User Posts — это публичные посты, найденные на выбранных страницах профилей, с текстом, данными об авторе, ссылками на медиа, временем публикации и видимым числом взаимодействий. Эти записи вместе с временем сбора помогают архивировать контент аккаунтов, исследовать форматы и сравнивать публичную вовлеченность.

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

  • Ограниченный сбор по профилямПринимает один или несколько URL публичных профилей Threads и применяет results_limit отдельно к каждому профилю: по умолчанию 100, допустимый диапазон — от 1 до 2 000.
  • Нормализованные записи постов, авторов и медиаВозвращает идентификаторы постов, URL источника, текст, доступные данные об авторе и ссылки на публичные медиа в единой структуре результата.
  • Вовлеченность и контекст сбораСохраняет видимое число лайков, комментариев, репостов и пересылок вместе со временем публикации, collected_at и контекстом отправленного профиля, если они есть в записи источника.

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

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список URL публичных профилей Threads на threads.com или threads.net. Каждый путь должен иметь вид /@username; голые имена пользователей, URL постов и посторонние пути отклоняются.
results_limitНеобязательныйМаксимальное число постов для каждого URL профиля; по умолчанию 100, допускаются целые числа от 1 до 2 000.

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

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

  1. Подготовьте один или несколько URL публичных профилей Threads с путем /@username на threads.com или threads.net.
  2. Отправьте urls и необязательный results_limit методом POST на /v1/threads/user-posts и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
  4. Читайте data.results.items, а затем запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/threads/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

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

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

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

  • Перед отправкой проверяйте, что каждое значение — это URL профиля вида /@username на threads.com или threads.net, чтобы голые имена пользователей, ссылки на посты и посторонние пути не приводили к ошибке запроса.
  • Планируйте глубину сбора и предварительную оценку кредитов как число urls, умноженное на results_limit, потому что лимит применяется отдельно к каждому профилю.
  • Сохраняйте discovery_input, input_url и collected_at с каждым результатом, чтобы в дальнейших записях оставались отправленный профиль и время наблюдения.
  • Обрабатывайте текст, поля автора, медиа, created_at и отдельные метрики как необязательные и не пытайтесь определить, является ли запись оригинальным постом, ответом, цитатой или репостом: подтип не передается.

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

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

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

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

Threads User Posts API — FAQ

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

Отправьте URL с HTTP или HTTPS на threads.com, www.threads.com, threads.net или www.threads.net с путем вида /@username. Голые имена пользователей, URL постов и пути другого вида отклоняются.

Записи могут содержать ID поста, URL, текст, публичные данные об авторе, ссылки на медиа, видимое число лайков, комментариев, репостов и пересылок, created_at, collected_at и дополнительный контекст сбора или входных данных. Необязательные значения источника могут быть null или пустыми.

По умолчанию results_limit равен 100, допускаются целые числа от 1 до 2 000. Лимит применяется к каждому URL профиля, поэтому два URL с results_limit 50 запрашивают до 100 постов.

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

Каждая возвращенная запись поста стоит 0,5 кредита SocQ. Оценка рассчитывается как urls, умноженное на results_limit, а за пустой набор результатов плата не взимается.