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, отслеживайте асинхронную задачу и читайте нормализованные результаты с курсорной пагинацией.
- Подготовьте один или несколько URL публичных постов Threads с путем /@username/post/{post_id} на threads.com или threads.net.
- Отправьте ссылки в поле urls на /v1/threads/posts и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте 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 вместе с полями видимой вовлеченности, чтобы знать, когда был сделан каждый снимок.
Связанные API
Помимо 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 — каждый как оригинальная публикация с автором, текстом, вовлеченностью и медиа.