Reddit User Posts
La cronologia dei post di un utente Reddit è l’elenco dei contenuti che un account ha pubblicato nelle varie community, ciascuno con titolo e testo, link, data di pubblicazione, punteggio netto, numero di commenti ed eventuali immagini o video allegati. Letta per data o per punteggio, mostra cosa condivide una persona, quali suoi argomenti trovano seguito e come cambia la sua produzione nel tempo, e alimenta la ricerca sui creator, il monitoraggio dell’account di un fondatore e la raccolta degli approfondimenti scritti da un esperto.
Funzionalità della Reddit User Posts API
- Uno username, fino a 1.000 postusername accetta un solo account con o senza il prefisso u/, e results_limit raccoglie da 1 a 1.000 dei suoi post, 25 se non lo imposti.
- Titolo e corpo in un solo campotext inizia con il titolo del post e, per i post di testo, prosegue con una riga vuota e il corpo completo, così un unico campo contiene tutto lo scritto.
- Punteggio netto e numero di commentimetrics.likes_count è il punteggio del post, cioè voti positivi meno voti negativi, e metrics.comments_count indica quanta discussione ha generato.
- Immagini, gallerie e video ospitatimedia elenca ogni immagine o video allegato con url, immagine di anteprima e larghezza e altezza in pixel, pronto per miniature o download.
Parametri della Reddit User Posts API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
username | Obbligatorio | Un solo username di Reddit, con o senza il prefisso u/, composto da 3 a 20 caratteri tra lettere, cifre, trattini e trattini bassi. |
sort_by | Facoltativo | Ordine dei post: new (predefinito), top oppure hot. |
results_limit | Facoltativo | Numero massimo di post da raccogliere, un intero da 1 a 1.000; il valore predefinito è 25. |
Come usare la Reddit User Posts API
Invia uno username con un ordinamento e un limite, poi scorri le pagine dei post.
- Invia con POST {"username": "spez", "sort_by": "new", "results_limit": 25} a /v1/reddit/user-posts.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi i post da results.items e, finché has_more è true, passa results.next_cursor per caricare la pagina successiva.
curl -X POST "https://api.socq.ai/v1/reddit/user-posts" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"username":"spez","sort_by":"new","results_limit":25}'Casi d’uso della Reddit User Posts API
- Seguire gli ultimi post di un account: Esegui periodicamente sort_by new e leggi published_at e url per intercettare ogni nuovo post di un fondatore, di un giornalista o di un concorrente.
- Classificare i post più votati di un utente: Richiedi sort_by top e confronta likes_count con comments_count per capire quali argomenti e formati di una persona hanno ottenuto la risposta più forte.
- Creare un corpus dagli scritti di un esperto: Salva il text dei post di testo con url e published_at per costruire un dataset delle spiegazioni approfondite di uno specialista.
Consigli degli esperti per la Reddit User Posts API
- Dividi text alla prima riga vuota per separare il titolo dal corpo; i post con link o media contengono solo il titolo.
- Quando controlli i nuovi post di un account con sort_by new, conserva gli id già salvati e smetti di leggere le pagine appena compare un id noto.
- Raccogli lo stesso username anche con Reddit User Comments API quando ti serve tutta l’attività dell’account, perché le sue risposte nelle discussioni altrui arrivano da lì.
API correlate
Oltre alla Reddit User Posts API, usa queste API quando ti serve un altro tipo di dati pubblici di Reddit.
- Reddit Posts API — Raccoglie testo dei post pubblici, autori, contesto della community, media, date ed engagement visibile dagli URL Reddit supportati.
- Reddit Comments API — Raccoglie testo dei commenti pubblici, autori, riferimenti al post e al commento principale, contesto della community, date ed engagement visibile dagli URL dei post supportati.
- Reddit Subreddit Posts API — Individua i post pubblici dagli URL dei subreddit con ordinamento per nuovi, migliori o popolari, un limite di risultati per subreddit e contesto normalizzato di community ed engagement.
- Reddit User Profile API — Consulta account Reddit per username con karma totale, da post e da commenti, conteggi di attività, età dell’account e flag del profilo.
- Reddit User Active Subreddits API — Elenca i subreddit in cui è attivo un utente Reddit a partire da un solo username, con numero di membri e descrizioni.
- Reddit Popular Feed API — Raccoglie i post di r/popular in ordine hot, best, new, rising o top, con titolo e testo, autore, punteggio, commenti e media.