Bluesky Profile
I profili di Bluesky sono record pubblici di account con identificativo persistente, handle, nome visualizzato, biografia, immagini del profilo, sito web e conteggi visibili di follower, seguiti e post. Questi campi di identità e segnali dell’account supportano l’arricchimento dei profili, il confronto tra account pubblici e l’osservazione nel tempo.
Funzionalità della Bluesky Profile API
- Ricerca diretta per nome utenteTrasforma un nome utente di 1–253 caratteri tra lettere, cifre, punti o trattini in un record di profilo pubblico.
- Identità normalizzata del profiloRestituisce ID del profilo, URL di origine, nome utente, nome visualizzato, biografia e sito web collegato, quando disponibili, in una struttura di account coerente.
- Immagini del profilo e campi di statoMantiene come campi nullable i valori disponibili di avatar, copertina, verifica e privacy, senza inventarli quando la fonte li omette.
- Istantanea dei conteggi visibili dell’accountRaggruppa i conteggi disponibili di follower, seguiti e post con collected_at, così ogni istantanea pubblica dell’account ha un orario di osservazione.
Parametri della Bluesky Profile API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio | Nome utente pubblico di Bluesky obbligatorio, di 1–253 caratteri tra lettere, cifre, punti o trattini. Non includere una @ iniziale, trattini bassi, DID, URL di profili né un secondo nome utente. |
Come usare la Bluesky Profile API
Invia un nome utente validato, segui l’attività asincrona e leggi il profilo normalizzato dalla risposta di risultato standard.
- Prepara un nome utente Bluesky con lettere, cifre, punti o trattini, come jay.bsky.team, e ometti la @ iniziale.
- Invia username a /v1/bluesky/profile e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- Leggi data.results.items. Questa ricerca di norma salva un solo profilo, quindi has_more è false; se la risposta di risultato generica segnala altri dati, continua con next_cursor.
curl -X POST "https://api.socq.ai/v1/bluesky/profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"jay.bsky.team"}'
# Poll GET /v1/tasks/{task_id}
# Read the profile from data.results.itemsCasi d’uso della Bluesky Profile API
- Arricchimento di profili noti: Aggiungi handle pubblico, nome visualizzato, biografia, immagini del profilo, sito web e URL di origine a un record che contiene già un nome utente Bluesky.
- Confronto dell’impronta degli account: Confronta i conteggi disponibili di follower, seguiti e post tra nomi utente inviati separatamente, usando le stesse chiavi di metrica normalizzate.
- Monitoraggio della presentazione del profilo: Salva identità, biografia, immagini, sito web e collected_at in attività ripetute per individuare le variazioni tra istantanee pubbliche.
Consigli degli esperti per la Bluesky Profile API
- Rimuovi la @ iniziale e valida il nome utente rimanente rispetto a lettere, cifre, punti e trattini prima dell’invio; rifiuta i valori DID, perché questo endpoint non accetta user_id.
- Usa l’id restituito come chiave di deduplicazione preferita, poi ripiega su url o username quando id è vuoto.
- Consenti che biografia, avatar, copertina, sito web, flag di stato, località e singole metriche siano null, così i record pubblici parziali restano utilizzabili.
- Non aggiungere results_limit né un array username: invia ogni nome utente come attività separata a prezzo fisso e considera il risultato normale come un singolo profilo.
API correlate
Oltre alla Bluesky Profile API, usa queste API quando ti serve un altro tipo di dati pubblici di Bluesky.
- Bluesky Post API — Trasforma l’URL di un post pubblico noto di bsky.app in testo, autore, media, data, tag, menzioni ed engagement visibile 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.