Torna alle API
Dati pubblici di Bluesky

Bluesky Public Data API

Recupera i profili pubblici di Bluesky, risolvi URL di post noti o raccogli una pagina di post di un account, con campi normalizzati di identità, contenuti, media, timestamp ed engagement visibile.

API di Bluesky disponibili

Usa Profiles per i dati degli account, Posts per un singolo post pubblico noto o User Posts per una pagina di post di un handle o di un DID.

Quali dati di Bluesky puoi recuperare?

SocQ restituisce record normalizzati di profili e post pubblici, con il contesto di origine e dell’orario di raccolta.

Dettagli dei profili pubblici

Recupera identità dell’account, biografia, immagini del profilo, sito web, flag dell’account, numeri visibili e orario di raccolta, quando disponibili.

Contenuto di post noti

Risolvi un URL pubblico bsky.app in identità del post, testo, dettagli dell’autore, media, timestamp, hashtag e menzioni.

Post di account selezionati

Raccogli una pagina della fonte con i post pubblici di un handle senza @ o di un DID Bluesky valido.

Engagement visibile

Conserva il numero disponibile di Mi piace, commenti, repost, condivisioni e visualizzazioni come osservazioni rilevate in un dato momento.

SocQ vs un’integrazione diretta con Bluesky

SocQ offre un flusso di raccolta asincrono e normalizzato; un’integrazione diretta lascia alla tua applicazione trasporto, oggetti della fonte, archiviazione e proiezione dei risultati.

FunzionalitàSocQIntegrazione diretta
Uso principaleRaccogliere profili pubblici, post noti e una pagina di post di un accountCreare flussi di lettura o scrittura nativi del provider
AutenticazioneChiave API di SocQLe credenziali dipendono dal metodo nativo e dal servizio
Input inizialeNome utente, URL pubblico del post, handle o DID a seconda dell’endpointIdentificatori nativi o parametri specifici del metodo
Formato della rispostaRecord SocQ normalizzatiOggetti nativi del provider che la tua applicazione deve mappare

Come funzionano le API di Bluesky

Profiles, Posts e User Posts usano la stessa attività asincrona e lo stesso flusso di risultati salvati con paginazione.

  1. 1. Invia un identificatore supportato

    Invia un nome utente, un URL di post, un handle o un DID all’API corrispondente e salva il task_id restituito.

  2. 2. Segui l’attività

    Interroga /v1/tasks/{task_id} finché l’elaborazione ha successo o fallisce.

  3. 3. Recupera i risultati

    Leggi data.results.items e usa next_cursor solo finché restano altri risultati salvati.

Raccogli i post per handle di Bluesky

Autenticati con la tua chiave API di SocQ e invia un handle pubblico a User Posts. Profiles e Posts usano lo stesso flusso di attività.

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 success

Casi d’uso comuni delle API di Bluesky

Ricerca sui profili

Arricchisci nomi utente noti con identità pubblica, biografia, immagini, sito web, metriche visibili e orario di raccolta.

Analisi di post noti

Risolvi gli URL di post selezionati in campi normalizzati di contenuto, autore, media, timestamp, riferimenti, engagement e origine.

Istantanee di account pubblici

Acquisisci una pagina di post per un handle o un DID noto e conserva i timestamp di origine e di raccolta.

Confronto dell’engagement

Confronta i contatori visibili tra raccolte ripetute, trattandoli come istantanee rilevate in un dato momento.

Limiti e policy sui dati pubblici

I risultati di Bluesky rappresentano i campi pubblici disponibili durante la raccolta. Queste API non accedono a contenuti privati e non pubblicano, modificano, eliminano né gestiscono account e post.

  • Profiles richiede un solo nome utente valido e non accetta URL di profili.
  • Posts accetta un solo riferimento non vuoto il cui hostname analizzato è bsky.app o un sottodominio di bsky.app, inclusi i riferimenti assoluti con qualsiasi schema e quelli relativi al protocollo; non raccoglie il feed di un account né l’albero delle risposte.
  • User Posts richiede username o user_id; l’handle non deve includere @ e user_id deve essere un DID.
  • User Posts non accetta results_limit né un cursore della fonte e raccoglie una sola pagina del provider.
  • Il cursore e il limite dei risultati delle attività paginano i record già salvati da SocQ; non raccolgono un’altra pagina della fonte.
  • I campi facoltativi di identità, contenuto, media, timestamp, riferimenti ed engagement possono essere vuoti quando non sono disponibili.

Domande frequenti sulle API di Bluesky

Che cosa sono le API di Bluesky?

Le API di Bluesky recuperano i profili pubblici, risolvono post noti e raccolgono una pagina di post pubblici di un account per handle o DID.

Quale API di Bluesky devo usare?

Usa Profiles per il record di un account a partire dal nome utente, Posts per un URL noto di un post su bsky.app e User Posts per una pagina di post di un handle o di un DID.

User Posts segue un cursore della fonte?

No. Invia una sola richiesta al provider e raccoglie una sola pagina della fonte; next_cursor scorre solo i record dei risultati già salvati da SocQ.

Ogni campo e ogni metrica sono sempre presenti?

No. La struttura normalizzata è stabile, ma i valori di identità, contenuto, media, timestamp, riferimenti e metriche che dipendono dalla fonte possono essere null.

Quanto costa la raccolta su Bluesky?

Ogni attività Profiles, Posts o User Posts riuscita costa un importo fisso di 0,19 crediti SocQ.

Riunisci in un unico flusso i dati pubblici di profili, contenuti ed engagement di piattaforme diverse per monitorare brand, creator e argomenti e condurre monitoraggi e analisi cross-platform in modo più efficiente.