RedditGuida alle APIPostCommenti

Guida alle API di Reddit: come accedere a post, commenti e dati di ricerca nel 2026

Guida pratica 2026 all’accesso alle API di Reddit: OAuth, limiti di frequenza, regole per l’uso commerciale e raccolta di post e commenti pubblici con gli endpoint normalizzati di SocQ.

SocQAggiornato il 9 novembre 202612 min di lettura

Il modo giusto di integrare Reddit dipende da ciò che il tuo prodotto fa davvero. Un bot di moderazione installato in una community, un client OAuth non commerciale, uno studio accademico e un prodotto commerciale di social listening non hanno lo stesso percorso di accesso né le stesse responsabilità.

Questa guida spiega le opzioni ufficiali attuali di Reddit e mostra come recuperare post pubblici, commenti, feed dei subreddit, metadati dei subreddit e risultati di ricerca tramite SocQ, quando la tua applicazione ha bisogno di un endpoint di dati gestito e in sola lettura.

Risposta rapida: usa la Developer Platform ufficiale di Reddit per le app che girano su Reddit e richiedi la Data API ufficiale quando il tuo caso d’uso rientra nelle sue policy. Usa SocQ quando ti serve una sola chiave API e record pubblici di Reddit normalizzati insieme a quelli di altre piattaforme social. Nessuna delle due strade autorizza a ignorare i termini di Reddit, gli obblighi sui contenuti eliminati, i diritti alla privacy o le restrizioni sull’addestramento di modelli.

Requisiti di accesso e policy sono stati verificati il 19 luglio 2026. Reddit può cambiare le regole di approvazione e i limiti, quindi controlla la documentazione ufficiale collegata prima del lancio.

Quale API di Reddit scegliere

Reddit descrive oggi diverse interfacce per sviluppatori distinte:

ProdottoPensato perLimite importante
Developer Platform (Devvit)Giochi, utility e app di moderazione che girano su RedditL’app è costruita per l’esperienza su Reddit
Data APIAccesso programmatico approvato per leggere o modificare i dati di RedditSi applicano OAuth, revisione, policy e limiti di frequenza
Reddit for ResearchersRicerca accademica idoneaPercorso ufficiale per la ricerca; serve una richiesta
Ads APIInserzionisti che gestiscono campagne e reportFlussi di lavoro pubblicitari, non dati generali delle community
Reddit EmbedsVisualizzazione di singoli contenuti di RedditPresentazione, non accesso massivo ai dati
API gestita per dati pubbliciFlussi di lavoro di prodotto che richiedono record pubblici in uno schema stabileRestano validi copertura e termini del provider

La panoramica di Reddit sull’accesso per sviluppatori indica che la Data API è destinata agli sviluppatori approvati e che la ricerca accademica deve passare da Reddit for Researchers. L’uso commerciale richiede il permesso di Reddit e un contratto.

Questo significa che la scelta dell’API deve partire dalla classificazione del caso d’uso, non da una libreria di codice.

Requisiti della Data API ufficiale di Reddit nel 2026

Per l’uso gratuito idoneo della Data API, Reddit richiede attualmente un token OAuth registrato e uno User-Agent descrittivo. Il traffico non autenticato può essere bloccato invece di ricevere la quota standard.

La Reddit Data API Wiki ufficiale indica un limite di 100 query al minuto per ID client OAuth, calcolato come media su una finestra di dieci minuti. I client dovrebbero leggere:

  • X-Ratelimit-Used
  • X-Ratelimit-Remaining
  • X-Ratelimit-Reset

Non considerare 100 QPM come un livello commerciale universale: è il limite pubblicato per chi ha diritto all’accesso gratuito. Reddit afferma che l’uso commerciale – inclusi prodotti a pagamento, prodotti finanziati dalla pubblicità, servizi in abbonamento e servizi venduti a pagamento – richiede un permesso preventivo. Gli accessi più ampi o a pagamento sono gestiti separatamente, senza un listino prezzi pubblico in self-service.

Reddit richiede anche la gestione delle eliminazioni. Le linee guida attuali stabiliscono che i contenuti archiviati e poi eliminati da Reddit devono essere eliminati anche dai tuoi sistemi, e che le informazioni che identificano l’autore associate a un account eliminato devono essere rimosse. La documentazione consiglia di eliminare periodicamente i dati e i contenuti utente archiviati entro 48 ore, per semplificare la conformità.

