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ámetros | Obligatorio | Descripción |
|---|---|---|
url | Obligatorio | Referencia 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.
- Prepare una URL pública de bsky.app que lleve al post de Bluesky que quiere inspeccionar.
- Envíe la URL como url a /v1/bluesky/post y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea termine con éxito o devuelva un fallo.
- 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 trueCasos 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.
APIs relacionadas
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.