bluesky/
post

Получайте одну публичную публикацию Bluesky по известному URL bsky.app: текст, данные об авторе, медиафайлы, метки времени, хештеги, упоминания и видимые показатели вовлеченности.

Bluesky Post API

URL одной публикации
Данные об авторе
Снимок вовлеченности
0,19 кредита за запрос
Готово
Готово

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

README

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

Bluesky Post

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

Возможности Bluesky Post API

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

Параметры Bluesky Post API

ПараметрыОбязательныйОписание
urlОбязательныйОбязательная непустая ссылка на публикацию с распознанным именем хоста bsky.app или поддоменом bsky.app. Валидатор принимает абсолютные ссылки с любой схемой и ссылки относительно протокола.

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

Отправьте известный URL публичной публикации Bluesky, отслеживайте асинхронную задачу и читайте нормализованный результат в стандартной обертке результатов.

  1. Подготовьте один публичный URL bsky.app, который ведет на нужную публикацию Bluesky.
  2. Отправьте URL в поле url на /v1/bluesky/post и сохраните возвращенный task_id.
  3. Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или не вернет ошибку.
  4. Читайте 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 вместе с видимыми счетчиками вовлеченности, чтобы при последующих сравнениях было известно, когда сделано каждое наблюдение.

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

  • Bluesky Profile API — Получайте один публичный профиль Bluesky по проверенному имени пользователя: нормализованные данные аккаунта, описание, изображения, сайт, поля статуса, видимые счетчики и контекст сбора.
  • Bluesky User Posts API — Собирайте одну страницу публичных постов Bluesky по handle или DID: нормализованный контент, автор, медиа, метки времени и видимая вовлеченность.

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

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

Bluesky Post API — FAQ

Bluesky Post API — это программный интерфейс для получения одной публичной публикации Bluesky по известному URL. Он возвращает нормализованный текст, данные об авторе, медиафайлы, метки времени, хештеги, упоминания и видимые счетчики вовлеченности.

Отправьте одну непустую ссылку с распознанным именем хоста bsky.app или поддоменом bsky.app. Бэкенд принимает абсолютные ссылки с любой схемой и ссылки относительно протокола; запрос принимает только поле url.

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

Нет. Результат описывает выбранную публикацию и может содержать видимый comments_count, но схема публикации не возвращает отдельные записи ответов или дерево ответов.

Нет. Запрос обрабатывает один url и не принимает results_limit; читайте возвращенный элемент через стандартную обертку результатов задачи.

Каждая успешная задача Bluesky Post стоит фиксированные 0,19 кредита SocQ. Сумма не зависит от запрошенного или возвращенного числа результатов.