bluesky/
profile

Получайте один публичный профиль Bluesky по проверенному имени пользователя: нормализованные данные об аккаунте, описание профиля, изображения профиля, сайт и видимые счетчики аккаунта в одной асинхронной задаче.

Bluesky Profile API

Проверенное имя пользователя
Данные и изображения профиля
Видимые счетчики аккаунта
0,19 кредита за запрос
Готово
Готово

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

README

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

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

Отправьте одно проверенное имя пользователя, отслеживайте асинхронную задачу и читайте нормализованный профиль из стандартного ответа с результатами.

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

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

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

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

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

Bluesky Profile API — FAQ

Bluesky Profile API — это программный интерфейс для получения одного публичного профиля Bluesky по проверенному имени пользователя. Он возвращает нормализованные данные об аккаунте, описание профиля, изображения профиля, сайт, необязательные поля статуса, видимые счетчики аккаунта и время сбора.

Отправьте от 1 до 253 букв, цифр, точек или дефисов без начального @. Подчеркивания, двоеточия, URL профилей, DID, пустые значения и дополнительные поля запроса отклоняются.

Стандартная запись аккаунта включает поля идентификации и источника, имя пользователя, отображаемое имя, описание профиля, аватар, обложку, сайт, признаки верификации и приватности, необязательное местоположение, число подписчиков, подписок и публикаций, а также время сбора. Необязательные поля остаются null, если данные недоступны.

Нет. Каждая задача принимает одно имя пользователя и обычно возвращает не более одного профиля, без results_limit и без курсора, задаваемого вызывающей стороной; результаты задачи при этом всё равно отдаются в стандартной обертке с next_cursor и has_more.

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