Esempio di autenticazione con l’API ufficiale

Un’applicazione installata o di tipo script di solito scambia le proprie credenziali client e l’autorizzazione dell’utente con un token OAuth, poi invia quel token a oauth.reddit.com.

La forma semplificata della richiesta è questa:

curl "https://oauth.reddit.com/r/learnpython/new?limit=25" \
  -H "Authorization: Bearer $REDDIT_ACCESS_TOKEN" \
  -H "User-Agent: web:socq-guide:v1.0 (by /u/your_username)"

I client in produzione devono:

  1. Registrarsi e ottenere l’approvazione per il caso d’uso corretto.
  2. Implementare il grant OAuth appropriato.
  3. aggiornare i token in scadenza dove supportato.
  4. Inviare uno User-Agent veritiero e univoco.
  5. Rispettare gli header dei limiti di frequenza e rallentare prima di esaurire la quota.
  6. Gestire le rimozioni e le modifiche alle policy.

Chi sviluppa in Python spesso usa PRAW per gestire gli oggetti listing, la paginazione e i dettagli di OAuth. Le chiamate HTTP dirette possono essere adatte quando vuoi meno dipendenze, ma non eliminano alcun obbligo previsto dalle policy.

Recuperare un post di Reddit tramite URL con SocQ

Reddit Posts API di SocQ accetta URL di post pubblici di Reddit e link brevi redd.it. Restituisce titolo, corpo, autore, contesto della community, timestamp, riferimenti ai media pubblici e engagement visibile, tutto normalizzato.

curl -X POST "https://api.socq.ai/v1/reddit/posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/comments/POST_ID/POST_SLUG/"
    ]
  }'

La richiesta crea un’attività asincrona. Salva il task_id restituito, poi interroga lo stato:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=100" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Quando l’attività ha successo, i record si trovano in data.results.items. Continua con next_cursor finché has_more è true.

Un record di post ha la stessa struttura generale delle altre risorse di SocQ:

{
  "id": "post_id",
  "platform": "reddit",
  "resource": "posts",
  "type": "post",
  "url": "https://www.reddit.com/r/learnpython/comments/post_id/example/",
  "name": "Example post title",
  "text": "Example post body",
  "author": {
    "username": "example_user",
    "name": "example_user"
  },
  "metrics": {
    "upvotes_count": 842,
    "comments_count": 54,
    "upvote_ratio": 0.96
  },
  "created_at": "2026-07-16T08:00:00Z",
  "collected_at": "2026-07-19T08:00:00Z",
  "extra": {
    "tag": "Discussion",
    "community_name": "learnpython"
  }
}

I punteggi visibili sono istantanee, non una verità definitiva. Reddit può alterare i conteggi dei voti, i contenuti possono essere modificati o rimossi e una raccolta successiva può dare risultati diversi.

Recuperare i commenti di Reddit

Usa Reddit Comments API quando ti serve la discussione pubblica sotto URL di post noti:

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/learnpython/comments/POST_ID/POST_SLUG/"
    ]
  }'

I record normalizzati dei commenti includono:

  • ID, URL e testo del commento.
  • Campi pubblici dell’autore, quando disponibili.
  • Conteggi visibili di upvote e risposte.
  • Riferimenti al post di origine e alla community.
  • ID del commento padre, quando disponibile.
  • Timestamp di pubblicazione e di raccolta.

L’endpoint SocQ attuale non accetta l’input results_limit. Non dare per scontato che vengano restituiti tutti i rami visibili, le risposte compresse, i commenti eliminati, gli elementi riservati ai moderatori o i risultati con classifica dinamica. Se la ricostruzione completa del thread è un requisito imprescindibile, prima di scegliere un provider metti alla prova thread rappresentativi, profondi e molto grandi.

Recuperare i post nuovi, top o hot di un subreddit

Per il monitoraggio delle community, Reddit Subreddit Posts API accetta uno o più URL di subreddit pubblici. sort_by supporta new, top e hot; results_limit accetta da 1 a 2.000 per ogni subreddit inviato.

curl -X POST "https://api.socq.ai/v1/reddit/subreddit-posts" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "urls": [
      "https://www.reddit.com/r/learnpython/",
      "https://www.reddit.com/r/webdev/"
    ],
    "sort_by": "new",
    "results_limit": 250
  }'

Scegli l’ordinamento in modo consapevole:

