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

threads/posts
Публикации0,5 кредита за результат

threads/profiles
Профили0,6 кредита за результат

threads/user-posts
Публикации0,5 кредита за результат

threads/post-replies
Комментарии0,3 кредита за результат

threads/search
Поиск0,6 кредита за результат

threads/search-users
Поиск0,6 кредита за результат

threads/user-replies
Публикации0,5 кредита за результат

threads/user-reposts
Публикации0,5 кредита за результат
Какие данные Threads можно получить?
SocQ возвращает нормализованные публичные записи аккаунтов и публикаций с идентификационными данными, контентом, медиа, видимой вовлеченностью, источником и временем сбора.
Публичные данные профиля
Получайте ID профилей, URL, имена пользователей, отображаемые имена, описания профиля, изображения, привязанные сайты, видимые счетчики аккаунта и время сбора.
Контент известной публикации
Превращайте URL публичной публикации в ее идентификационные данные, текст, сведения об авторе, исходный URL и доступные медиа.
Видимая вовлеченность публикаций
Сохраняйте время публикации и время сбора вместе с доступным числом лайков, комментариев, репостов и пересылок.
Публикации выбранных профилей
Просматривайте ограниченный набор публичных публикаций по каждому URL профиля и сохраняйте связь результатов с переданным профилем.
SocQ vs Threads API
SocQ ориентирован на сбор поддерживаемых публичных данных Threads. Threads API от Meta предназначен для авторизованной публикации, ответов, статистики и поддерживаемых сценариев поиска.
| Возможность | SocQ | Threads API |
|---|---|---|
| Основное назначение | Сбор публичных профилей, публикаций и недавних публикаций пользователя | Создание авторизованных интеграций для публикации, ответов, статистики и поиска |
| OAuth клиента | API-ключ SocQ; OAuth Threads от клиента не нужен | Приложение Meta, авторизация пользователя Threads и токен доступа |
| Входные данные | URL публичного профиля или публикации Threads | Контекст авторизованного аккаунта, ID Threads и поддерживаемые параметры поиска |
| Публикация и управление ответами | Не поддерживается | Поддерживается при наличии нужных разрешений Threads |
| Формат ответа | Нормализованные записи SocQ | Нативные объекты Threads Graph API |
Как работает API Threads
Profiles, Posts и User Posts используют один и тот же процесс: асинхронная задача и результаты с пагинацией.
1. Отправьте публичные URL
Отправьте URL профилей или публикаций в нужный API и сохраните возвращенный task_id.
2. Отслеживайте задачу
Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится.
3. Получите результаты
Читайте data.results.items и используйте next_cursor, пока has_more равно true.
Пройдите аутентификацию с 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 публикации в нормализованные записи.