threads/
search-users

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

Threads User Search API

Запрос по имени или нику
Обычно до 10 совпадений
Статус верификации
0,6 кредита за результат
Готово
Готово

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

README

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

Threads User Search

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

Возможности Threads User Search API

  • Совпадения по именам и никамquery принимает отображаемое имя или имя пользователя, а ответ содержит аккаунты, которые Threads предлагает по нему, обычно до 10.
  • Готовые идентификаторыКаждое совпадение возвращает username, name и url — ссылку на профиль вида /@username, которую другие эндпоинты Threads принимают на вход.
  • Значок и аватар для различенияis_verified и avatar_url помогают выбрать настоящий аккаунт, когда у нескольких совпадений одинаковое имя.

Параметры Threads User Search API

ПараметрыОбязательныйОписание
queryОбязательныйИмя человека или бренда либо имя пользователя Threads, например shams.

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

Найдите имя и прочитайте предложенные аккаунты.

  1. Отправьте {"query": "shams"} методом POST на /v1/threads/search-users.
  2. Опрашивайте GET /v1/tasks/{task_id} с полученным task_id, пока status не станет succeeded.
  3. Читайте найденные аккаунты из results.items и переходите по results.next_cursor, когда has_more равно true.
curl -X POST "https://api.socq.ai/v1/threads/search-users" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"shams"}'

# 0.6 credits for each account returned.

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

  • Проверка ника перед сбором контента: Сверьте username, отображаемое имя и is_verified, чтобы найти нужное совпадение, а затем по его url получите публикации, ответы или репосты аккаунта.
  • Превращение списка имен в профили Threads: Ищите каждое имя из списка инфлюенсеров или прессы и сохраняйте url верифицированного совпадения, чтобы получить столбец ссылок на профили Threads.
  • Выявление похожих аккаунтов: Найдите бренд или публичную персону и просмотрите неверифицированные совпадения с почти одинаковыми именами и аватарами — это могут быть самозванцы или фан-страницы.

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

  • Пробуйте и полное имя, и вероятный ник, если нужного аккаунта нет среди первых совпадений: query ищет по обоим.
  • Выбирайте совпадение по username вместе с is_verified, а не берите первую строку: по распространенным именам возвращается несколько похожих аккаунтов.
  • Передавайте выбранный url прямо в Threads User Posts, User Replies или User Reposts API — все они принимают ссылки на профили в таком же виде.

Помимо Threads User Search API, используйте эти API, когда нужен другой тип публичных данных Threads.

  • Threads Posts API — Собирайте по поддерживаемым URL публикаций 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 с публичными данными других поддерживаемых соцсетей.

Threads User Search API — FAQ

Threads User Search API — это программный интерфейс для поиска аккаунтов Threads по имени или нику. Он возвращает аккаунты, которые предлагает Threads, с именем пользователя, отображаемым именем, ссылкой на профиль, аватаром и статусом верификации.

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

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

Каждый возвращенный аккаунт стоит 0,6 кредита, так что поиск с 10 совпадениями стоит 6 кредитов.