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.
- Выберите публичный хендл Bluesky без начального @ или DID аккаунта.
- Отправьте выбранный идентификатор методом POST на /v1/bluesky/user-posts и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не сообщит об ошибке.
- Читайте 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 публикации.
Связанные API
Помимо Bluesky User Posts API, используйте эти API, когда нужен другой тип публичных данных Bluesky.
- Bluesky Profile API — Получайте один публичный профиль Bluesky по проверенному имени пользователя: нормализованные данные аккаунта, описание, изображения, сайт, поля статуса, видимые счетчики и контекст сбора.
- Bluesky Post API — Преобразуйте один известный URL публичного поста bsky.app в нормализованные поля текста, автора, медиа, метки времени, тегов, упоминаний и видимой вовлеченности.