Primo campione: soil in gardening
Prova 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, potenzialmente meno o nessuno. Invia Authorization: Bearer <chiave> oppure X-API-Key: <chiave> dal server. Il segnaposto non è una credenziale pubblica utilizzabile. Interroga la seconda community separatamente con gli altri criteri invariati.
Estratto JSON sintetico, non risultato reale: {"data":[],"pagination":{"page":1,"limit":3,"total":0,"relation":"eq"},"credits":{"cost":1,"balance":99}}. Il saldo è fittizio. Esamina i testi effettivamente ricevuti per contare vocaboli, distinguere significati e annotare traduzioni di soil. L’API non fornisce confronti tra community o analisi di sentiment: questi calcoli dipendono dal tuo metodo locale.
Natura dell'Archivio e Consistenza Storica
Subreddit API permette di interrogare un archivio storico indipendente, senza affiliazione ufficiale con Reddit e senza dati in tempo reale. Puoi esaminare pubblicazioni e commenti disponibili per una domanda delimitata. La provenienza storica non garantisce copertura completa, immutabilità o accesso permanente. Descrivi i risultati come una selezione osservata, senza attribuirli automaticamente a tutti i membri della community.
I risultati seguono l’ordine documentale interno _doc, non quello cronologico, di rilevanza o di punteggio. min_score imposta soltanto una soglia, senza ordinare né misurare la qualità dei testi. Un eventuale ordinamento locale riguarda gli elementi ricevuti. Non presentare il primo risultato come la discussione più recente o più rappresentativa del gruppo.
Mantieni costanti termine, tipo di contenuto e intervallo temporale nella seconda community. Conserva le risposte originali e la versione delle regole locali per ripetere conteggi o classificazioni sugli stessi file. Una nuova query remota può restituire altri record: gli stessi filtri non garantiscono risultati identici, campioni equivalenti o rappresentatività. Documenta i testi assenti e le esclusioni.
Workflow di Ricerca e Filtri Avanzati
La ricerca accetta q, subreddit, author, kind, from, to, min_score, limit e page. kind usa post o comment; le date sono YYYY-MM-DD in UTC, con to inclusivo. /v1/subreddits accetta invece prefix e limit per esplorare nomi, senza author o kind. I conteggi aggregati di community non sono garantiti come globalmente esatti.
Ogni richiesta ammette fino a 100 record e ogni query fino a 100 pagine. eq indica un totale esatto per la query, gte un limite inferiore e unknown l’assenza di un totale affidabile, eventualmente nullo. Nessuna relazione o iterazione delle pagine dimostra un recupero esaustivo o privo di duplicati. Conserva queste limitazioni insieme ai risultati della ricerca.
Ogni recupero riuscito costa un credito, anche vuoto: $1 per 1000 richieste. La ricarica minima di $50 acquista 50000 crediti, senza abbonamenti o scadenza dei crediti acquistati. Possono essere concessi 100 crediti di prova secondo i controlli contro gli abusi della rete, senza assegnazione garantita. La chiave appare alla registrazione prima di pagare; chiave e saldo appartengono a subredditapi.com.
Struttura dei Dati e Limitazioni Operative
Le risposte API contengono record piatti che non includono alberi di thread gerarchici assemblati dal server. Se i campi parent_id e link_id sono presenti, è responsabilità del client raggrupparli localmente per ricostruire le conversazioni. Questo metodo non garantisce la completezza della struttura originale del thread, ma offre flessibilità nella progettazione dell'applicazione.
400 indica parametri non validi, 401 una chiave assente o non valida, 402 crediti insufficienti e 429 un limite di frequenza. Le richieste non valide non addebitano saldo e gli errori del fornitore di ricerca restituiscono la riserva. Un’interruzione del client può seguire un successo addebitato; una ripetizione riuscita costa un altro credito. /v1/status è pubblico e non addebitato, ma non verifica la ricerca.
Per ricaricare, accedi e crea una fattura prima del trasferimento. Usa il destinatario e l’importo esatti per USDT su TRON TRC20 o USDC su Ethereum mainnet ERC20. Poi incolla l’hash della transazione e richiedi verifica. Solo un trasferimento autentico confermato aggiunge crediti, senza tempi garantiti. Una fattura univoca non implica un nuovo indirizzo destinatario.
