Bluesky Post
I post di Bluesky sono pubblicazioni pubbliche con testo, identità dell’autore, media, timestamp, hashtag, menzioni e conteggi visibili di engagement. Questi record supportano l’arricchimento degli URL, la revisione delle fonti, la ricerca sui contenuti e il confronto dell’engagement con data e ora.
Funzionalità della Bluesky Post API
- Ricerca di un post notoTrasforma un URL pubblico di bsky.app nel record normalizzato del post selezionato, invece di espandere il feed di un account.
- Contenuto e contesto dell’autoreRestituisce insieme testo del post, URL di origine, identità dell’autore, media allegati, hashtag, menzioni e orario di pubblicazione, se disponibili.
- Istantanea dell’engagement visibileConserva i conteggi disponibili di Mi piace, commenti, repost e visualizzazioni insieme all’orario di raccolta, come osservazione in un preciso momento.
Parametri della Bluesky Post API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
url | Obbligatorio | Riferimento al post obbligatorio e non vuoto il cui hostname analizzato è bsky.app o un sottodominio di bsky.app. Il validatore dell’invio accetta riferimenti assoluti con qualsiasi schema e riferimenti relativi al protocollo. |
Come usare la Bluesky Post API
Invia l’URL di un post pubblico di Bluesky già noto, segui l’attività asincrona e leggi il risultato normalizzato attraverso l’envelope di risultato standard.
- Prepara un URL pubblico di bsky.app che punti al post di Bluesky che vuoi esaminare.
- Invia l’URL come url a /v1/bluesky/post e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- Leggi data.results.items; segui next_cursor solo quando l’envelope di risultato indica has_more a 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 trueCasi d’uso della Bluesky Post API
- Arricchire l’URL di un post noto: Converti un link bsky.app selezionato in campi strutturati di testo, autore, media, timestamp, tag, menzioni, metriche e origine.
- Verificare contenuto e attribuzione: Usa testo del post, identità dell’autore, media e URL pubblico di origine per esaminare una pubblicazione selezionata con un’attribuzione tracciabile.
- Confrontare le osservazioni dell’engagement: Abbina i conteggi visibili di engagement a collected_at per confrontare istantanee raccolte separatamente, senza considerarle un flusso in tempo reale.
Consigli degli esperti per la Bluesky Post API
- Verifica che l’hostname analizzato sia bsky.app o un sottodominio di bsky.app. Il validatore dell’invio non limita lo schema dell’URL e accetta anche riferimenti relativi al protocollo.
- Usa un URL di post per attività e ometti results_limit, perché l’input identifica un solo post selezionato e non una pagina di feed.
- Tratta testo del post, dettagli dell’autore, media, hashtag, menzioni, orario di pubblicazione e singole metriche come campi nullable.
- Salva collected_at insieme ai conteggi visibili di engagement, così i confronti successivi conservano il momento in cui è stata fatta ogni osservazione.
API correlate
Oltre alla Bluesky Post API, usa queste API quando ti serve un altro tipo di dati pubblici di Bluesky.
- Bluesky Profile API — Recupera un profilo Bluesky pubblico a partire da un nome utente validato con identità, bio, immagini, sito web, campi di stato, conteggi visibili dell’account e contesto della raccolta normalizzati.
- Bluesky User Posts API — Raccoglie una pagina di post pubblici di Bluesky per handle o DID con contenuti, autore, media, date ed engagement visibile normalizzati.