Host, chiave e percorsi
Le richieste utilizzano api.redditsearchapi.com. Per i recuperi autenticati usa la chiave rilasciata da questo sito e conservala sul server della tua applicazione. Non inserirla in URL pubblici, repository o codice distribuito al browser. La chiave e il saldo appartengono a questo dominio e non costituiscono un accesso condiviso alle altre marche.
Usa /v1/search per combinare i filtri di ricerca. /v1/posts e /v1/comments selezionano rispettivamente pubblicazioni e commenti, senza richiedere id. Per recuperare un record tramite identificatore usa /v1/item con id. Scegli il percorso in base al compito: non tutti i percorsi accettano automaticamente l’intero insieme dei parametri di ricerca.
Il percorso /v1/subreddits supporta prefix per esplorare i nomi delle community. /v1/status è pubblico, non richiede chiave e non consuma crediti. Restituisce una dichiarazione statica sull’ambito storico del servizio e indica che l’applicazione HTTP risponde. Non verifica il motore di ricerca e non certifica disponibilità, copertura, integrità o latenza dell’archivio.
Filtri e struttura della risposta
I parametri di ricerca disponibili sono q, subreddit, author, kind, from, to, min_score, limit e page. I valori letterali di kind sono post e comment. Le date seguono YYYY-MM-DD in UTC e to è inclusivo. Traduci le etichette della tua interfaccia, mantenendo però invariati i nomi tecnici e i valori inviati.
limit accetta da 1 a 100 record per richiesta e page da 1 a 100 pagine per query. L’ordine _doc è quello documentale interno dell’archivio, non cronologico, per rilevanza o per punteggio. min_score filtra soltanto. Non è disponibile una DSL arbitraria né una funzione che garantisca un’esportazione massiva completa.
Le risposte contengono record piatti, non alberi di conversazione assemblati dal server. Quando sono presenti parent_id o link_id, puoi usarli per raggruppare localmente i record. Questi campi non sono filtri di query esposti e non assicurano che siano disponibili tutti gli antenati di una conversazione. Verifica i campi effettivi prima di costruire collegamenti nell’interfaccia.
Totali, errori e costi
La relazione eq indica un totale esatto per la query; gte un limite inferiore; unknown l’assenza di un totale affidabile, che può essere nullo. Un limite inferiore non va mostrato come conteggio esatto. Questi valori non dimostrano la completezza dell’archivio e neppure i conteggi aggregati dei subreddit sono garantiti globalmente esatti.
400 segnala una richiesta non valida, 401 una chiave mancante o non valida, 402 un saldo insufficiente e 429 il raggiungimento del limite di frequenza. Distingui le cause prima di ripetere l’operazione. Una ripetizione identica non corregge un parametro errato o una credenziale superata; limita i tentativi e registra il loro motivo.
Ogni recupero riuscito consuma un credito, anche senza risultati. Le richieste non valide non addebitano crediti; gli errori del fornitore di ricerca restituiscono la riserva. Un’interruzione sul client può verificarsi dopo un recupero riuscito e addebitato sul server. Una nuova richiesta riuscita consuma nuovamente un credito, anche se il client non ha ricevuto la prima risposta.
