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
Найдите имя и прочитайте предложенные аккаунты.
- Отправьте {"query": "shams"} методом POST на /v1/threads/search-users.
- Опрашивайте GET /v1/tasks/{task_id} с полученным task_id, пока status не станет succeeded.
- Читайте найденные аккаунты из 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 — все они принимают ссылки на профили в таком же виде.
Связанные 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: текст, вовлеченность, медиа и ссылки.