threads/
profiles

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

Threads Profiles API

URL профиля на входе
Данные аккаунта и сайт
Видимые метрики аккаунта
0,6 кредита за результат
Готово
Готово

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

README

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

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 публичных профилей, отслеживайте асинхронную задачу и читайте нормализованные записи профилей с курсорной пагинацией.

  1. Подготовьте один или несколько URL публичных профилей Threads с путем /@username на threads.com или threads.net.
  2. Отправьте ссылки в поле urls на /v1/threads/profiles и сохраните возвращенный 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/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 рядом с числом подписчиков, подписок и постов, чтобы последующие запуски оставались различимыми как отдельные публичные снимки.

Помимо 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 — каждый как оригинальная публикация с автором, текстом, вовлеченностью и медиа.

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

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

Threads Profiles API — FAQ

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

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

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

Публичная запись профиля может не содержать описания, изображения профиля, сайта или всех видимых счетчиков. Клиентам следует допускать null или пустые значения необязательных полей.

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