bluesky/
user-posts

Recopile una página de posts públicos de Bluesky por handle o DID, con texto normalizado, identidad del autor, marcas de tiempo, métricas de interacción y los archivos multimedia disponibles.

Bluesky User Posts API

Entrada por handle o DID
Una página de origen
Registros de posts normalizados
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 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ámetrosObligatorioDescripción
usernameObligatorio (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_idObligatorio (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.

  1. Elija un handle público de Bluesky sin la @ inicial o el DID de la cuenta.
  2. Envíe por POST el identificador elegido a /v1/bluesky/user-posts y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o informe un fallo.
  4. 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 succeeds

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

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.

Explorar otras plataformas

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

Bluesky User Posts API — FAQ

Bluesky User Posts API es una interfaz para recuperar una página de posts públicos de una cuenta por handle o DID de Bluesky, y devuelve el texto normalizado de los posts, el autor, los archivos multimedia, las marcas de tiempo y los datos visibles de interacción.

Envíe exactamente uno. username es el handle público sin @, mientras que user_id debe ser un DID válido. Si envía ambos campos, se devuelve un error de validación.

No. El contrato de envío acepta solo username y user_id, y la ejecución del proveedor recopila una página de origen sin seguir un cursor del proveedor.

El endpoint de la tarea pagina los registros que SocQ ya guardó y acepta un límite de lectura de 1 a 500. Ese cursor de resultados almacenados no activa otra página del proveedor de Bluesky.

El esquema PostItem incluye la identidad, las etiquetas de plataforma y de recurso, la URL, las horas de publicación y de recopilación, el texto, el autor, las métricas, los archivos multimedia, los hashtags y las menciones. Los campos que dependen de la fuente pueden ser nulos.

Una tarea exitosa tiene un cargo fijo de 0.19 créditos de SocQ. El cargo no varía con la cantidad de posts guardados de la página de origen.