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