threads/
posts

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

Threads Posts API

URL поста на входе
Контекст автора
Снимок вовлеченности
0,5 кредита за результат
Готово
Готово

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

README

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

Threads Posts

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

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

  • Обработка прямых URL постовПреобразует публичные URL вида /@username/post/{post_id} на threads.com или threads.net в записи именно тех постов, которые были переданы, а не в ленту профиля.
  • Контент поста и указание автораВозвращает идентификаторы постов, URL источника, текст и доступные ID авторов, имена пользователей, отображаемые имена и URL профилей для отслеживаемых записей.
  • Снимок медиа и видимой вовлеченностиХранит нормализованные ссылки на медиа, время публикации и сбора и видимое число лайков, комментариев, репостов и пересылок вместе для каждого поста.

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

ПараметрыОбязательныйОписание
urlsОбязательныйОбязательный список URL публичных постов Threads на threads.com или threads.net с путем /@username/post/{post_id}.

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

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

  1. Подготовьте один или несколько URL публичных постов Threads с путем /@username/post/{post_id} на threads.com или threads.net.
  2. Отправьте ссылки в поле urls на /v1/threads/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/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example/post/POST_ID"]}'

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

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

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

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

  • Перед отправкой проверяйте каждый URL на соответствие пути /@username/post/{post_id}, чтобы страницы профилей и посторонние пути Threads не приводили к ошибке запроса.
  • Удаляйте дубли ссылок по пути поста перед пакетной отправкой, чтобы альтернативные поддерживаемые хосты не создавали повторную работу для одного и того же поста.
  • Используйте этот эндпоинт только для известных URL постов; не указывайте results_limit, потому что эндпоинт не находит ленту профиля и не раскрывает пост в ответы.
  • Обрабатывайте текст, поля автора, медиа, время публикации и отдельные метрики как необязательные, чтобы частично доступный публичный пост не нарушал обработку результатов.
  • Сохраняйте collected_at вместе с полями видимой вовлеченности, чтобы знать, когда был сделан каждый снимок.

Помимо Threads Posts API, используйте эти API, когда нужен другой тип публичных данных 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 User Reposts API — Собирайте недавние репосты аккаунта по URL профилей Threads — каждый как оригинальная публикация с автором, текстом, вовлеченностью и медиа.

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

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

Threads Posts API — FAQ

Threads Posts API преобразует поддерживаемые URL публичных постов Threads в нормализованные записи с текстом, данными об авторе, медиа, временем публикации и видимым числом лайков, комментариев, репостов и пересылок.

Отправьте URL с http или https на threads.com, www.threads.com, threads.net или www.threads.net с путем вида /@username/post/{post_id}. Страницы профилей и пути другого вида отклоняются.

Нет. Данные для выбора постов передаются в urls без results_limit, потому что каждое входное значение указывает на конкретный публичный пост, а не на ленту, которую нужно ограничить.

Нет. Запись поста может включать видимое значение comments_count, но не содержит текста ответов, их авторов или дерева ответов.

Текст, данные об авторе, медиа, время публикации и отдельные значения вовлеченности могут быть пустыми, если публичная запись источника не содержит пригодного значения.

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