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