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.
| Funcionalidad | SocQ | Integración directa |
|---|---|---|
| Uso principal | Recopilar perfiles públicos, publicaciones conocidas y una página de publicaciones de una cuenta | Crear flujos nativos de lectura o escritura del proveedor |
| Autenticación | Clave de API de SocQ | Las credenciales dependen del método nativo y del servicio |
| Entrada inicial | Nombre de usuario, URL pública de una publicación, handle o DID según el endpoint | Identificadores nativos o parámetros propios de cada método |
| Formato de respuesta | Registros normalizados de SocQ | Objetos 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. 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. Dar seguimiento a la tarea
Consulte /v1/tasks/{task_id} hasta que el procesamiento termine con éxito o con error.
3. Obtener los resultados
Lea data.results.items y use next_cursor solo mientras queden resultados guardados por recorrer.
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 successCasos 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.
Combine datos de varias plataformas para obtener información de negocio más completa
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.
Snapchat API
Obtenga un Spotlight público conocido de Snapchat como un registro normalizado con los campos disponibles de creador, descripción, multimedia, audio, marca de tiempo, duración e interacción.
Twitch API
Convierta un nombre de usuario público conocido de Twitch en un perfil normalizado, recopile su inventario público de videos u obtenga un clip con su video descargable para investigación de creadores de contenido, enriquecimiento de catálogos, comparaciones y monitoreo mediante instantáneas.
Rednote API
Obtenga perfiles y notas públicos, busque notas o usuarios, recopile comentarios y respuestas anidadas, y capture una página de recomendaciones de inicio.
Kwai API
Obtenga perfiles públicos de Kwai, una página de publicaciones de una cuenta o una publicación conocida, con identidad, contenido, contenido multimedia, marcas de tiempo e interacción visible normalizados.
Truth Social API
Obtenga los datos de una cuenta pública, recopile una página de origen de publicaciones de una cuenta o convierta la URL de una publicación conocida en registros normalizados.
Google Ad Library API
Descubra anunciantes públicos, obtenga las creatividades de una empresa o consulte por URL una creatividad conocida del Transparency Center para investigación y revisión.


