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