bluesky/
post

Recopile un post público de Bluesky a partir de una URL conocida de bsky.app, con el texto, la identidad del autor, los archivos multimedia, las marcas de tiempo, los hashtags, las menciones y la interacción visible.

Bluesky Post API

URL de un solo post
Contexto del autor
Instantánea de interacción
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 Post

Los posts de Bluesky son publicaciones públicas con texto, identidad del autor, archivos multimedia, marcas de tiempo, hashtags, menciones y conteos visibles de interacción. Estos registros sirven para enriquecer URL, revisar fuentes, investigar contenido y comparar la interacción en momentos concretos.

Funcionalidades de la Bluesky Post API

  • Consulta de un post conocidoResuelve una URL pública de bsky.app en el registro normalizado de ese post seleccionado, en lugar de expandir el feed de una cuenta.
  • Contenido y contexto del autorDevuelve juntos el texto del post disponible, la URL de origen, la identidad del autor, los archivos multimedia adjuntos, los hashtags, las menciones y la hora de publicación.
  • Instantánea de la interacción visibleMantiene los conteos disponibles de Me gusta, comentarios, reposts y vistas junto con la hora de recopilación, como una observación en un momento concreto.

Parámetros de la Bluesky Post API

ParámetrosObligatorioDescripción
urlObligatorioReferencia obligatoria y no vacía a un post cuyo nombre de host analizado sea bsky.app o un subdominio de bsky.app. El validador del envío acepta referencias absolutas con cualquier esquema y referencias relativas al protocolo.

Cómo usar la Bluesky Post API

Envíe la URL de un post público conocido de Bluesky, siga la tarea asíncrona y lea el resultado normalizado mediante la estructura de resultados estándar.

  1. Prepare una URL pública de bsky.app que lleve al post de Bluesky que quiere inspeccionar.
  2. Envíe la URL como url a /v1/bluesky/post 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; siga next_cursor solo cuando la estructura de resultados indique has_more como true.
curl -X POST "https://api.socq.ai/v1/bluesky/post" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://bsky.app/profile/jay.bsky.team/post/3micofpyeys2g"}'

# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor only while has_more is true

Casos de uso de la Bluesky Post API

  • Enriquecer la URL de un post conocido: Convierta un enlace seleccionado de bsky.app en campos estructurados de texto, autor, archivos multimedia, marca de tiempo, etiquetas, menciones, métricas y origen.
  • Revisar el contenido y la atribución: Use el texto del post, la identidad del autor, los archivos multimedia y la URL pública de origen para examinar una publicación seleccionada con una atribución rastreable.
  • Comparar observaciones de interacción: Combine los conteos visibles de interacción con collected_at para comparar instantáneas recopiladas por separado, sin tratarlas como un flujo en vivo.

Consejos de expertos para la Bluesky Post API

  • Confirme que el nombre de host analizado sea bsky.app o un subdominio de bsky.app. El validador del envío no restringe el esquema de la URL y también acepta referencias relativas al protocolo.
  • Use una URL de post por tarea y omita results_limit, porque la entrada identifica un post seleccionado y no una página de feed.
  • Trate el texto del post, los datos del autor, los archivos multimedia, los hashtags, las menciones, la hora de publicación y las métricas individuales como campos que pueden ser nulos.
  • Almacene collected_at junto con los conteos visibles de interacción para que las comparaciones posteriores conserven el momento en que se hizo cada observación.

Además de la Bluesky Post 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 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 Post API — FAQ

Bluesky Post API es una interfaz programática para recuperar un post público de Bluesky a partir de una URL de post conocida. Devuelve el texto normalizado, la identidad del autor, los archivos multimedia, las marcas de tiempo, los hashtags, las menciones y los conteos visibles de interacción.

Envíe una referencia no vacía cuyo nombre de host analizado sea bsky.app o un subdominio de bsky.app. El backend acepta referencias absolutas con cualquier esquema y referencias relativas al protocolo; la solicitud acepta únicamente el campo url.

El esquema del post incluye campos de identidad y origen, el texto, las horas de publicación y de recopilación, los datos del autor, los archivos multimedia, los hashtags, las menciones y los conteos disponibles de Me gusta, comentarios, reposts y vistas. Los campos que pueden ser nulos quedan vacíos cuando la fuente pública no expone un valor utilizable.

No. El resultado representa el post seleccionado y puede exponer un comments_count visible, pero el esquema del post no devuelve registros de respuestas independientes ni un árbol de respuestas.

No. La solicitud resuelve una sola url y no acepta results_limit; lea el elemento devuelto mediante la estructura estándar de resultados de la tarea.

Cada tarea exitosa de Bluesky Post cuesta una tarifa fija de 0.19 créditos de SocQ. El cargo no depende de la cantidad de resultados solicitados ni devueltos.