Scrivi il confronto prima di interrogare l’archivio
Formula un confronto concreto: come vengono richieste spiegazioni supportate da studi in AskSocialScience durante due settimane consecutive? Usa il post iniziale come unità. Decidi in anticipo se un messaggio senza domanda esplicita o senza riferimento a uno studio soddisfa il criterio. Scrivilo prima di vedere i risultati, affinché un esempio sorprendente non cambi silenziosamente la regola applicata all’altra settimana.
Annota separatamente created_utc, quando presente, e la data di recupero registrata dal programma. from e to filtrano la creazione del record in UTC, non il suo ingresso nell’archivio o il giorno di esecuzione dello script. Scrivere oggi un file locale non trasforma il contenuto in conversazioni di oggi. Se manca un campo necessario per verificare il periodo, conserva l’assenza e stabilisci come trattarla nel protocollo; non ricavare una data dalla posizione del record nella pagina dei risultati.
Assegna confini UTC a ciascuna settimana
Parti da GET https://api.redditcollector.com/v1/posts?subreddit=AskSocialScience&limit=3 e aggiungi &from=2025-03-01&to=2025-03-07 per la prima finestra illustrativa. Per la seconda usa from=2025-03-08&to=2025-03-14 e riparti da page=1. Le date definiscono un esercizio, non la copertura nota dell’archivio. Il formato è YYYY-MM-DD in UTC e il giorno to è incluso per intero. La query iniziale senza queste date non delimita un periodo. Mantieni percorso, comunità e criterio di inclusione fra le due finestre.
Prima di ampliare la raccolta, stabilisci quante pagine tenterai, chi esaminerà i casi dubbi e dove conserverai le risposte. limit e page vanno da 1 a 100 sulle route dei contenuti, con una pagina per richiesta. _doc non ordina per creazione e la prima pagina non rappresenta l’inizio o la fine del mese. Conserva insieme parametri, pagina, ora del recupero e risposta originale. Ripetere la query può produrre dati diversi; condividere una copia salvata permette di esaminare quella copia precisa, senza garantire la riproduzione della selezione remota.
Separa filtri e codici della ricerca
Esamina dapprima il vocabolario senza q e min_score. Se in seguito serve q, ricorda che cerca in title e text e richiede tutti i termini all’interno di uno di questi campi, senza ripartirli fra titolo e corpo. min_score applica solo una soglia, non ordina per qualità o data. Conserva codici di ricerca e motivi di esclusione in campi locali separati da quelli originali. L’archivio non assegna queste valutazioni.
Dichiara il punto di arresto
Nella revisione locale, distingui un post ricevuto, accettato per l’analisi o escluso secondo i tuoi criteri. Un’esclusione tematica non è un errore dell’API e non restituisce il credito consumato. min_score è soltanto una soglia numerica, non una valutazione della qualità scientifica. Leggi total con relation: eq indica il totale esatto della query, gte un limite inferiore e unknown un totale non affidabile, eventualmente null. Nessuno di questi valori dimostra che siano stati scaricati tutti i dati storici della comunità. Suddividere i mesi o eliminare duplicati non prova l’esaustività.
Consulta documentazione, prezzi e Ottieni chiave API prima di una raccolta più ampia. Ogni recupero riuscito, vuoto o ripetuto, costa un credito; $1 corrisponde a 1000 successi e la ricarica minima a pagamento è di $50. Le richieste non valide non addebitano crediti e i guasti del servizio a monte restituiscono la prenotazione. Perdere una risposta può nascondere un successo addebitato: un nuovo tentativo riuscito costa un altro credito. Fissa un limite locale di tentativi e descrivi le interruzioni nel rapporto insieme ai record ricevuti e ai limiti della selezione, senza presentare il corpus come un censimento.
Lascia una nota di metodo comprensibile
Concludi spiegando perché hai scelto quelle settimane e i post iniziali, quali filtri hai applicato e perché la raccolta si è fermata. Separa i conteggi ricevuti dai casi accettati e segnala date o contesto mancanti. La stessa durata e budget uguali non rendono rappresentative le selezioni. Una differenza di temi nei testi esaminati riguarda quel materiale; da sola non dimostra un cambiamento nell’intera comunità.
