Bluesky Profile
Los perfiles de Bluesky son registros públicos de cuentas con un identificador duradero, un identificador de usuario, un nombre visible, una biografía, imágenes de perfil, un sitio web y los conteos visibles de seguidores, seguidos y posts. Estos campos de identidad y señales de la cuenta sirven para enriquecer perfiles, comparar cuentas públicas y observar su evolución en el tiempo.
Funcionalidades de la Bluesky Profile API
- Consulta directa por nombre de usuarioResuelve un nombre de usuario de 1 a 253 letras, dígitos, puntos o guiones en un registro de perfil público.
- Identidad de perfil normalizadaDevuelve el ID del perfil, la URL de origen, el nombre de usuario, el nombre visible, la biografía y el sitio web vinculado que estén disponibles, con una estructura de cuenta coherente.
- Imágenes y campos de estado del perfilConserva como campos que pueden ser nulos los valores disponibles de avatar, portada, verificación y privacidad, sin inventar valores cuando la fuente los omite.
- Instantánea de los conteos visibles de la cuentaAgrupa los conteos disponibles de seguidores, seguidos y posts con collected_at para que cada instantánea de una cuenta pública tenga su hora de observación.
Parámetros de la Bluesky Profile API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio | Nombre de usuario público de Bluesky obligatorio, de 1 a 253 letras, dígitos, puntos o guiones. No incluya una @ inicial, guiones bajos, un DID, la URL de un perfil ni un segundo nombre de usuario. |
Cómo usar la Bluesky Profile API
Envíe un nombre de usuario validado, siga la tarea asíncrona y lea el perfil normalizado de la respuesta de resultados estándar.
- Prepare un nombre de usuario de Bluesky con letras, dígitos, puntos o guiones, como jay.bsky.team, y omita la @ inicial.
- Envíe username a /v1/bluesky/profile y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un fallo.
- Lea data.results.items. Esta consulta normalmente almacena un solo perfil, por lo que has_more es false; si la respuesta de resultados genérica indica que hay más datos, continúe con 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.itemsCasos de uso de la Bluesky Profile API
- Enriquecimiento de perfiles conocidos: Agregue un identificador público, un nombre visible, una biografía, imágenes de perfil, un sitio web y la URL de origen a un registro que ya contiene un nombre de usuario de Bluesky.
- Comparación de la huella de las cuentas: Compare los conteos disponibles de seguidores, seguidos y posts entre nombres de usuario enviados por separado, con las mismas claves de métricas normalizadas.
- Monitoreo de la presentación del perfil: Almacene la identidad, la biografía, las imágenes, el sitio web y collected_at a lo largo de tareas repetidas para identificar cambios entre instantáneas públicas.
Consejos de expertos para la Bluesky Profile API
- Elimine la @ inicial y valide el nombre de usuario restante con letras, dígitos, puntos y guiones antes del envío; rechace los valores DID, porque este endpoint no acepta user_id.
- Use el id devuelto como clave preferida de deduplicación y recurra a url o username cuando id esté vacío.
- Permita que la biografía, el avatar, la portada, el sitio web, los indicadores de estado, la ubicación y las métricas individuales sean nulos, para que los registros públicos parciales sigan siendo utilizables.
- No agregue results_limit ni una lista de nombres de usuario: envíe cada nombre de usuario como una tarea de precio fijo independiente y trate el resultado normal como un único perfil.
APIs relacionadas
Además de la Bluesky Profile API, use estas APIs cuando necesite otro tipo de datos públicos de Bluesky.
- Bluesky Post API — Convierte la URL de una publicación pública conocida de bsky.app en campos normalizados de texto, autor, contenido multimedia, marca de tiempo, etiquetas, menciones e interacción visible.
- Bluesky User Posts API — Recolecta una página de publicaciones públicas de Bluesky por identificador o DID, con contenido normalizado, autor, contenido multimedia, marcas de tiempo e interacción visible.