Bluesky Public Data API
Получайте публичные профили Bluesky, данные по известным URL публикаций или одну страницу публикаций аккаунта с нормализованными полями идентичности, контента, медиа, меток времени и видимой вовлеченности.
Доступные API Bluesky
Используйте Profiles для данных аккаунта, Posts — для одной известной публичной публикации, а User Posts — для одной страницы публикаций по handle или DID.
Какие данные Bluesky можно получить?
SocQ возвращает нормализованные записи публичных профилей и публикаций с контекстом источника и времени сбора.
Данные публичного профиля
Получайте доступные данные об идентичности аккаунта, описание профиля, изображения профиля, сайт, признаки аккаунта, видимые счетчики и время сбора.
Контент известной публикации
Преобразуйте публичный URL bsky.app в идентификаторы публикации, текст, данные автора, медиа, метки времени, хештеги и упоминания.
Публикации выбранных аккаунтов
Собирайте одну страницу публичных публикаций источника по handle без @ или по корректному DID Bluesky.
Видимая вовлеченность
Сохраняйте доступное число лайков, комментариев, репостов, пересылок и просмотров как наблюдения на определенный момент.
SocQ vs прямая интеграция с Bluesky
SocQ предоставляет асинхронный процесс сбора нормализованных данных; при прямой интеграции транспорт, исходные объекты, хранение и преобразование результатов ложатся на ваше приложение.
| Возможность | SocQ | Прямая интеграция |
|---|---|---|
| Основное назначение | Сбор публичных профилей, известных публикаций и одной страницы публикаций аккаунта | Создание собственных сценариев чтения или записи на стороне провайдера |
| Аутентификация | API-ключ SocQ | Учетные данные зависят от собственного метода и сервиса |
| Входные данные | Имя пользователя, публичный URL публикации, handle или DID в зависимости от эндпоинта | Собственные идентификаторы или параметры конкретного метода |
| Формат ответа | Нормализованные записи SocQ | Исходные объекты провайдера, которые приложение должно сопоставить само |
Как работает API Bluesky
Profiles, Posts и User Posts используют один и тот же процесс асинхронной задачи и постраничного получения сохраненных результатов.
1. Отправьте поддерживаемый идентификатор
Передайте имя пользователя, URL публикации, handle или DID в соответствующий API и сохраните возвращенный task_id.
2. Отслеживайте задачу
Опрашивайте /v1/tasks/{task_id}, пока обработка не завершится успешно или с ошибкой.
3. Получите результаты
Читайте data.results.items и используйте next_cursor, только пока остаются дополнительные сохраненные результаты.
Пройдите аутентификацию с вашим API-ключом SocQ и отправьте публичный handle в User Posts. Profiles и Posts используют тот же процесс задач.
curl -X POST "https://api.socq.ai/v1/bluesky/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"jay.bsky.team"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items after successТипичные сценарии использования API Bluesky
Исследование профилей
Обогащайте известные имена пользователей публичными данными об идентичности, описанием профиля, изображениями, сайтом, видимыми метриками и временем сбора.
Анализ известных публикаций
Преобразуйте выбранные URL публикаций в нормализованные поля контента, автора, медиа, меток времени, ссылок, вовлеченности и источника.
Снимки публичных аккаунтов
Фиксируйте одну страницу публикаций известного handle или DID и сохраняйте метки времени источника и сбора.
Сравнение вовлеченности
Сравнивайте видимые счетчики между повторными сборами, рассматривая их как снимки на определенный момент.
Ограничения и политика публичных данных
Результаты Bluesky отражают публичные поля, доступные во время сбора. Эти API не получают доступ к приватному контенту и не публикуют, не редактируют, не удаляют аккаунты и публикации и не управляют ими.
- Profiles требует одно проверенное имя пользователя и не принимает URL профилей.
- Posts принимает одну непустую ссылку, разобранное имя хоста которой — bsky.app или поддомен bsky.app, включая абсолютные ссылки с любой схемой и ссылки без протокола; он не собирает ленту аккаунта или дерево ответов.
- User Posts требует username или user_id; handle не должен содержать @, а user_id должен быть DID.
- User Posts не принимает results_limit или курсор источника и собирает только одну страницу провайдера.
- Курсор и лимит результатов задачи листают записи, уже сохраненные SocQ; они не собирают другую страницу источника.
- Необязательные поля идентичности, контента, медиа, меток времени, ссылок и вовлеченности могут быть пустыми, если данные недоступны.
Частые вопросы об API Bluesky
Что такое API Bluesky?
API Bluesky получают публичные профили, данные известных публикаций и одну страницу публичных публикаций аккаунта по handle или DID.
Какой API Bluesky выбрать?
Используйте Profiles для записи аккаунта по имени пользователя, Posts — для одного известного URL публикации bsky.app, а User Posts — для одной страницы публикаций по handle или DID.
Переходит ли User Posts по курсору источника?
Нет. Он отправляет один запрос провайдеру и собирает одну страницу источника; next_cursor листает только записи результатов, уже сохраненные SocQ.
Всегда ли присутствуют все поля и метрики?
Нет. Нормализованная структура стабильна, но зависящие от источника значения идентичности, контента, медиа, меток времени, ссылок и метрик могут быть null.
Сколько стоит сбор данных Bluesky?
Каждая успешная задача Profiles, Posts или User Posts стоит фиксированные 0,19 кредита SocQ.
Объединяйте данные разных платформ для более полной бизнес-аналитики
Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.
Snapchat API
Получайте известный публичный ролик Snapchat Spotlight в виде нормализованной записи с доступными полями автора, подписи, медиа, аудио, временных меток, длительности и вовлеченности.
Twitch API
Превращайте известное публичное имя пользователя Twitch в нормализованный профиль, собирайте его публичные видео или получайте отдельный клип вместе со скачиваемым видео для исследования авторов, обогащения каталогов, сравнения и мониторинга снимков.
Rednote API
Получайте публичные профили и заметки, ищите заметки или пользователей, собирайте комментарии и вложенные ответы и сохраняйте одну страницу рекомендаций главной ленты.
Kwai API
Получайте публичные профили Kwai, одну страницу публикаций аккаунта или одну известную публикацию с нормализованными данными об идентичности, контентом, медиа, метками времени и видимой вовлеченностью.
Truth Social API
Получайте публичные данные аккаунта, собирайте одну исходную страницу публикаций аккаунта или превращайте один известный URL публикации в нормализованные записи.
Google Ad Library API
Находите публичных рекламодателей, собирайте креативы компании или получайте один известный креатив из Transparency Center по URL для исследований и проверки.


