Endpoint e autenticazione
Invia richieste GET con la chiave di redditlistening.com in Authorization: Bearer oppure X-API-Key. /v1/search cerca nei campi title e text. /v1/posts impone il tipo post e /v1/comments il tipo comment; queste liste non richiedono id. /v1/item richiede id e accetta soltanto quel parametro per un elemento preciso, senza i filtri generali delle ricerche di contenuti.
Le ricerche di contenuti accettano q, subreddit, author, kind, from, to, min_score, limit e page. kind può essere post o comment. from e to hanno formato YYYY-MM-DD in UTC e filtrano created_utc, il momento di creazione del contenuto. to comprende tutta la giornata finale. Non indicano il recupero o l’ingresso nell’archivio. min_score è una soglia, non un ordinamento o una valutazione del sentiment.
/v1/subreddits accetta prefix e limit per i nomi delle comunità, non page o filtri di contenuto. I suoi conteggi non sono un inventario globale esatto. /v1/status è pubblico e non addebitato. Restituisce una dichiarazione statica e conferma la risposta HTTP, senza verificare ricerca, disponibilità dei record, chiave o saldo.
Pagine, ordine e totali
Nelle ricerche di contenuti, limit e page vanno da 1 a 100. Le risposte seguono l’ordine interno _doc, non quello cronologico, di rilevanza o punteggio. Percorrere tutte le pagine consentite non dimostra un recupero esaustivo. Suddividere per date può organizzare il lavoro, ma non garantisce la presenza di tutti i testi o l’assenza di duplicati.
Interpreta il totale con la sua relazione: eq significa esatto, gte un limite inferiore e unknown l’assenza di un totale affidabile, che può essere null. Un valore sconosciuto non equivale a zero risultati. Conserva parametri e indicazioni insieme alla risposta per descrivere la selezione. Il totale della ricerca non conta tutti gli acquirenti o tutte le conversazioni sul prodotto.
I record sono piatti e il server non assembla alberi di conversazione. parent_id e link_id, quando disponibili, permettono relazioni locali senza garantire i genitori o l’intero scambio. Questi campi non sono filtri di ricerca. Le etichette su comfort e riparazione sono dati del tuo studio e vanno separate dai campi originali della risposta.
Errori e costo del recupero
HTTP 400 indica una richiesta non valida, 401 una chiave assente o non valida, 402 saldo insufficiente e 429 il limite di frequenza. Correggi la causa prima di riprovare. Le richieste rifiutate non consumano crediti; gli errori del servizio di origine restituiscono la prenotazione. Una difficoltà di interpretazione dei testi o un errore nel tuo classificatore non è un guasto del recupero.
Ogni recupero riuscito costa un credito, anche vuoto. Se il client perde la risposta dopo il successo del server, quel successo può essere stato addebitato. Un nuovo tentativo riuscito costa un altro credito. Rileggere o riclassificare una risposta salvata non chiama nuovamente l’API. Registra separatamente chiamate e analisi per spiegare spesa e risultati del lavoro.
