Definizione delle Finestre Temporali per Dati Storici
Reddit Posts API interroga un archivio storico indipendente, senza affiliazione ufficiale con Reddit e senza dati in tempo reale. Non sono garantiti copertura completa, immutabilità o accesso permanente. Esamina un campione prima di progettare un’analisi delle pubblicazioni sull’attrezzatura fotografica. Un record presente non dimostra la copertura di tutto un periodo o lo stato attuale della sua pagina originale.
Prova GET https://api.redditpostsapi.com/v1/posts?subreddit=photography&min_score=10&limit=3. subreddit sceglie la community, min_score imposta una soglia e limit richiede fino a tre pubblicazioni. Non ordina per popolarità né seleziona automaticamente fotocamere o obiettivi. Leggi i testi e registra criteri di inclusione, esclusioni e casi ambigui. Una risposta riuscita vuota costa comunque un credito.
from e to sono YYYY-MM-DD in UTC, con to inclusivo per l’intero giorno finale. I parametri non accettano orari intragiornalieri. Se la tua domanda parte da date locali, documenta la corrispondenza con giorni UTC senza presentarla come un filtro nativo per l’orario locale dell’autore. Un confine di data definisce condizioni di selezione, senza dimostrare copertura completa.
Filtri Avanzati e Semantica delle Query
Per intervalli consecutivi, il from successivo può essere il giorno dopo il precedente to. Ripetere la stessa data alle due estremità crea una sovrapposizione perché to è inclusivo. Registra le sovrapposizioni desiderate e l’ora di esecuzione delle query. Questa organizzazione non prova assenza di duplicati, lacune o cambiamenti tra le risposte ottenute in momenti diversi.
kind distingue post da comment, non testi lunghi da testi brevi. Solo /v1/item richiede id per un elemento noto. La ricerca accetta q, subreddit, author, kind, from, to, min_score, limit e page. min_score non misura qualità o rilevanza e può cambiare la composizione della selezione. Tieni separate le parole ricevute dalle tue etichette interpretative.
L’ordine _doc è documentale interno, non un ordinamento per identificatore, cronologia, rilevanza o punteggio. Una finestra temporale non modifica l’ordine di recupero. Se serve una linea temporale, ordina localmente usando i campi disponibili e segnala i valori mancanti, senza affermare di aver ricostruito tutta la sequenza. I campi parent_id e link_id permettono raggruppamento condizionale, senza conversazione completa garantita.
Limiti di Paginazione e Coerenza dei Dati
Sono ammessi fino a 100 record per richiesta e 100 pagine per query. eq indica un totale esatto, gte un limite inferiore e unknown l’assenza di totale affidabile, eventualmente nullo. Né un totale esatto né l’ultima pagina consentita dimostra il recupero di tutti i record. Conserva risposte originali, filtri, data e versione dell’analisi prima di avanzare il checkpoint; questo non congela l’archivio.
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 limite di frequenza. Le richieste non valide non addebitano saldo e gli errori del fornitore restituiscono la riserva. Un’interruzione del client può seguire un successo addebitato e ogni ripetizione riuscita costa un altro credito.
Consulta Documentazione per i filtri, Prezzi per calcolare le pagine e Ottieni una chiave API per gestire l’account. /v1/status è pubblico e gratuito, ma la sua dichiarazione statica e risposta HTTP non verificano ricerca o disponibilità di record. Ripetere l’elaborazione su file conservati permette di controllare il tuo metodo, senza garantire risposte future identiche o una raccolta esaustiva.
