API de Bluesky
Consulta perfiles y publicaciones públicas de Bluesky, descubre personas y revisa relaciones visibles de seguidores o seguidos. Los handles federados y los identificadores de cuenta deben mantenerse sin mezclarse.
Una lista devuelta puede ser parcial y los contadores pueden cambiar. La coincidencia por nombre o handle no acredita identidad, y ninguna acción amplía la visibilidad de una cuenta.
Disponibilidad de la plataforma
- Salud 24 h
- Normal
Últimos 30 días
Funciones disponibles
Cada acción de Bluesky, qué hace, su precio y su salud en las últimas 24 horas. Abre una acción para ver sus parámetros, campos de respuesta y ejemplos de código.
| Capacidad | Qué hace | Por 1.000 | Salud en 24 horas |
|---|---|---|---|
Consultar un perfil federado de Blueskyprofile | Resuelve un handle de Bluesky mediante username y devuelve cabecera y contadores de seguidores, seguidos y publicaciones. | $1.39 por 1.000 solicitudes | Normal |
Leer publicaciones de una cuentauser_posts | Consulta el feed público del username, distinguiendo autor, idioma, likes, reposts y respuestas por publicación. | $1.39 por 1.000 solicitudes | Normal |
Listar seguidores visiblesfollowers | Enumera cuentas seguidoras del username con DID, handle y perfil visible cuando están disponibles. | $1.39 por 1.000 solicitudes | Normal |
Listar cuentas seguidasfollowing | Devuelve cuentas que el username sigue, con identificadores y biografía públicos. | $1.39 por 1.000 solicitudes | Normal |
Buscar perfiles en Blueskysearch_people | Busca perfiles de Bluesky por keyword y devuelve handle, nombre, biografía y señales públicas de cuenta. | $1.39 por 1.000 solicitudes | Normal |
Abre una capacidad para ver sus parámetros, campos de respuesta, ejemplos de código y prueba.
¿Qué acepta cada acción de Bluesky?
Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.
Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.
| Acción | Obligatorios | Opcionales | Entrega | Límite | Por 1.000 | Campos de respuesta |
|---|---|---|---|---|---|---|
profileConsultar un perfil federado de Bluesky Resuelve un handle de Bluesky mediante | username | — | Entrega síncrona | — | $1.39 por 1.000 solicitudes | 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_postsLeer publicaciones de una cuenta Consulta el feed público del | username | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | 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 |
followersListar seguidores visibles Enumera cuentas seguidoras del | username | — | Entrega síncrona | El catálogo declara defaultLimit = 30 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
followingListar cuentas seguidas Devuelve cuentas que el | username | — | Entrega síncrona | El catálogo declara defaultLimit = 30 y maxLimit = 100 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
search_peopleBuscar perfiles en Bluesky Busca perfiles de Bluesky por | keyword | — | Entrega síncrona | El catálogo declara defaultLimit = 20 y maxLimit = 200 para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud. | $1.39 por 1.000 solicitudes | user_id · username · display_name · bio · url · avatar_url · is_verified · joined_at · source_username · platform |
¿Qué significan los parámetros de Bluesky profile?
Resuelve un handle de Bluesky mediante username y devuelve cabecera y contadores de seguidores, seguidos y publicaciones. No valida la identidad real de la persona ni accede a contenido que no sea público.
usernameObligatorio- Handle completo de Bluesky, como
alice.bsky.socialo un dominio personalizado vinculado a la cuenta. No es el nombre de usuario visible ni la URL de una páginabsky.app/profile/. Las accionesprofile,user_posts,followersyfollowingusan el mismohandlede cuenta para localizar al usuario.AT Protocol: handle y DID — AT Protocol define el handle como un nombre con forma de dominio que puede resolverse a un DID estable. Son identificadores distintos; esta referencia no convierte el DID en un parámetro aceptado por acciones que solo declaran `username`. · Consultada
¿Qué significan los parámetros de Bluesky user_posts?
Consulta el feed público del username, distinguiendo autor, idioma, likes, reposts y respuestas por publicación. No debe tratarse el orden devuelto como archivo histórico completo ni como alcance de la cuenta.
usernameObligatorio- Handle completo de Bluesky, como
alice.bsky.socialo un dominio personalizado vinculado a la cuenta. No es el nombre de usuario visible ni la URL de una páginabsky.app/profile/. Las accionesprofile,user_posts,followersyfollowingusan el mismohandlede cuenta para localizar al usuario.AT Protocol: handle y DID — AT Protocol define el handle como un nombre con forma de dominio que puede resolverse a un DID estable. Son identificadores distintos; esta referencia no convierte el DID en un parámetro aceptado por acciones que solo declaran `username`. · Consultada
¿Qué significan los parámetros de Bluesky followers?
Enumera cuentas seguidoras del username con DID, handle y perfil visible cuando están disponibles. Un contador y una lista devuelta son objetos distintos; no se promete que la página cubra todos los seguidores.
usernameObligatorio- Handle completo de Bluesky, como
alice.bsky.socialo un dominio personalizado vinculado a la cuenta. No es el nombre de usuario visible ni la URL de una páginabsky.app/profile/. Las accionesprofile,user_posts,followersyfollowingusan el mismohandlede cuenta para localizar al usuario.AT Protocol: handle y DID — AT Protocol define el handle como un nombre con forma de dominio que puede resolverse a un DID estable. Son identificadores distintos; esta referencia no convierte el DID en un parámetro aceptado por acciones que solo declaran `username`. · Consultada
¿Qué significan los parámetros de Bluesky following?
Devuelve cuentas que el username sigue, con identificadores y biografía públicos. La relación observada puede cambiar y no implica afinidad, contacto ni autorización para mensajería.
usernameObligatorio- Handle completo de Bluesky, como
alice.bsky.socialo un dominio personalizado vinculado a la cuenta. No es el nombre de usuario visible ni la URL de una páginabsky.app/profile/. Las accionesprofile,user_posts,followersyfollowingusan el mismohandlede cuenta para localizar al usuario.AT Protocol: handle y DID — AT Protocol define el handle como un nombre con forma de dominio que puede resolverse a un DID estable. Son identificadores distintos; esta referencia no convierte el DID en un parámetro aceptado por acciones que solo declaran `username`. · Consultada
¿Qué significan los parámetros de Bluesky search_people?
Busca perfiles de Bluesky por keyword y devuelve handle, nombre, biografía y señales públicas de cuenta. Es descubrimiento por texto, no resolución inequívoca de una persona ni verificación de identidad.
keywordObligatorio- Término de búsqueda de personas o cuentas para
search_people. Esta acción devuelve los perfiles de las personas que coinciden, no busca publicaciones que contengan el término. Para obtener las publicaciones de una cuenta, debes usar la acciónuser_postsy proporcionar elusernamecompleto.
Cómo usar la API de Bluesky
- 01Consulta el catálogo público y elige una acción de la plataforma.
- 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
- 03Procesa el resultado síncrono o consulta el identificador de trabajo cuando la acción se ejecute de forma asíncrona.
- 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
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>"}}'
Preguntas sobre la API de Bluesky
¿Cómo llamo a la API de Bluesky?
Envía POST /api/v1/social con platform igual a bluesky, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.
¿Qué devuelve la API de Bluesky?
Devuelve JSON estructurado. Por ejemplo, el esquema de profile incluye user_id, username, display_name y bio. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros tengan un valor.
¿Qué matiz de la documentación oficial conviene conservar al usar datos de Bluesky?
AT Protocol define el handle como un nombre con forma de dominio que puede resolverse a un DID estable. Son identificadores distintos; esta referencia no convierte el DID en un parámetro aceptado por acciones que solo declaran username.
¿Qué parámetros son obligatorios?
Depende de la acción. profile requiere username; user_posts requiere username; followers requiere username; consulta las demás acciones en la lista de funciones.
¿Las acciones de Bluesky responden de inmediato?
Las acciones marcadas como asíncronas devuelven un identificador de trabajo que se consulta por sondeo. Cualquier otra acción también puede ejecutarse de forma asíncrona: añade "mode": "async" al cuerpo de la solicitud para recibir el identificador de inmediato, útil para tareas lentas o límites altos.