OrdinamentoUso miglioreLimite
newMonitoraggio incrementale e avvisiInclude più post di scarso valore informativo
hotAttenzione attuale della communityLa classifica cambia di continuo
topScoperta di contenuti ad alto engagementPuò sovrarappresentare contenuti più vecchi o già popolari

Per il monitoraggio, raccogli new a intervalli programmati e deduplica per ID del post. Usa hot o top come vista di scoperta separata, senza sovrascrivere il feed cronologico.

Cercare post di Reddit per parola chiave

Reddit Search API accetta una query, un limite di risultati da 1 a 2.000 e una finestra di pubblicazione:

curl -X POST "https://api.socq.ai/v1/reddit/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "\"social listening\" API",
    "results_limit": 500,
    "published_within": "month"
  }'

Le finestre supportate sono hour, day, week, month, year e all.

I risultati di ricerca sono risultati di scoperta ordinati per rilevanza, non un archivio esaustivo garantito. Sintassi della query, ranking, disponibilità e indicizzazione possono influire sulla copertura. Esegui più query mirate invece di aspettarti che una sola query ampia rappresenti l’intera conversazione.

Per il monitoraggio del brand, per esempio, usa un insieme di query:

"Acme Cloud"
acmecloud
"Acme API"
"Acme Cloud" pricing
"Acme Cloud" alternative

Salva la query nel contesto di scoperta, così chi analizza i dati può spiegare perché ogni record è entrato nel dataset.

Dettagli del subreddit e ricerca all’interno di un subreddit

Altri due endpoint riguardano la community in sé. Reddit Subreddit Details API riceve URL di subreddit pubblici e restituisce metadati come numero di iscritti, utenti attivi settimanali, regole e asset della community. È un modo economico per valutare una community prima di monitorarla.

Reddit Subreddit Search API cerca discussioni e post pubblici all’interno di uno specifico subreddit, per query, intervallo di tempo e ordinamento. Usala quando un termine del brand è rilevante solo in poche community e una ricerca su tutto Reddit lo sommergerebbe. Controlla la pagina di ciascun endpoint per i campi di input esatti.

Costruire una pipeline di monitoraggio di Reddit affidabile

Un flusso di lavoro duraturo separa raccolta, archiviazione e analisi:

Query/subreddit registry
        ↓
Scheduled SocQ submissions
        ↓
Task polling with backoff
        ↓
Normalize + deduplicate by Reddit ID
        ↓
Deletion/retention controls
        ↓
Classification, alerts and reporting

Regole di implementazione consigliate:

  1. Usa ID stabili. URL e slug possono cambiare; gli ID di Reddit sono chiavi di deduplicazione migliori.
  2. Conserva il contesto di origine. Salva subreddit, query, ordinamento e momento della raccolta.
  3. Separa le istantanee dalle entità. Le metriche cambiano, mentre l’ID del post resta stabile.
  4. Riprova le attività, non i singoli record. Il backoff esponenziale evita invii duplicati.
  5. Registra gli stati mancante ed eliminato. Non trasformare un’assenza in un post vuoto ma valido.
  6. Riduci al minimo i dati personali. La maggior parte delle analisi non richiede cronologie a lungo termine a livello di autore.
  7. Prevedi un percorso di cancellazione. Il tuo modello dati deve poter rimuovere contenuti e riferimenti agli autori.

API ufficiale di Reddit e SocQ a confronto

RequisitoAPI ufficiale di RedditSocQ
Creare un’app o uno strumento per moderatori su RedditSoluzione più adattaNon supportato
Azioni di lettura e scrittura su RedditSupportate, previa approvazione e scopeDati pubblici in sola lettura
OAuth e registrazione dell’app su RedditRichiestiChiave API di SocQ
Normalizzazione di post e commenti pubbliciOggetti nativi di RedditSchema condiviso di SocQ
Prodotto social multipiattaformaIntegrazioni separateStesso modello di attività su 27 piattaforme
Limite di frequenza gratuito pubblicato100 QPM per i client OAuth idoneiPrezzi degli endpoint nel catalogo SocQ
Permesso commercialePermesso o contratto da ottenere da RedditL’accesso tramite provider non annulla le regole di Reddit
Ricerca accademicaRichiesto Reddit for ResearchersNon usarlo per aggirare le policy

