bluesky/
post

Raccogli un post pubblico di Bluesky da un URL noto di bsky.app, con testo, identità dell’autore, media, timestamp, hashtag, menzioni ed engagement visibile.

Bluesky Post API

URL di un singolo post
Contesto dell’autore
Istantanea dell’engagement
0,19 crediti per richiesta
Pronto
Pronto

Inserisci i parametri e invia una richiesta. Qui compariranno lo stato dell’attività e i risultati normalizzati.

README

A cura di SocQ · Aggiornato il

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

ParametriObbligatorioDescrizione
urlObbligatorioRiferimento 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.

  1. Prepara un URL pubblico di bsky.app che punti al post di Bluesky che vuoi esaminare.
  2. Invia l’URL come url a /v1/bluesky/post e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
  4. 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 true

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

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.

Esplora altre piattaforme

Combina i dati di Bluesky con i dati pubblici delle altre piattaforme social supportate.

Bluesky Post API — FAQ

Bluesky Post API è un’interfaccia programmatica per recuperare un post pubblico di Bluesky da un URL noto. Restituisce testo, identità dell’autore, media, timestamp, hashtag, menzioni e conteggi visibili di engagement, tutti normalizzati.

Invia un solo riferimento non vuoto il cui hostname analizzato è bsky.app o un sottodominio di bsky.app. Il backend accetta riferimenti assoluti con qualsiasi schema e riferimenti relativi al protocollo; la richiesta accetta solo il campo url.

Lo schema del post include campi di identità e di origine, testo, orari di pubblicazione e di raccolta, dettagli dell’autore, media, hashtag, menzioni e conteggi disponibili di Mi piace, commenti, repost e visualizzazioni. I campi nullable restano vuoti quando la fonte pubblica non espone un valore utilizzabile.

No. Il risultato rappresenta il post selezionato e può esporre un comments_count visibile, ma lo schema del post non restituisce record di risposta separati né un albero delle risposte.

No. La richiesta risolve un solo url e non accetta results_limit; leggi l’elemento restituito attraverso l’envelope standard dei risultati dell’attività.

Ogni attività Bluesky Post riuscita costa 0,19 crediti SocQ fissi. L’addebito non dipende dal numero di risultati richiesti o restituiti.