Ко всем API
Публичные данные Threads

Threads Public Data API

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

Доступные API Threads

Используйте Profiles для данных аккаунта, Posts для одной известной публичной публикации или User Posts для ограниченной коллекции публикаций выбранных профилей.

Какие данные Threads можно получить?

SocQ возвращает нормализованные публичные записи аккаунтов и публикаций с идентификационными данными, контентом, медиа, видимой вовлеченностью, источником и временем сбора.

Публичные данные профиля

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

Контент известной публикации

Превращайте URL публичной публикации в ее идентификационные данные, текст, сведения об авторе, исходный URL и доступные медиа.

Видимая вовлеченность публикаций

Сохраняйте время публикации и время сбора вместе с доступным числом лайков, комментариев, репостов и пересылок.

Публикации выбранных профилей

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

SocQ vs Threads API

SocQ ориентирован на сбор поддерживаемых публичных данных Threads. Threads API от Meta предназначен для авторизованной публикации, ответов, статистики и поддерживаемых сценариев поиска.

ВозможностьSocQThreads API
Основное назначениеСбор публичных профилей, публикаций и недавних публикаций пользователяСоздание авторизованных интеграций для публикации, ответов, статистики и поиска
OAuth клиентаAPI-ключ SocQ; OAuth Threads от клиента не нуженПриложение Meta, авторизация пользователя Threads и токен доступа
Входные данныеURL публичного профиля или публикации ThreadsКонтекст авторизованного аккаунта, ID Threads и поддерживаемые параметры поиска
Публикация и управление ответамиНе поддерживаетсяПоддерживается при наличии нужных разрешений Threads
Формат ответаНормализованные записи SocQНативные объекты Threads Graph API

Как работает API Threads

Profiles, Posts и User Posts используют один и тот же процесс: асинхронная задача и результаты с пагинацией.

  1. 1. Отправьте публичные URL

    Отправьте URL профилей или публикаций в нужный API и сохраните возвращенный task_id.

  2. 2. Отслеживайте задачу

    Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится.

  3. 3. Получите результаты

    Читайте data.results.items и используйте next_cursor, пока has_more равно true.

Сбор публикаций профиля Threads

Пройдите аутентификацию с API-ключом SocQ и отправьте URL публичного профиля в User Posts. Profiles и Posts работают по той же схеме задач.

curl -X POST "https://api.socq.ai/v1/threads/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"urls":["https://www.threads.com/@example"],"results_limit":100}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is true

Типичные сценарии использования API Threads

Исследование авторов и профилей

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

Анализ известных публикаций

Превращайте выбранные URL публикаций в поля контента, автора, медиа, времени публикации, видимой вовлеченности и источника.

Мониторинг контента авторов

Собирайте ограниченный набор публикаций выбранных профилей и сравнивайте контент между повторными сборами.

Отчеты о вовлеченности

Используйте видимые счетчики и collected_at, чтобы сравнивать снимки публичных публикаций, не считая их метриками в реальном времени.

Ограничения и политика публичных данных

Результаты Threads — это публичные записи на момент сбора. Эти API не дают доступа к приватному контенту и не публикуют, не редактируют, не удаляют и не управляют аккаунтами и публикациями Threads.

  • Profiles принимает URL вида /@username на threads.com и threads.net. Просто имена пользователей и URL публикаций отклоняются.
  • Posts принимает URL вида /@username/post/{post_id}. Он не поддерживает results_limit и поиск публикаций профиля.
  • User Posts принимает URL профилей вида /@username. Значение results_limit по умолчанию равно 100, допускает от 1 до 2 000 и применяется к каждому профилю отдельно.
  • User Posts не указывает, является ли результат оригинальной публикацией, ответом, цитатой или репостом.
  • Публикация может содержать comments_count, но отдельные ответы и деревья ответов не возвращаются.
  • Необязательные поля идентификации, контента, медиа, временных меток и вовлеченности могут быть пустыми, если публичная запись их не показывает.

Частые вопросы об API Threads

Что такое API Threads?

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

Какой API Threads выбрать?

Используйте Profiles для записей аккаунтов по /@username, Posts для точных ссылок /@username/post/{post_id} и User Posts для ограниченной коллекции по каждому URL профиля /@username.

Как работает лимит результатов в User Posts?

Значение results_limit по умолчанию равно 100, принимает целые числа от 1 до 2 000 и применяется к каждому переданному URL профиля отдельно.

Указывают ли результаты User Posts, что это ответ или репост?

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

Полны ли публикации и метрики вовлеченности Threads и обновляются ли они в реальном времени?

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

Сколько стоит сбор данных Threads?

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

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

Bluesky API

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

Snapchat API

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

Twitch API

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

Rednote API

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

Kwai API

Получайте публичные профили Kwai, одну страницу публикаций аккаунта или одну известную публикацию с нормализованными данными об идентичности, контентом, медиа, метками времени и видимой вовлеченностью.

Truth Social API

Получайте публичные данные аккаунта, собирайте одну исходную страницу публикаций аккаунта или превращайте один известный URL публикации в нормализованные записи.