Scegli la strada ufficiale se il tuo prodotto esegue azioni autorizzate dall’utente, moderazione, pubblicazione, voti, messaggistica o integrazioni profonde native di Reddit. Scegli SocQ per la raccolta di dati pubblici supportati, quando contano di più i record normalizzati multipiattaforma e l’estrazione gestita rispetto all’accesso in scrittura.

Stimare carico di lavoro e costi

Non confrontare i provider solo in base alle “richieste”. Una richiesta può restituire un post, una pagina di commenti o centinaia di risultati di un subreddit.

Stima:

monthly records =
  direct post lookups
  + comments returned
  + subreddit posts returned
  + search results returned

monthly workload =
  schedules × inputs per run × average records per input

Poi tieni conto di:

  • Risultati vuoti o non disponibili.
  • Frequenza di aggiornamento.
  • Sovrapposizione tra ricerche e deduplicazione.
  • Thread di commenti profondi.
  • Archiviazione ed elaborazione delle eliminazioni.
  • Requisiti di concorrenza e di latenza.
  • Se vengono fatturati solo i risultati andati a buon fine.

Esegui un pilota rappresentativo su community piccole e grandi prima di proiettare la spesa annuale.

Uso responsabile e conservazione dei dati

La disponibilità pubblica non è un permesso generale per qualsiasi uso. Le policy attuali di Reddit limitano l’accesso commerciale senza approvazione e vietano di usare i contenuti di Reddit per addestrare modelli senza consenso esplicito. Impongono inoltre obblighi di eliminazione.

Predisponi questi controlli prima di scalare:

  • Raccogli solo i campi necessari allo scopo dichiarato.
  • Evita la profilazione di persone sensibili e le molestie nei confronti di singoli.
  • Non usare l’API per aggirare le restrizioni di subreddit o account.
  • Mantieni l’attribuzione della fonte dove il contenuto viene mostrato.
  • Imposta periodi di conservazione brevi per i contenuti grezzi.
  • Ricontrolla o rimuovi i contenuti non più disponibili.
  • Proteggi le chiavi API e verifica gli accessi alle esportazioni.
  • Richiedi una revisione legale per usi commerciali, di ricerca o ad alto rischio.

SocQ è un livello di accesso tecnico, non una concessione di diritti di proprietà intellettuale, privacy, ricerca o uso commerciale.

Domande frequenti (FAQ)

L’API di Reddit è gratuita?

Reddit offre accesso gratuito e a pagamento a seconda del caso d’uso. I client idonei della Data API gratuita hanno attualmente un limite pubblicato di 100 QPM per ID client OAuth. L’uso commerciale richiede il permesso di Reddit e può richiedere un contratto e dei costi.

Posso usare l’API di Reddit senza OAuth?

Non progettare la tua soluzione contando sull’accesso non autenticato. La documentazione attuale di Reddit richiede token OAuth registrati e indica che il traffico senza credenziali OAuth o di accesso verrà bloccato.

Posso fare scraping di Reddit per addestrare l’AI?

Reddit afferma che i suoi contenuti non possono essere usati come input per l’addestramento di modelli senza consenso esplicito. Un’API di terze parti non elimina questa restrizione.

SocQ supporta i commenti di Reddit?

Sì. SocQ ha sei endpoint per Reddit: post diretti, commenti da URL di post, scoperta dei post di un subreddit, dettagli del subreddit, ricerca per parola chiave su tutto Reddit e ricerca all’interno di un singolo subreddit.

SocQ può pubblicare, votare o moderare su Reddit?

No. Gli endpoint SocQ per Reddit raccolgono record pubblici supportati. Per azioni di scrittura autorizzate e per la moderazione usa i prodotti ufficiali per sviluppatori di Reddit.

I risultati di ricerca di Reddit sono esaustivi?

No. Considera la ricerca come una scoperta ordinata per rilevanza. I risultati dipendono da query, intervallo di tempo, indicizzazione e disponibilità; non sono un archivio storico completo.

Cosa succede quando un utente di Reddit elimina un contenuto?

Il tuo sistema deve poter rimuovere il contenuto e le informazioni correlate che identificano l’autore. Le linee guida ufficiali di Reddit consigliano di eliminare periodicamente i dati e i contenuti utente archiviati entro 48 ore, per semplificare la conformità.

REDDIT API

Prova il flusso di lavoro con un URL pubblico di Reddit

Invia input pubblici e ricevi record normalizzati con un contesto di origine tracciabile.

Scopri le API di Reddit