Definire la domanda e i criteri
Prima di disegnare il campo di ricerca, chiarisci quale domanda deve aiutare a esplorare. Chi cerca testimonianze passate su un problema deve conoscere la community e il periodo esaminati. Presenta l’archivio come storico e indipendente, evitando che il modulo sembri uno strumento di monitoraggio dell’attività attuale di Reddit.
Prepara una query di riferimento con q, subreddit e date coerenti con il tema. Esamina pochi risultati e annota le espressioni utilizzate prima di aggiungere varianti. Così potrai capire se una differenza deriva dal vocabolario o dai criteri scelti. Una corrispondenza testuale non è un’interpretazione automatica di tutti i significati possibili.
Scegli solo i controlli che riesci a spiegare chiaramente. Il tipo di record e le date possono essere sufficienti per una prima esplorazione. Se introduci min_score, illustra la soglia e quali record esclude. Il punteggio minimo non certifica qualità o rilevanza; mostra i filtri attivi anche dopo l’invio della query.
Costruire richieste e navigazione
Conserva la chiave sul server dopo averla ottenuta con la registrazione, prima di pagare. Se ricevi i crediti di prova condizionati, usali per osservare risposte reali. Valida gli input e invia le date in formato YYYY-MM-DD in UTC. Ricorda che to include il giorno finale scelto per la ricerca.
Parti da una pagina e controlla i campi effettivamente presenti nei record. Mantieni identici i filtri quando l’utente passa alla pagina successiva. Ogni richiesta ammette al massimo 100 record e ogni query fino a 100 pagine. Mostra la fine del percorso consentito senza dichiarare che siano stati recuperati tutti i record corrispondenti.
Visualizza il totale insieme al suo significato: eq è esatto per la query, gte è un limite inferiore e unknown non fornisce un totale affidabile. Non usare un limite inferiore come denominatore esatto di una barra di avanzamento. L’ordine documentale dell’archivio non consente inoltre di etichettare la prima pagina come elenco dei risultati più recenti.
Verificare errori, contesto e budget
Prevedi messaggi diversi per una risposta vuota riuscita e una richiesta fallita. La prima consuma un credito e riguarda soltanto i filtri usati. Per 400 controlla i parametri, per 401 la chiave, per 402 il saldo e per 429 riduci la frequenza. Limita le ripetizioni invece di trattare ogni problema come un’interruzione temporanea.
Per una vista di conversazione puoi raggruppare localmente i record quando includono parent_id e link_id. Indica i collegamenti mancanti: il server restituisce record piatti e non garantisce un albero completo. Anche la divisione della ricerca in intervalli resta una scelta organizzativa, non una prova di estrazione esaustiva o di assenza di duplicati.
Prima di pubblicare la funzione, prova filtri troppo restrittivi, totali sconosciuti, ultima pagina e interruzioni di connessione. Conta nel budget tutti i recuperi riusciti, anche vuoti o ripetuti. Conserva criteri e data di esecuzione per spiegare il campione al gruppo di lavoro, senza promettere che i dati rimarranno disponibili o identici in futuro.
