bluesky/
user-posts

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

Bluesky User Posts API

Хендл или DID на входе
Одна страница источника
Нормализованные записи публикаций
0,19 кредита за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Bluesky User Posts

Bluesky User Posts — это публичные публикации, собранные с одного аккаунта по его хендлу или децентрализованному идентификатору. Каждая нормализованная запись может содержать текст публикации, данные об авторе, время в источнике и время сбора, публичные медиафайлы, хештеги, упоминания и доступные счетчики вовлеченности.

Возможности Bluesky User Posts API

  • Два идентификатора аккаунтаПередайте ровно один идентификатор: хендл Bluesky, например jay.bsky.team, или DID в формате did:method:identifier.
  • Сбор одной страницы аккаунтаОдин запрос к поставщику для выбранного аккаунта собирает публичные публикации, доступные на этой странице источника, без курсора источника и лимита результатов со стороны вызывающего.
  • Стабильные результаты в формате публикацийЧитайте нормализованные идентификаторы публикаций, текст, автора, метки времени, метрики, медиафайлы, хештеги и упоминания, не завися от формата ответа поставщика.

Параметры Bluesky User Posts API

ПараметрыОбязательныйОписание
usernameОбязательный (хотя бы один)Публичный хендл Bluesky длиной от 1 до 253 символов из букв, цифр, точек или дефисов. Начальный @ не принимается; не передавайте это поле, если вместо него указан user_id.
user_idОбязательный (хотя бы один)Децентрализованный идентификатор Bluesky, который начинается с did:, за которым идут метод в нижнем регистре и непустой идентификатор из допустимых букв, цифр, точек, подчеркиваний, двоеточий, знаков процента или дефисов.

Как использовать Bluesky User Posts API

Отправьте хендл Bluesky или DID, отслеживайте асинхронную задачу и после завершения читайте сохраненные записи PostItem.

  1. Выберите публичный хендл Bluesky без начального @ или DID аккаунта.
  2. Отправьте выбранный идентификатор методом POST на /v1/bluesky/user-posts и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
  4. Читайте data.results.items; используйте next_cursor из ответа задачи, только если у сохраненного набора результатов есть еще одна страница.
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 the task succeeds

Сценарии использования Bluesky User Posts API

  • Снимки контента аккаунта: Фиксируйте страницу публичных публикаций известного хендла или DID на определенный момент, сохраняя ID публикаций, URL источника, время публикации и время сбора.
  • Исследование паттернов публикаций: Изучайте нормализованный текст, авторство, хештеги, упоминания и доступные медиафайлы, чтобы анализировать темы и форматы выбранного публичного аккаунта.
  • Сравнение видимой вовлеченности: Сравнивайте доступное число лайков, комментариев, репостов и просмотров у собранных публикаций, считая отсутствующие счетчики недоступными, а не нулевыми.

Практические советы по Bluesky User Posts API

  • Отправляйте хендлы без @ и перед созданием задачи проверяйте, что они состоят из букв, цифр, точек и дефисов.
  • Используйте полный DID, если идентификация аккаунта должна сохраняться при смене хендла; не отправляйте произвольный ID пользователя.
  • Не добавляйте results_limit или курсор источника в тело POST: поставщик собирает одну страницу, а такие поля отклоняются.
  • Считайте данные об авторе, медиафайлы, хештеги, упоминания и отдельные счетчики необязательными и удаляйте дубликаты повторных снимков по id публикации.

Помимо Bluesky User Posts API, используйте эти API, когда нужен другой тип публичных данных Bluesky.

  • Bluesky Profile API — Получайте один публичный профиль Bluesky по проверенному имени пользователя: нормализованные данные аккаунта, описание, изображения, сайт, поля статуса, видимые счетчики и контекст сбора.
  • Bluesky Post API — Преобразуйте один известный URL публичного поста bsky.app в нормализованные поля текста, автора, медиа, метки времени, тегов, упоминаний и видимой вовлеченности.

Другие платформы

Объединяйте данные Bluesky с публичными данными других поддерживаемых соцсетей.

Bluesky User Posts API — FAQ

Bluesky User Posts API — это интерфейс для получения одной страницы публичных публикаций аккаунта по хендлу Bluesky или DID, который возвращает нормализованный текст публикаций, автора, медиафайлы, метки времени и видимые данные о вовлеченности.

Отправляйте ровно одно поле. username — это публичный хендл без @, а user_id должен быть корректным DID. Если указать оба поля, вернется ошибка валидации.

Нет. Спецификация запроса принимает только username и user_id, а поставщик собирает одну страницу источника, не переходя по курсору поставщика.

Эндпоинт задачи разбивает на страницы записи, уже сохраненные SocQ, и принимает лимит чтения от 1 до 500. Этот курсор по сохраненным результатам не запрашивает новую страницу у поставщика Bluesky.

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

За успешную задачу списывается фиксированная плата 0,19 кредита SocQ. Сумма не зависит от числа публикаций, сохраненных со страницы источника.