threads/
search

Ищите в Threads по ключевому слову или хештегу топовые публикации, которые показывает приложение, около 20 за поиск, с текстом, автором, лайками, ответами, репостами, медиа и временем.

Threads Search API

Запрос по слову или хештегу
Топовые публикации в ранжировании Threads
Лайки, ответы и репосты
0,6 кредита за результат
Готово
Готово

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

README

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

Threads Search

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

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

  • Один запрос — топовые публикацииУкажите ключевое слово или хештег в query и получите топовые публикации, которые Threads показывает по нему, около 20, в ранжировании приложения.
  • Лайки, ответы и репосты у каждого результатаmetrics.likes_count, metrics.comments_count для ответов и metrics.shares_count для репостов показывают, какие результаты привлекают больше всего внимания.
  • Аккаунты за каждой публикациейauthor возвращает имя пользователя, отображаемое имя, url профиля, аватар и is_verified, так что лидеры темы видны вместе с тем, что они сказали.
  • Медиа и времяmedia перечисляет прикрепленные изображения или видео с размерами, а published_at датирует каждую публикацию для проверки свежести.

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

ПараметрыОбязательныйОписание
queryОбязательныйКлючевое слово или хештег для поиска, например basketball или хештег кампании. Один запрос на вызов.

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

Отправьте запрос и прочитайте топовые публикации после завершения задачи.

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

# 0.6 credits per post returned; a search with no matches is free.

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

  • Пульс темы: Ищите продукт, событие или проблему и читайте text топовых публикаций, чтобы увидеть, какие подходы и мнения ведут обсуждение.
  • Определение голосов, которые ведут разговор: Ранжируйте авторов результатов по лайкам и репостам их публикаций и отмечайте верифицированных, чтобы составить список для работы или наблюдения.
  • Мониторинг названия бренда или хештега: Регулярно запускайте один и тот же query, сохраняйте id новых публикаций с их published_at — и у вас будет постоянный журнал свежих упоминаний.

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

  • Разбивайте широкую тему на несколько более узких запросов — названия продуктов, варианты написания и связанные хештеги: каждый поиск возвращает около 20 топовых публикаций.
  • Объединяйте результаты пересекающихся запросов по id, чтобы публикация, ранжирующаяся в двух поисках, учитывалась один раз.
  • Подписывая столбцы в отчетах, читайте metrics.comments_count как число ответов, а metrics.shares_count как число репостов.
  • Передавайте url любого результата в Threads Post Replies API, если нужно обсуждение под ним.

Помимо Threads 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 User Search API — Находите аккаунты Threads по имени или нику: имена пользователей, отображаемые имена, URL профилей, аватары и статус верификации.
  • Threads User Replies API — Собирайте последние публичные ответы аккаунта по URL профилей Threads: текст, вовлеченность, медиа и ссылки.

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

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

Threads Search API — FAQ

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

Укажите хештег в query так же, как ключевое слово, и вернутся публикации, которые Threads ранжирует по этому тегу.

Около 20, в том порядке, в каком Threads ранжирует топовые результаты по запросу. Если нужны сначала новые, отсортируйте их по published_at самостоятельно.

Каждая возвращенная публикация стоит 0,6 кредита, так что полный поиск, около 20 публикаций, обходится примерно в 12 кредитов.