bluesky/
user-posts

Raccogli una pagina di post pubblici di Bluesky per handle o DID, con testo normalizzato, identità dell’autore, timestamp, metriche di engagement e media disponibili.

Bluesky User Posts API

Input con handle o DID
Una pagina di origine
Record di post normalizzati
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 User Posts

I Bluesky User Posts sono pubblicazioni pubbliche raccolte da un solo account tramite il suo handle o identificatore decentralizzato. Ogni record normalizzato può conservare testo del post, identità dell’autore, orari di origine e di raccolta, media pubblici, hashtag, menzioni e contatori di engagement disponibili.

Funzionalità della Bluesky User Posts API

  • Due identificatori di accountInvia esattamente un identificatore: un handle di Bluesky come jay.bsky.team oppure un DID nel formato did:method:identifier.
  • Raccolta di una pagina per accountInvia una sola richiesta al provider per l’account selezionato e raccogli i post pubblici esposti in quella pagina di origine, senza cursore di origine né limite di risultati controllati da chi chiama.
  • Risultati stabili nel formato postLeggi identità, testo, autore, timestamp, metriche, media, hashtag e menzioni normalizzati del post, senza dipendere dall’envelope di risposta del provider.

Parametri della Bluesky User Posts API

ParametriObbligatorioDescrizione
usernameObbligatorio (almeno uno)Un handle pubblico di Bluesky da 1 a 253 caratteri, con lettere, cifre, punti o trattini. Una @ iniziale non è accettata; ometti questo campo quando fornisci user_id.
user_idObbligatorio (almeno uno)Un identificatore decentralizzato di Bluesky che inizia con did:, seguito da un metodo in minuscolo e da un identificatore non vuoto con lettere, cifre, punti, trattini bassi, due punti, segni di percentuale o trattini supportati.

Come usare la Bluesky User Posts API

Invia un handle o un DID di Bluesky, segui l’attività asincrona e leggi i relativi record PostItem salvati al termine.

  1. Scegli un handle pubblico di Bluesky senza @ iniziale oppure il DID dell’account.
  2. Invia con POST l’identificatore scelto a /v1/bluesky/user-posts e salva il task_id restituito.
  3. Interroga /v1/tasks/{task_id} finché l’attività riesce o segnala un errore.
  4. Leggi data.results.items; usa il next_cursor della risposta dell’attività solo quando l’insieme dei risultati salvati ha un’altra pagina.
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 the task succeeds

Casi d’uso della Bluesky User Posts API

  • Istantanee dei contenuti di un account: Acquisisci una pagina di post pubblici in un preciso momento per un handle o un DID noto, conservando ID dei post, URL di origine, orari di pubblicazione e di raccolta.
  • Ricerca sui modelli di pubblicazione: Esamina testo, paternità, hashtag, menzioni e media disponibili normalizzati per studiare temi e formati all’interno di un account pubblico selezionato.
  • Confronto dell’engagement visibile: Confronta Mi piace, commenti, condivisioni e visualizzazioni disponibili tra i post raccolti, trattando i contatori assenti come non disponibili e non come zero.

Consigli degli esperti per la Bluesky User Posts API

  • Invia gli handle senza @ e validali rispetto a lettere, cifre, punti e trattini prima di creare un’attività.
  • Usa il DID completo quando l’identità dell’account deve restare stabile anche se l’handle cambia; non inviare un ID utente arbitrario.
  • Non aggiungere results_limit né un cursore di origine al payload della POST: la raccolta dal provider è di una sola pagina e quei campi vengono rifiutati.
  • Tratta dettagli dell’autore, media, hashtag, menzioni e singoli contatori come facoltativi e deduplica le istantanee ripetute con l’id del post.

Oltre alla Bluesky User Posts 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 Post API — Trasforma l’URL di un post pubblico noto di bsky.app in testo, autore, media, data, tag, menzioni ed engagement visibile normalizzati.

Esplora altre piattaforme

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

Bluesky User Posts API — FAQ

Bluesky User Posts API è un’interfaccia per recuperare una pagina di post pubblici di un account tramite handle o DID di Bluesky, con testo del post, autore, media, timestamp e dati visibili di engagement normalizzati.

Invia esattamente uno dei due. username è l’handle pubblico senza @, mentre user_id deve essere un DID valido. Fornire entrambi i campi restituisce un errore di validazione.

No. Il contratto di invio accetta solo username e user_id e l’esecuzione dal provider raccoglie una sola pagina di origine, senza seguire un cursore del provider.

L’endpoint dell’attività pagina i record già salvati da SocQ e accetta un limite di lettura da 1 a 500. Quel cursore sui risultati salvati non attiva un’altra pagina dal provider Bluesky.

Lo schema PostItem include identità, etichette di piattaforma e di risorsa, URL, orari di pubblicazione e di raccolta, testo, autore, metriche, media, hashtag e menzioni. I campi che dipendono dalla fonte possono essere null.

Un’attività riuscita ha un addebito fisso di 0,19 crediti SocQ. L’addebito non varia con il numero di post salvati dalla pagina di origine.