API Bluesky
Получайте данные об аккаунтах в социальных сетях, публикациях пользователей, числе подписчиков и списках связей, чтобы анализировать публичные обсуждения и структуру взаимодействий в сети.
Идентифицируйте пользователей по полному хендлу или собственному домену. Учтите, что возвращённые связи могут охватывать не весь социальный граф.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Bluesky: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Профилиprofile | Получите запись аккаунта Bluesky по хендлу: отображаемое имя, описание, аватар, баннер, дату регистрации, флаг верификации и число подписчиков, подписок и постов. | $1.39 за 1 000 запросов | Норма |
Посты пользователяuser_posts | Отслеживайте публикации аккаунта Bluesky. | $1.39 за 1 000 запросов | Норма |
Подписчикиfollowers | Получите список подписчиков пользователя Bluesky с DID, хендлом, отображаемым именем, описанием и датой регистрации каждого. | $1.39 за 1 000 запросов | Норма |
Подпискиfollowing | Узнайте, на какие аккаунты подписан пользователь Bluesky: ID, хендл, отображаемое имя, описание и флаг верификации каждого аккаунта. | $1.39 за 1 000 запросов | Норма |
Поиск людейsearch_people | Ищите аккаунты Bluesky по имени или слову: хендл, отображаемое имя, описание, аватар и флаг верификации. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Bluesky?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
profileПрофили Получите запись аккаунта Bluesky по хендлу: отображаемое имя, описание, аватар, баннер, дату регистрации, флаг верификации и число подписчиков, подписок и постов. Передайте полный хендл в | username | — | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform · banner_url · follower_count · following_count · post_count |
user_postsПосты пользователя Отслеживайте публикации аккаунта Bluesky. У каждого поста есть текст и URL, число лайков, репостов, цитирований, ответов и закладок, а также хештеги, упоминания и внешние ссылки. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · url · text · author_username · author_name · author_id · author_avatar_url · lang · like_count · repost_count · comment_count · quote_count · bookmark_count · is_reply · is_repost · posted_at · platform · media_urls · embed_url · embed_title · hashtags · mentions · links |
followersПодписчики Получите список подписчиков пользователя Bluesky с DID, хендлом, отображаемым именем, описанием и датой регистрации каждого. Возвращённая страница может включать не всех подписчиков, поэтому их число может отличаться от счётчика в профиле. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=30, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
followingПодписки Узнайте, на какие аккаунты подписан пользователь Bluesky: ID, хендл, отображаемое имя, описание и флаг верификации каждого аккаунта. Подписки со временем меняются и не означают симпатии, контакта или разрешения писать сообщения. | username | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=30, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
search_peopleПоиск людей Ищите аккаунты Bluesky по имени или слову: хендл, отображаемое имя, описание, аватар и флаг верификации. Поиск идёт по профилям, а не по тексту постов, и совпадение не подтверждает личность человека. | keyword | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=200. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
Что означают параметры действия profile в API Bluesky?
Получите запись аккаунта Bluesky по хендлу: отображаемое имя, описание, аватар, баннер, дату регистрации, флаг верификации и число подписчиков, подписок и постов. Передайте полный хендл в username (подойдёт и собственный домен), а не отображаемое имя или ссылку на профиль.
usernameОбязательный- Задаёт полный хендл Bluesky, например alice.bsky.social или подключённый собственный домен. Не передавайте отображаемое имя или URL страницы bsky.app/profile/. Действия profile, user_posts, followers и following используют этот параметр, чтобы найти целевой аккаунт.AT Protocol: псевдонимы и DID — В протоколе псевдоним — это идентификатор пользователя в формате доменного имени, которому соответствует постоянный DID; эти два идентификатора нельзя использовать как взаимозаменяемые входные данные. · Проверено
Что означают параметры действия user_posts в API Bluesky?
Отслеживайте публикации аккаунта Bluesky. У каждого поста есть текст и URL, число лайков, репостов, цитирований, ответов и закладок, а также хештеги, упоминания и внешние ссылки. quote_count считает репосты с комментарием отдельно от обычных репостов. Выборка не является полным архивом.
usernameОбязательный- Задаёт полный хендл Bluesky, например alice.bsky.social или подключённый собственный домен. Не передавайте отображаемое имя или URL страницы bsky.app/profile/. Действия profile, user_posts, followers и following используют этот параметр, чтобы найти целевой аккаунт.AT Protocol: псевдонимы и DID — В протоколе псевдоним — это идентификатор пользователя в формате доменного имени, которому соответствует постоянный DID; эти два идентификатора нельзя использовать как взаимозаменяемые входные данные. · Проверено
Что означают параметры действия followers в API Bluesky?
Получите список подписчиков пользователя Bluesky с DID, хендлом, отображаемым именем, описанием и датой регистрации каждого. Возвращённая страница может включать не всех подписчиков, поэтому их число может отличаться от счётчика в профиле.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Задаёт полный хендл Bluesky, например alice.bsky.social или подключённый собственный домен. Не передавайте отображаемое имя или URL страницы bsky.app/profile/. Действия profile, user_posts, followers и following используют этот параметр, чтобы найти целевой аккаунт.AT Protocol: псевдонимы и DID — В протоколе псевдоним — это идентификатор пользователя в формате доменного имени, которому соответствует постоянный DID; эти два идентификатора нельзя использовать как взаимозаменяемые входные данные. · Проверено
Что означают параметры действия following в API Bluesky?
Узнайте, на какие аккаунты подписан пользователь Bluesky: ID, хендл, отображаемое имя, описание и флаг верификации каждого аккаунта. Подписки со временем меняются и не означают симпатии, контакта или разрешения писать сообщения.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеusernameОбязательный- Задаёт полный хендл Bluesky, например alice.bsky.social или подключённый собственный домен. Не передавайте отображаемое имя или URL страницы bsky.app/profile/. Действия profile, user_posts, followers и following используют этот параметр, чтобы найти целевой аккаунт.AT Protocol: псевдонимы и DID — В протоколе псевдоним — это идентификатор пользователя в формате доменного имени, которому соответствует постоянный DID; эти два идентификатора нельзя использовать как взаимозаменяемые входные данные. · Проверено
Что означают параметры действия search_people в API Bluesky?
Ищите аккаунты Bluesky по имени или слову: хендл, отображаемое имя, описание, аватар и флаг верификации. Поиск идёт по профилям, а не по тексту постов, и совпадение не подтверждает личность человека.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеkeywordОбязательный- Задаёт поисковые слова для пользователей или аккаунтов в действии search_people. Эндпоинт возвращает подходящие профили пользователей и не ищет по тексту публикаций; чтобы получить публикации, используйте user_posts с полным хендлом.
Как использовать API Bluesky
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"bluesky","action":"profile","params":{"username":"<username>"}}'
Вопросы об API Bluesky
Какие данные можно получить через API Bluesky?
Укажите в platform значение bluesky. В текущем каталоге: профили, посты пользователя, подписчики, подписки и поиск людей. Эти названия действий соответствуют разным объектам или представлениям Bluesky; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса profile к платформе Bluesky?
Задаёт полный хендл Bluesky, например alice.bsky.social или подключённый собственный домен. Не передавайте отображаемое имя или URL страницы bsky.app/profile/. Действия profile, user_posts, followers и following используют этот параметр, чтобы найти целевой аккаунт. Передайте это значение в поле username объекта params.
Какие поля может вернуть profile на платформе Bluesky?
Объявленная схема включает user_id, username, display_name и bio. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Bluesky возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.