bluesky/
profile

Obtenga un perfil público de Bluesky a partir de un nombre de usuario validado, con identidad normalizada, biografía, imágenes del perfil, sitio web y conteos visibles de la cuenta en una sola tarea asíncrona.

Bluesky Profile API

Nombre de usuario validado
Identidad e imágenes del perfil
Conteos visibles de la cuenta
0.19 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
usernameObligatorioNombre 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.

  1. Prepare un nombre de usuario de Bluesky con letras, dígitos, puntos o guiones, como jay.bsky.team, y omita la @ inicial.
  2. Envíe username a /v1/bluesky/profile y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un fallo.
  4. 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.items

Casos 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.

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.

Explorar otras plataformas

Combine los datos de Bluesky con datos públicos de otras plataformas sociales compatibles.

Bluesky Profile API — FAQ

Bluesky Profile API es una interfaz programática para recuperar un perfil público de Bluesky a partir de un nombre de usuario validado. Devuelve la identidad normalizada, la biografía, las imágenes del perfil, el sitio web, los campos de estado opcionales, los conteos visibles de la cuenta y la hora de recopilación.

Envíe de 1 a 253 letras, dígitos, puntos o guiones, sin una @ inicial. Se rechazan los guiones bajos, los dos puntos, las URL de perfiles, los DID, los valores vacíos y los campos adicionales en la solicitud.

El registro de cuenta estándar incluye campos de identidad y origen, el nombre de usuario, el nombre visible, la biografía, el avatar, la portada, el sitio web, los valores de verificación y privacidad, la ubicación opcional, los conteos de seguidores, seguidos y posts, y la hora de recopilación. Los campos opcionales quedan en null cuando no están disponibles.

No. Cada tarea acepta un solo nombre de usuario y normalmente devuelve como máximo un perfil, sin results_limit ni un cursor de entrada controlado por quien llama; los resultados de la tarea siguen usando la estructura estándar de next_cursor y has_more.

Cada tarea exitosa cuesta una tarifa fija de 0.19 créditos de SocQ. El cargo no escala con la cantidad de resultados, porque la solicitud realiza una sola consulta de perfil.