Comprensione dell'Archivio Indipendente
Subreddit API interroga un archivio storico indipendente, senza affiliazione ufficiale con Reddit e senza dati in tempo reale. Questo non garantisce copertura completa, immutabilità o accesso permanente. Definisci la domanda che i testi disponibili possono aiutare a esplorare. Una selezione non descrive necessariamente gli attuali membri, i lettori silenziosi o tutte le discussioni della community.
Conserva risposte originali, parametri, data di esecuzione e versione delle regole locali. Puoi ripetere una trasformazione sugli stessi file per rivedere conteggi o classificazioni. Una nuova query con gli stessi filtri può restituire altri record; un checkpoint non congela le pagine. La conservazione locale documenta ciò che hai ricevuto, senza provare una raccolta esaustiva o priva di duplicati.
Comincia da GET https://api.subredditapi.com/v1/search?q=soil&subreddit=gardening&limit=3. q=soil cerca il termine, subreddit=gardening seleziona la community e limit=3 richiede al massimo tre record, forse meno o nessuno. Per confrontare un’altra community fai una query separata con gli altri criteri invariati. Il servizio recupera record; il confronto e la sua interpretazione sono compiti del ricercatore.
Metodologia di Confronto tra Comunità
Esamina i testi recuperati prima di contare vocaboli. soil può avere significati diversi e non include automaticamente tutte le traduzioni o i sinonimi. Documenta quali testi parlano del suolo di coltivazione e quali escludi. Un testo mancante non equivale a un’assenza di vocabolario. Parametri identici non rendono automaticamente due campioni equivalenti, casuali o rappresentativi dei rispettivi gruppi.
Mantieni uguali kind, from e to. kind usa post o comment; le date sono YYYY-MM-DD in UTC, con to inclusivo. Se combini pubblicazioni e commenti, chiarisci la tua unità di conteggio. Conserva le regole di inclusione insieme ai risultati, evitando di attribuire una differenza osservata all’intera community o a un cambiamento causato da un evento specifico.
min_score applica una soglia numerica, senza ordinare o misurare oggettivamente la qualità delle discussioni. Il taglio può cambiare la composizione dei due campioni. Se lo usi, registra il valore e considera il possibile bias. Conteggi di parole e classificazioni di tono sono metodi locali; l’API non fornisce analisi di sentiment né un indice di consenso della community.
Best Practices e Gestione dei Limiti
Esplora nomi con /v1/subreddits?prefix=gar, senza trattare le aggregazioni come conteggi globali esatti. Per il contenuto usa poi /v1/search con q, subreddit, author, kind e altri filtri di ricerca. author e kind non appartengono a /v1/subreddits. Se vuoi un indice alfabetico, ordina i nomi ricevuti localmente. Raggruppa parent_id o link_id quando presenti, senza garantire una conversazione completa.
Rispetta fino a 100 record per richiesta e 100 pagine per query. L’ordine _doc non è cronologico, di rilevanza o di punteggio. eq indica un totale esatto, gte un limite inferiore e unknown l’assenza di totale affidabile, eventualmente nullo. Nessuna relazione, suddivisione per date o iterazione delle pagine dimostra un recupero esaustivo, rappresentativo o senza duplicati.
Invia Authorization: Bearer <chiave> oppure X-API-Key: <chiave> dal server. 400 indica parametri non validi, 401 una chiave assente o non valida, 402 saldo insufficiente e 429 un limite di frequenza. Le richieste non valide non addebitano saldo; gli errori del fornitore restituiscono la riserva. Un’interruzione del client può seguire un successo addebitato; una ripetizione riuscita costa un altro credito.
Documentare selezione e interpretazione
Consulta Documentazione per i filtri, Prezzi per contare le pagine e Ottieni una chiave API per gestire l’accesso. /v1/status è pubblico e non addebitato, ma la sua dichiarazione statica e risposta HTTP non verificano il motore di ricerca. Presenta separatamente esempi testuali, conteggi locali e conclusioni interpretative. Una frequenza osservata non dimostra da sola la prevalenza di un’opinione tra tutti gli utenti.
