Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Bluesky Сведения

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

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

Bluesky Details получает публичный профиль одного аккаунта Bluesky по его полному хендлу и возвращает одну запись: user_id, хендл, отображаемое имя, описание, аватар и обложку, число подписчиков, подписок и постов, признак верификации и дату регистрации аккаунта. Журналисты, исследователи и комьюнити-менеджеры используют эту возможность, чтобы проверить, кто ведёт аккаунт и насколько велика его аудитория, прежде чем цитировать его материалы, подписываться на него или начинать сотрудничество, а также чтобы вести датированный журнал изменений размера аудитории отслеживаемых аккаунтов.

username должен содержать полный хендл, например alice.bsky.social, или собственный домен, который аккаунт использует как хендл. joined_at указывает дату регистрации аккаунта и помогает выявлять недавно созданные аккаунты. Если счётчик равен null, Bluesky не раскрыл его значение, поэтому записывайте его как отсутствующее, а не как ноль.

Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.

Промпт для ИИ

Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Bluesky Сведения (bluesky/profile).

Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: bluesky и action: profile, а параметры передайте в params.
- Обязательные параметры:
  - username: Задаёт полный хендл Bluesky, например alice.bsky.social или подключённый собственный домен. Не передавайте отображаемое имя или URL страницы bsky.app/profile/.
- Возвращает один объект. Основные поля: user_id, username, display_name, bio, url, avatar_url, is_verified, joined_at, source_username, banner_url, follower_count, following_count; всего полей: 13, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=bluesky.
- Пример тела запроса:
{
  "platform": "bluesky",
  "action": "profile",
  "params": {
    "username": "<HANDLE>.bsky.social"
  }
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.

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

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаblueskyИдентификатор платформы, фиксированное значение.
actionbodystringДаprofileИдентификатор возможности, фиксированное значение.
usernamebody.paramsstringДа-Задаёт полный хендл Bluesky, например alice.bsky.social или подключённый собственный домен. Не передавайте отображаемое имя или URL страницы bsky.app/profile/. Действия profile, user_posts, followers и following используют этот параметр, чтобы найти целевой аккаунт.

Примеры кода

bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "bluesky",
  "action": "profile",
  "params": {
    "username": "<HANDLE>.bsky.social"
  }
}'

Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.

Пример ответа

Предпросмотр полей

Для этих параметров пока нет примера ответа. Здесь показаны структура ответа и поля из описания API, а … служит заполнителем; это не результат реального вызова.

json
{
  "id": "req_…",
  "platform": "bluesky",
  "action": "profile",
  "results": {
    "user_id": …,
    "username": …,
    "display_name": …,
    "bio": …,
    "url": …,
    "avatar_url": …,
    "is_verified": …,
    "joined_at": …,
    "source_username": …,
    "platform": …,
    "banner_url": …,
    "follower_count": …,
    "following_count": …,
    "post_count": …
  },
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}

Поля ответа

Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.

ПолеЗначение
user_idУникальный ID пользователя на платформе.
usernameИмя пользователя (@handle).
display_nameОтображаемое имя; может отличаться от username.
bioОписание профиля, написанное владельцем аккаунта; может содержать переносы строк и эмодзи.
urlСсылка на запись на платформе.
avatar_urlСсылка на аватар. Некоторые платформы возвращают CDN-ссылки с заданным размером, срок действия которых может истечь.
is_verifiedПодтверждён ли аккаунт платформой. null означает, что это невозможно определить.
joined_atТрактуется так же, как на самой платформе
source_usernameТрактуется так же, как на самой платформе
platformИдентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok).
banner_urlТрактуется так же, как на самой платформе
follower_countПодписчики. null означает, что значение не раскрыто, а не 0.
following_countПодписки. null означает, что значение не раскрыто, а не 0.
post_countВсего публикаций. null означает, что значение не раскрыто, а не 0.

FAQ

Нужен ли API-ключ Bluesky или пароль приложения?

Нет. Вы вызываете возможность со своим API-ключом EveryInfra, а запрос содержит один параметр: username, полный хендл аккаунта. Поля для учётных данных Bluesky в нём нет, поэтому для чтения публичного профиля вам никогда не придётся передавать логин Bluesky или пароль приложения.

Где найти полный хендл?

В профиле он указан после @, а также является последней частью ссылки вида bsky.app/profile/<handle>. Скопируйте только хендл и не передавайте ссылку или отображаемое имя. У аккаунта, который использует собственный домен как хендл, нет суффикса .bsky.social, поэтому не добавляйте его.

Какие входные данные используют другие возможности Bluesky?

Тот же полный хендл. Bluesky Posts by user, Followers и Following находят аккаунт по username в том же формате, поэтому значение, которое вы передаёте здесь, можно без изменений использовать для получения постов аккаунта, списков его подписчиков и подписок.

Ошибки и оплата

401
Ключ отсутствует или недействителен.
402
Недостаточно средств на балансе. Сначала пополните баланс.
422
Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
429
Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
503
Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
200 (пусто)
Нет данных. Без списания.

Ошибки

Официальные источники

Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.

  • AT Protocol: псевдонимы и DID ↗

    В протоколе псевдоним — это идентификатор пользователя в формате доменного имени, которому соответствует постоянный DID; эти два идентификатора нельзя использовать как взаимозаменяемые входные данные.

    Проверено 2026-09-04