Bluesky Post
Публикации Bluesky — это публичные записи с текстом, данными об авторе, медиафайлами, метками времени, хештегами, упоминаниями и видимыми счетчиками вовлеченности. Такие записи помогают обогащать данные по URL, проверять источники, исследовать контент и сравнивать вовлеченность с привязкой ко времени.
Возможности Bluesky Post API
- Поиск известной публикацииПревращает один публичный URL bsky.app в нормализованную запись выбранной публикации, не разворачивая ленту аккаунта.
- Контент и данные об автореВозвращает доступный текст публикации, URL источника, данные об авторе, прикрепленные медиафайлы, хештеги, упоминания и время публикации.
- Снимок видимой вовлеченностиСохраняет доступное число лайков, комментариев, репостов и просмотров вместе со временем сбора как наблюдение на определенный момент.
Параметры Bluesky Post API
| Параметры | Обязательный | Описание |
|---|---|---|
url | Обязательный | Обязательная непустая ссылка на публикацию с распознанным именем хоста bsky.app или поддоменом bsky.app. Валидатор принимает абсолютные ссылки с любой схемой и ссылки относительно протокола. |
Как использовать Bluesky Post API
Отправьте известный URL публичной публикации Bluesky, отслеживайте асинхронную задачу и читайте нормализованный результат в стандартной обертке результатов.
- Подготовьте один публичный URL bsky.app, который ведет на нужную публикацию Bluesky.
- Отправьте URL в поле url на /v1/bluesky/post и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
- Читайте data.results.items; следуйте next_cursor, только если обертка результатов сообщает has_more со значением true.
curl -X POST "https://api.socq.ai/v1/bluesky/post" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://bsky.app/profile/jay.bsky.team/post/3micofpyeys2g"}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is trueСценарии использования Bluesky Post API
- Обогащение известного URL публикации: Превращайте выбранную ссылку bsky.app в структурированные поля текста, автора, медиафайлов, времени, хештегов, упоминаний, метрик и источника.
- Проверка контента и авторства: Используйте текст публикации, данные об авторе, медиафайлы и публичный URL источника, чтобы изучать выбранную публикацию с прослеживаемым авторством.
- Сравнение наблюдений за вовлеченностью: Сопоставляйте видимые счетчики вовлеченности с collected_at, чтобы сравнивать отдельно собранные снимки, не считая их потоком в реальном времени.
Практические советы по Bluesky Post API
- Убедитесь, что распознанное имя хоста — bsky.app или поддомен bsky.app. Валидатор не ограничивает схему URL и также принимает ссылки относительно протокола.
- Используйте один URL публикации на задачу и не передавайте results_limit: вход указывает на одну выбранную публикацию, а не на страницу ленты.
- Считайте текст публикации, данные об авторе, медиафайлы, хештеги, упоминания, время публикации и отдельные метрики полями, допускающими null.
- Сохраняйте collected_at вместе с видимыми счетчиками вовлеченности, чтобы при последующих сравнениях было известно, когда сделано каждое наблюдение.
Связанные API
Помимо Bluesky Post API, используйте эти API, когда нужен другой тип публичных данных Bluesky.
- Bluesky Profile API — Получайте один публичный профиль Bluesky по проверенному имени пользователя: нормализованные данные аккаунта, описание, изображения, сайт, поля статуса, видимые счетчики и контекст сбора.
- Bluesky User Posts API — Собирайте одну страницу публичных постов Bluesky по handle или DID: нормализованный контент, автор, медиа, метки времени и видимая вовлеченность.