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

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. 1. Отправьте поддерживаемый идентификатор

    Передайте имя пользователя, URL публикации, handle или DID в соответствующий API и сохраните возвращенный task_id.

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

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

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

    Читайте data.results.items и используйте next_cursor, только пока остаются дополнительные сохраненные результаты.

Сбор публикаций по handle Bluesky

Пройдите аутентификацию с вашим 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 для исследований и проверки.