Volver a las API
Datos públicos de Bluesky

Bluesky Public Data API

Obtenga perfiles públicos de Bluesky, resuelva URL de publicaciones conocidas o recopile una página de publicaciones de una cuenta con identidad, contenido, contenido multimedia, marcas de tiempo y campos visibles de interacción normalizados.

API de Bluesky disponibles

Use Profiles para los datos de una cuenta, Posts para una publicación pública conocida o User Posts para una página de publicaciones de un handle o DID.

¿Qué datos de Bluesky se pueden obtener?

SocQ devuelve registros públicos normalizados de perfiles y publicaciones, con contexto de origen y de hora de recolección.

Detalles del perfil público

Obtenga la identidad de la cuenta, la biografía, las imágenes del perfil, el sitio web, los indicadores de la cuenta, los conteos visibles y la hora de recolección, cuando estén disponibles.

Contenido de publicaciones conocidas

Convierta una URL pública de bsky.app en la identidad de la publicación, el texto, los datos del autor, el contenido multimedia, las marcas de tiempo, los hashtags y las menciones.

Publicaciones de cuentas seleccionadas

Recopile una página de la fuente con publicaciones públicas de un handle sin @ o de un DID de Bluesky válido.

Interacción visible

Conserve como observaciones de un momento dado los conteos de Me gusta, comentarios, reposts, veces compartido y vistas que estén disponibles.

SocQ vs una integración directa con Bluesky

SocQ ofrece un flujo de recolección asíncrono y normalizado; con una integración directa, el transporte, los objetos de la fuente, el almacenamiento y la proyección de resultados quedan a cargo de su aplicación.

FuncionalidadSocQIntegración directa
Uso principalRecopilar perfiles públicos, publicaciones conocidas y una página de publicaciones de una cuentaCrear flujos nativos de lectura o escritura del proveedor
AutenticaciónClave de API de SocQLas credenciales dependen del método nativo y del servicio
Entrada inicialNombre de usuario, URL pública de una publicación, handle o DID según el endpointIdentificadores nativos o parámetros propios de cada método
Formato de respuestaRegistros normalizados de SocQObjetos nativos del proveedor que su aplicación debe mapear

Cómo funciona la API de Bluesky

Profiles, Posts y User Posts usan el mismo flujo de tareas asíncronas y de resultados guardados con paginación.

  1. 1. Enviar un identificador compatible

    Envíe un nombre de usuario, una URL de publicación, un handle o un DID a la API correspondiente y guarde el task_id devuelto.

  2. 2. Dar seguimiento a la tarea

    Consulte /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o con error.

  3. 3. Obtener los resultados

    Lea data.results.items y use next_cursor solo mientras queden resultados guardados por recorrer.

Recopilar publicaciones por handle de Bluesky

Autentíquese con su clave de API de SocQ y envíe un handle público a User Posts. Profiles y Posts usan el mismo flujo de tareas.

curl -X POST "https://api.socq.ai/v1/bluesky/user-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"username":"jay.bsky.team"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items after success

Casos de uso frecuentes de la API de Bluesky

Investigación de perfiles

Enriquezca nombres de usuario conocidos con identidad pública, biografía, imágenes, sitio web, métricas visibles y hora de recolección.

Análisis de publicaciones conocidas

Convierta URL de publicaciones seleccionadas en campos normalizados de contenido, autor, contenido multimedia, marca de tiempo, referencias, interacción y origen.

Instantáneas de cuentas públicas

Capture una página de publicaciones de un handle o DID conocido y conserve las marcas de tiempo de origen y de recolección.

Comparación de interacción

Compare los contadores visibles entre recolecciones repetidas, tratándolos como instantáneas de un momento dado.

Límites y política de datos públicos

Los resultados de Bluesky reflejan los campos públicos disponibles durante la recolección. Estas API no acceden a contenido privado ni publican, editan, eliminan o administran cuentas y publicaciones.

  • Profiles requiere un nombre de usuario validado y no acepta URL de perfiles.
  • Posts acepta una referencia no vacía cuyo nombre de host analizado sea bsky.app o un subdominio de bsky.app, incluidas las referencias absolutas con cualquier esquema y las referencias relativas al protocolo; no recopila el feed de una cuenta ni el árbol de respuestas.
  • User Posts requiere username o user_id; el handle no debe incluir @ y user_id debe ser un DID.
  • User Posts no acepta results_limit ni un cursor de la fuente, y recopila solo una página del proveedor.
  • El cursor y el límite de resultados de tareas paginan los registros ya guardados por SocQ; no recopilan otra página de la fuente.
  • Los campos opcionales de identidad, contenido, contenido multimedia, marca de tiempo, referencias e interacción pueden quedar vacíos cuando no están disponibles.

Preguntas frecuentes sobre la API de Bluesky

¿Qué es la API de Bluesky?

Las API de Bluesky obtienen perfiles públicos, resuelven publicaciones conocidas y recopilan una página de publicaciones públicas de una cuenta por handle o DID.

¿Qué API de Bluesky debo usar?

Use Profiles para el registro de una cuenta a partir de su nombre de usuario, Posts para la URL de una publicación conocida de bsky.app y User Posts para una página de publicaciones de un handle o DID.

¿User Posts sigue un cursor de la fuente?

No. Envía una sola solicitud al proveedor y recopila una página de la fuente; next_cursor solo avanza por los registros de resultados que SocQ ya almacenó.

¿Todos los campos y métricas están siempre presentes?

No. La forma normalizada es estable, pero los valores de identidad, contenido, contenido multimedia, marca de tiempo, referencias y métricas que dependen de la fuente pueden ser null.

¿Cuánto cuesta la recolección en Bluesky?

Cada tarea correcta de Profiles, Posts o User Posts cuesta una tarifa fija de 0.19 créditos de SocQ.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.