Seleziona i record
Interroga /v1/search con q=search e subreddit=SideProject; inizia con limit=3.
Dati storici Reddit · API JSON
Aggiungi la ricerca Reddit alla tua applicazione
Usa i dati Reddit archiviati per aggiungere la ricerca di discussioni a un’app web o mobile. Questo esempio richiede una pagina con un massimo di tre record.
GETJSONHTTPS
Anatomia della richiesta
/v1/searchSideProject01Ogni richiesta riuscita costa un credito, anche con un risultato vuoto.
100Pagine e limiti
$1 / 1,000Fatturazione per richiesta
01 / Reddit App API
Reddit App API — Dalla query ai dati utili
Inizia con una selezione piccola. Conserva i campi e i parametri necessari al passaggio successivo, poi elabora il risultato nella tua applicazione.
Prepara la risposta
Conserva la chiave API nel backend; invia al browser o all’app mobile solo i dati selezionati.
Usala nel progetto
Conserva il permalink disponibile con gli appunti come riferimento: la pagina collegata potrebbe non essere più accessibile.
Una richiesta da adattare
curl --get --fail-with-body 'https://api.redditapp.com/v1/search' \
-H "Authorization: Bearer ${REDDIT_API_KEY}" \
--data-urlencode 'q=search' \
--data-urlencode 'subreddit=SideProject' \
--data-urlencode 'limit=3' \
--data-urlencode 'page=1'Questo esempio richiede una pagina con un massimo di tre record.
URL di base dell’API
https://api.redditapp.com/v1Controlla l’ambito di ogni richiesta
Testo e community
Combina q con subreddit o author per restringere la selezione.
Date in UTC
Usa from e to nel formato YYYY-MM-DD. La data finale comprende l’intera giornata UTC.
Pagine e limiti
Imposta limit e page e conserva i metadati di paginazione con i risultati.
Pagamento per richiesta riuscita
Ogni richiesta riuscita costa un credito, anche con un risultato vuoto.
$1 ogni 1.000 richieste riuscite
Ricarica minima: $50 · 50.000 crediti
FAQ / 08
Prima dell’integrazione
Che cos’è Reddit App API?
Reddit App API è un’API JSON indipendente per i record storici di Reddit. Offre rotte di lettura per ricerche, post, commenti, singoli elementi e individuazione di subreddit. Reddit non gestisce questo servizio e non è affiliato a esso. Usa i dati Reddit archiviati per aggiungere la ricerca di discussioni a un’app web o mobile. Questo esempio richiede una pagina con un massimo di tre record.
Come ottengo una chiave API?
Crea un account con email e password su questo sito. La chiave appare dopo la registrazione, prima che sia richiesto un pagamento; conservala al sicuro perché viene mostrata una sola volta. Inviala dal server tramite X-API-Key o Authorization: Bearer. Rigenerarla invalida la chiave precedente.
Quanto costa Reddit App API?
Il prezzo è $1 per 1.000 richieste riuscite. La ricarica minima è $50 per 50.000 crediti. Ogni richiesta riuscita consuma un credito, anche senza corrispondenze. Le richieste non valide non sono addebitate; i guasti della fonte attivano un rimborso che può richiedere riconciliazione. Un timeout da solo non determina l’addebito finale.
Quali filtri posso usare per cercare record Reddit?
Usa q per la ricerca testuale analizzata con subreddit, author, kind, from, to o min_score. Le parole sono combinate con AND: non è ricerca semantica né un DSL arbitrario. Le date seguono YYYY-MM-DD in UTC e to comprende l’intero giorno finale. Inizia dai parametri documentati nel riferimento.
Il servizio Reddit App API offre accesso a Reddit in tempo reale?
No. Il servizio legge un archivio storico, non il feed live di Reddit. Non pubblica post, vota, invia messaggi privati o esegue azioni Reddit OAuth. La rotta pubblica /v1/status descrive l’ambito del servizio: non dimostra lo stato dell’archivio, la copertura completa o la disponibilità attuale di una pagina originale.
Posso esportare tutti i record corrispondenti?
Non necessariamente. Una richiesta restituisce fino a 100 record e page va da 1 a 100. Leggi total con pagination.relation: esatto, limite inferiore o sconosciuto. L’ordine è quello dell’archivio, senza garanzia cronologica o di rilevanza. Raggiungere l’ultima pagina accessibile non dimostra che il campione salvato sia esaustivo.
Posso riutilizzare la stessa chiave su un altro dominio?
No. Account, chiavi API e saldi sono separati per sito. Usa la chiave emessa per questo dominio con il suo host API HTTPS. Conservala nella configurazione server, non in JavaScript del browser, repository pubblici o log condivisi. La chiave di un altro sito non sostituisce un account locale.
Quale richiesta dovrei provare per prima?
Inizia con /v1/search, q=search, subreddit=SideProject, limit=3 e page=1. Questa piccola richiesta permette di controllare i campi prima di sviluppare importazioni o interfacce. Se riesce costa un credito, anche con risultato vuoto. Adatta argomento e community al tuo lavoro: l’esempio non promette un numero fisso di record.
API / Reddit App API
Ottieni chiave API Crea la prima richiesta
Crea un account, salva la chiave e adatta l’esempio al tuo lavoro.
Continua con una guida
Aggiungi una tappa di lettura alla pianificazione dell’escursioneNon affidare a una lista vuota la spiegazione di ogni esitoAll’escursionista serve una ricerca, non la tua chiave d’archivioMostra altro deve significare una sola pagina successiva intenzionaleCalcola ciò che l’app richiede, non ciò che il lettore vedeUna data deve spiegare la prova, non decorare la schedaOgni scheda deve spiegare il record effettivamente ricevutoSalvare un riferimento senza promettere che resterà sempre disponibileSviluppare la funzioneGuide
