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à | SocQ | Integrazione diretta |
|---|---|---|
| Uso principale | Raccogliere profili pubblici, post noti e una pagina di post di un account | Creare flussi di lettura o scrittura nativi del provider |
| Autenticazione | Chiave API di SocQ | Le credenziali dipendono dal metodo nativo e dal servizio |
| Input iniziale | Nome utente, URL pubblico del post, handle o DID a seconda dell’endpoint | Identificatori nativi o parametri specifici del metodo |
| Formato della risposta | Record SocQ normalizzati | Oggetti 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. 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. Segui l’attività
Interroga /v1/tasks/{task_id} finché l’elaborazione ha successo o fallisce.
3. Recupera i risultati
Leggi data.results.items e usa next_cursor solo finché restano altri risultati salvati.
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 successCasi 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.
Combina i dati di più piattaforme per analisi di business più complete
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.
Snapchat API
Recupera uno Spotlight pubblico noto di Snapchat come record normalizzato con i campi disponibili su creator, didascalia, media, audio, data, durata ed engagement.
Twitch API
Risolvi un nome utente Twitch pubblico noto in un profilo normalizzato, raccogli il suo inventario di video pubblici o recupera una clip con il suo video scaricabile per ricerca sui creator, arricchimento del catalogo, confronto e monitoraggio con istantanee.
Rednote API
Recupera profili e note pubblici, cerca note o utenti, raccogli commenti e risposte annidate e acquisisci una pagina di consigli della home.
Kwai API
Recupera profili Kwai pubblici, una pagina di post di un account o un post noto, con identità, contenuti, media, timestamp ed engagement visibile normalizzati.
Truth Social API
Recupera i dettagli pubblici di un account, raccogli una pagina della fonte con i post di un account o risolvi l’URL di un post noto in record normalizzati.
Google Ad Library API
Trova gli inserzionisti pubblici, raccogli le creatività di un’azienda o recupera per URL una creatività nota del Transparency Center, per ricerca e verifica.


