API de plataforma de EveryData
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.
- Endpoint
- POST /api/v1/social
- Funciones
- 5
- Por 1.000
- 1,389 US$
Funciones disponibles
Compara las acciones de Bluesky por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.
| 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 | 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 |
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é 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.
¿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 DIDAT 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 DIDAT 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 DIDAT 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 DIDAT 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 devuelto si la acción es 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 banner_url, follower_count, following_count y post_count. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan 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.