Reddit User Profile
Il profilo di un utente Reddit è la pagina pubblica dell’account dietro un nome u/ e mostra il karma totale diviso tra post e commenti, quanti post e commenti ha scritto, la data di creazione, la descrizione, l’avatar, i trofei e i badge degli account verificati e dei dipendenti di Reddit. Insieme, questi segnali dicono quanto un account è consolidato e attivo, e servono a valutare i creator, filtrare account nuovi o con poco karma e seguire nel tempo i membri influenti di una nicchia.
Funzionalità della Reddit User Profile API
- Fino a 100 username per richiestausernames accetta fino a 100 nomi Reddit con o senza il prefisso u/, e ogni account esistente torna come riga a sé.
- Karma diviso per originemetrics.karma_count riporta il karma totale, mentre post_karma_count e comment_karma_count indicano se è stato guadagnato pubblicando post o commentando.
- Conteggi di attività ed età dell’accountposts_count e comments_count misurano quanto l’account ha contribuito, e published_at registra il momento della sua creazione.
- Badge e trofei del profilois_verified, is_employee e is_nsfw riportano i flag che Reddit assegna all’account e trophies_count conta i trofei, accanto a nome visualizzato, descrizione, avatar e banner.
Parametri della Reddit User Profile API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
usernames | Obbligatorio | Fino a 100 username di Reddit, con o senza il prefisso u/; ogni nome ha da 3 a 20 caratteri tra lettere, cifre, trattini e trattini bassi. |
Come usare la Reddit User Profile API
Invia un elenco di username di Reddit e leggi una riga di profilo per ogni account esistente.
- Invia con POST {"usernames": ["spez", "GovSchwarzenegger"]} a /v1/reddit/user-profile.
- Interroga GET /v1/tasks/{task_id} finché status non diventa succeeded.
- Leggi i profili da results.items e continua a richiedere con results.next_cursor finché has_more è true.
curl -X POST "https://api.socq.ai/v1/reddit/user-profile" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"usernames":["spez","GovSchwarzenegger"]}'Casi d’uso della Reddit User Profile API
- Valutare un creator prima di contattarlo: Controlla karma_count, posts_count e published_at per verificare che l’utente Reddit che vuoi contattare abbia una storia lunga e attiva.
- Filtrare account nuovi o con poco karma: Segnala gli username con un published_at recente e un karma_count basso quando esamini gli autori di un’ondata di post o commenti simili.
- Monitorare una lista di account di nicchia: Rilancia periodicamente gli stessi username e confronta karma_count, posts_count e followers_count per vedere quali membri stanno crescendo.
- Arricchire un elenco di nomi Reddit: Aggiungi nome visualizzato, descrizione, avatar_url e url del profilo agli username raccolti nelle discussioni, così un foglio di calcolo o un CRM mostra chi è ogni persona.
Consigli degli esperti per la Reddit User Profile API
- Ripulisci i nomi prima dell’invio: dopo il prefisso u/ ognuno deve avere da 3 a 20 caratteri tra lettere, cifre, trattini e trattini bassi, e una sola voce non valida fa rifiutare l’intera richiesta.
- Abbina le righe al tuo input con lo username in minuscolo, perché un nome inviato due volte con maiuscole diverse viene cercato una volta sola e restituisce una sola riga.
- Dividi gli elenchi con più di 100 nomi in blocchi da 100 e unisci i risultati su id, l’identificatore permanente dell’account su Reddit.
API correlate
Oltre alla Reddit User Profile 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 Subreddit Details API
- Reddit User Posts API — Raccoglie la cronologia dei post di un utente Reddit da un solo username, ordinata per new, top o hot, con titolo e testo, punteggio, commenti e media.
- Reddit User Comments API — Raccoglie la cronologia dei commenti di un utente Reddit da un solo username, con estratti di 300 caratteri, punteggi, link ai commenti e ID dei post.
- 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 Subreddit Rules API — Recupera le regole numerate dei subreddit dai loro URL, con titolo breve e testo completo di ogni regola.