Reddit Comments
Un commento di Reddit è una risposta pubblica all’interno della discussione di un post, con testo, identità dell’autore, riferimenti al post di origine e al commento padre, contesto della community, date e conteggi visibili di voti e risposte. Leggere insieme questi campi rende i commenti restituiti utili per analizzare le reazioni, mappare le risposte, archiviare con il collegamento alla fonte e confrontare i dati nel tempo.
Funzionalità della Reddit Comments API
- Commenti di una discussione specificaAccetta l’URL di un post di Reddit supportato o un link breve redd.it e restituisce i record dei commenti pubblici forniti per quella discussione.
- Contenuto dei commenti e autoreRestituisce ID, URL pubblico, testo e identificatori dell’autore di ogni commento disponibile come record normalizzato separato.
- Riferimenti a post e risposteEspone post_id, post_url, parent_comment_id, community_name e input_url, così i commenti restituiti possono essere collegati alla loro fonte e tra loro.
- Istantanea delle reazioni visibiliMantiene upvotes_count e replies_count insieme a created_at e collected_at per distinguere il momento della pubblicazione da quello dell’osservazione.
Parametri della Reddit Comments API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Elenco obbligatorio di URL di post pubblici di Reddit con percorsi /r/{subreddit}/comments/{post_id} su host Reddit supportati, oppure link brevi redd.it. |
Come usare la Reddit Comments API
Invia gli URL dei post pubblici di Reddit, segui l’attività asincrona e leggi i record normalizzati dei commenti con la paginazione a cursore.
- Prepara uno o più URL di post pubblici di Reddit supportati o link brevi redd.it.
- Invia i link come urls a /v1/reddit/comments e salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività riesce o restituisce un errore.
- Leggi data.results.items, poi richiedi il next_cursor restituito finché has_more resta true.
curl -X POST "https://api.socq.ai/v1/reddit/comments" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.reddit.com/r/example/comments/post_id/example_post/"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasi d’uso della Reddit Comments API
- Revisione qualitativa delle reazioni: Analizza il testo dei commenti con i campi dell’autore disponibili per individuare argomentazioni, domande e reazioni ricorrenti all’interno di discussioni selezionate.
- Mappatura delle relazioni tra risposte restituite: Usa gli ID dei commenti e parent_comment_id per collegare le risposte presenti nei record restituiti, senza dare per scontato che l’intero thread sia stato acquisito.
- Archiviazione dei commenti con il collegamento alla fonte: Conserva URL dei commenti, post_id, post_url, community_name e date, così ogni risposta salvata mantiene il contesto della sua discussione.
- Confronto delle reazioni nel tempo: Confronta upvotes_count e replies_count tra i commenti restituiti, ancorando ogni osservazione a collected_at.
Consigli degli esperti per la Reddit Comments API
- Risolvi i link redd.it e deduplica per post di origine prima di creare i batch, così la stessa discussione non viene inviata con più forme di URL.
- Non inviare results_limit: questo endpoint lo rifiuta e salva i commenti restituiti per ogni URL di post accettato.
- Usa parent_comment_id solo per collegare i record effettivamente presenti nell’insieme dei risultati, perché non garantisce la profondità completa del thread.
- Considera possibile che testo, campi dell’autore, parent_comment_id, community_name, date e metriche siano null quando la fonte pubblica li omette.
- Continua con next_cursor finché has_more è false, così non perdi i commenti di un’attività completata al confine tra le pagine dei risultati.
API correlate
Oltre alla Reddit Comments 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 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 Search API — Cerca post pubblici di Reddit per testo e intervallo di pubblicazione, restituendo contenuti, autori, contesto della community, date, media ed engagement visibile in forma normalizzata.
- Reddit Subreddit Details API
- Reddit Subreddit Search API
- 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.