Threads Profiles
Профили Threads — это публичные страницы аккаунтов с именами пользователей, отображаемыми именами, описаниями профиля, изображениями профиля, сайтами и видимым числом подписчиков, подписок и постов. Эти данные об аккаунте и его показатели помогают обогащать профили, сравнивать публичные аккаунты и отслеживать изменения во времени.
Возможности Threads Profiles API
- Пакеты поддерживаемых URL профилейОбрабатывает один или несколько URL профилей на threads.com или threads.net с путем /@username и отклоняет ссылки на посты и посторонние пути.
- Нормализованные данные профиляВозвращает ID профиля, URL, имя пользователя, отображаемое имя, описание профиля, изображение профиля и указанный сайт в единой записи профиля.
- Снимки видимых данных аккаунтаХранит доступное число подписчиков, подписок и постов вместе с collected_at, чтобы у каждого набора публичных метрик было время наблюдения.
Параметры Threads Profiles API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный список URL публичных профилей Threads на threads.com или threads.net. Путь каждого URL должен иметь формат /@username; голые имена пользователей, URL постов и посторонние пути отклоняются. |
Как использовать Threads Profiles API
Отправьте известные URL публичных профилей, отслеживайте асинхронную задачу и читайте нормализованные записи профилей с курсорной пагинацией.
- Подготовьте один или несколько URL публичных профилей Threads с путем /@username на threads.com или threads.net.
- Отправьте ссылки в поле urls на /v1/threads/profiles и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой.
- Читайте data.results.items, а затем запрашивайте возвращенный next_cursor, пока has_more равно true.
curl -X POST "https://api.socq.ai/v1/threads/profiles" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.threads.com/@example"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueСценарии использования Threads Profiles API
- Обогащение публичных профилей: Добавляйте имя пользователя, отображаемое имя, описание профиля, изображение профиля, сайт и URL источника к записям, связанным с известными профилями Threads.
- Сравнение охвата аккаунтов: Сравнивайте видимое число подписчиков, подписок и постов в выбранном наборе публичных профилей.
- Мониторинг публичных профилей: Сохраняйте данные об аккаунте и видимые метрики вместе с collected_at, чтобы сравнивать оформление профиля и показатели аккаунта в разные моменты сбора.
Практические советы по Threads Profiles API
- Перед отправкой проверяйте каждый URL на соответствие пути /@username на threads.com или threads.net, чтобы ссылки на посты и посторонние пути не приводили к ошибке запроса.
- Нормализуйте отправляемые URL и удаляйте дубли возвращенных профилей по id, если он доступен, а в качестве резервного стабильного ключа используйте url.
- Считайте описание профиля, изображение профиля, сайт и отдельные метрики аккаунта необязательными полями, чтобы частичные публичные записи оставались пригодными.
- Храните collected_at рядом с числом подписчиков, подписок и постов, чтобы последующие запуски оставались различимыми как отдельные публичные снимки.
Связанные API
Помимо Threads Profiles API, используйте эти API, когда нужен другой тип публичных данных Threads.
- Threads Posts 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 — каждый как оригинальная публикация с автором, текстом, вовлеченностью и медиа.