Bluesky User Posts
Los posts de un usuario de Bluesky son publicaciones públicas recopiladas de una cuenta a partir de su handle o de su identificador descentralizado. Cada registro normalizado puede conservar el texto del post, la identidad del autor, las horas de origen y de recopilación, los archivos multimedia públicos, los hashtags, las menciones y los contadores de interacción disponibles.
Funcionalidades de la Bluesky User Posts API
- Dos identificadores de cuentaEnvíe exactamente un identificador: un handle de Bluesky como jay.bsky.team o un DID con la forma did:method:identifier.
- Recopilación de una página por cuentaEnvía una solicitud al proveedor para la cuenta seleccionada y recopila los posts públicos que expone esa página de origen, sin un cursor de origen ni un límite de resultados controlados por quien llama.
- Resultados estables con forma de postLea la identidad del post, el texto, el autor, las marcas de tiempo, las métricas, los archivos multimedia, los hashtags y las menciones normalizados, sin depender de la estructura de respuesta de un proveedor.
Parámetros de la Bluesky User Posts API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
username | Obligatorio (al menos uno) | Un handle público de Bluesky de 1 a 253 caracteres, con letras, dígitos, puntos o guiones. No se acepta una @ inicial; omita este campo cuando envíe user_id en su lugar. |
user_id | Obligatorio (al menos uno) | Un identificador descentralizado de Bluesky que comience con did:, seguido de un método en minúsculas y de un identificador no vacío con letras, dígitos, puntos, guiones bajos, dos puntos, signos de porcentaje o guiones admitidos. |
Cómo usar la Bluesky User Posts API
Envíe un handle o un DID de Bluesky, siga la tarea asíncrona y lea al terminar sus registros PostItem guardados.
- Elija un handle público de Bluesky sin la @ inicial o el DID de la cuenta.
- Envíe por POST el identificador elegido a /v1/bluesky/user-posts y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o informe un fallo.
- Lea data.results.items; use el next_cursor de la respuesta de la tarea solo cuando el conjunto de resultados guardado tenga otra página.
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 the task succeedsCasos de uso de la Bluesky User Posts API
- Instantáneas del contenido de una cuenta: Capture una página de posts públicos en un momento concreto para un handle o DID conocido, conservando los ID de los posts, las URL de origen, las horas de publicación y las horas de recopilación.
- Investigación de patrones de publicación: Revise el texto normalizado, la autoría, los hashtags, las menciones y los archivos multimedia disponibles para estudiar los temas y los formatos de una cuenta pública seleccionada.
- Comparación de la interacción visible: Compare los Me gusta, comentarios, compartidos y vistas disponibles entre los posts recopilados, tratando los contadores ausentes como no disponibles y no como cero.
Consejos de expertos para la Bluesky User Posts API
- Envíe los handles sin @ y valídelos con letras, dígitos, puntos y guiones antes de crear una tarea.
- Use el DID completo cuando la identidad de la cuenta deba mantenerse estable ante cambios de handle; no envíe un ID de usuario arbitrario.
- No agregue results_limit ni un cursor de origen a la carga útil del POST: la recopilación del proveedor es de una sola página y esos campos se rechazan.
- Trate los datos del autor, los archivos multimedia, los hashtags, las menciones y los contadores individuales como opcionales, y deduplique las instantáneas repetidas con el id del post.
APIs relacionadas
Además de la Bluesky User Posts API, use estas APIs cuando necesite otro tipo de datos públicos de Bluesky.
- Bluesky Profile API — Obtiene un perfil público de Bluesky a partir de un nombre de usuario validado, con identidad normalizada, biografía, imágenes, sitio web, campos de estado, conteos visibles de la cuenta y contexto de recolección.
- 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.