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
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio (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_id | Obbligatorio (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.
- Scegli un handle pubblico di Bluesky senza @ iniziale oppure il DID dell’account.
- Invia con POST l’identificatore scelto a /v1/bluesky/user-posts e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o segnala un errore.
- 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 succeedsCasi 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.
API correlate
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.