bluesky/
profile

Recupera un profilo pubblico di Bluesky da un nome utente validato, con identità normalizzata, biografia, immagini del profilo, sito web e conteggi visibili dell’account in un’unica attività asincrona.

Bluesky Profile API

Input con nome utente validato
Identità e immagini del profilo
Conteggi visibili dell’account
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 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

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

  1. Prepara un nome utente Bluesky con lettere, cifre, punti o trattini, come jay.bsky.team, e ometti la @ iniziale.
  2. Invia username a /v1/bluesky/profile 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. 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.items

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

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.

Esplora altre piattaforme

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

Bluesky Profile API — FAQ

Bluesky Profile API è un’interfaccia programmatica per recuperare un profilo pubblico di Bluesky da un nome utente validato. Restituisce identità, biografia, immagini del profilo, sito web, campi di stato facoltativi, conteggi visibili dell’account e orario di raccolta, tutti normalizzati.

Invia da 1 a 253 caratteri tra lettere, cifre, punti o trattini, senza @ iniziale. Trattini bassi, due punti, URL di profili, DID, valori vuoti e campi aggiuntivi nella richiesta vengono rifiutati.

Il record standard dell’account include campi di identità e di origine, nome utente, nome visualizzato, biografia, avatar, copertina, sito web, valori di verifica e privacy, località facoltativa, conteggi di follower, seguiti e post e orario di raccolta. I campi facoltativi restano null quando non sono disponibili.

No. Ogni attività accetta un solo nome utente e di norma restituisce al massimo un profilo, senza results_limit né cursore di input controllato da chi chiama; i risultati dell’attività usano comunque l’envelope standard con next_cursor e has_more.

Ogni attività riuscita costa 0,19 crediti SocQ fissi. L’addebito non cresce con il numero di risultati, perché la richiesta esegue una sola ricerca di profilo.