q, subreddit, author, kind, from, to, min_score, limit, page
GET
/v1/posts
q, subreddit, author, kind, from, to, min_score, limit, page
GET
/v1/comments
q, subreddit, author, kind, from, to, min_score, limit, page
GET
/v1/item
id
GET
/v1/subreddits
prefix, limit
GET
/v1/status
—
Parametri di ricerca
Parametro
Valore / tipo / intervallo
q
text
subreddit
keyword
author
keyword
kind
post | comment
from
ISO date
to
ISO date
min_score
integer
limit
1–100
page
1–100
id
item ID
prefix
subreddit prefix
Autenticazione e percorsi distinti
I recuperi usano GET su https://api.redditscraping.com con X-API-Key: <chiave> oppure Authorization: Bearer <chiave>. Entrambi gli header sono validi. Conserva il segreto sul tuo server. La sessione Secure HttpOnly del pannello account è separata e non sostituisce l’header di recupero. Il servizio consulta un archivio storico; non riceve istruzioni per raccogliere pagine attuali o aggirare restrizioni di accesso di altri siti.
/v1/search cerca pubblicazioni e commenti; /v1/posts limita i risultati alle pubblicazioni e /v1/comments ai commenti. Questi percorsi accettano q, subreddit, author, kind, from, to, min_score, limit e page, senza filtro id. kind usa i valori letterali post e comment. q esegue una ricerca testuale, non un linguaggio arbitrario di query né una classificazione del sentiment.
/v1/item?id=... richiede id e cerca un record individuale, senza altri filtri o recupero ricorsivo. /v1/subreddits accetta solo prefix e limit per scoprire comunità; i conteggi non sono un censimento globale esatto garantito. /v1/status è pubblico e gratuito. La sua dichiarazione statica conferma soltanto che l’applicazione HTTP risponde, senza verificare il motore di ricerca o la disponibilità dei record.
Date, campi e struttura della risposta
from e to usano YYYY-MM-DD in UTC e si applicano a created_utc. Il giorno to è incluso per intero. I parametri non ricevono ore o secondi e non selezionano il momento di ingresso nell’archivio. min_score è una soglia numerica, senza ordinamento o identificazione automatica di pubblicazioni utili. Valida i parametri prima di programmare le pagine successive.
Le risposte dell’API contengono record piatti, non alberi di conversazione assemblati lato server. Quando parent_id e link_id sono presenti, i client possono raggrupparli localmente, ma non è garantita una conversazione completa. Non esistono filtri parent_id o link_id. I riferimenti potrebbero puntare a record non disponibili nella selezione: conserva tali lacune anziché inventare una corrispondenza o il testo mancante.
Una risposta contiene data, pagination e credits. I campi dei documenti in data possono variare: testo, date e identificatori non sono garantiti in ogni record. Salva il corpo originale prima di normalizzarlo e distingui un campo assente, un testo vuoto e uno zero. Queste condizioni possono avere significati diversi nella tua applicazione e non dovrebbero essere sostituite silenziosamente da un unico valore.
Pagine, errori e addebiti
limit e page accettano valori da 1 a 100. Ogni richiesta riceve una pagina di massimo 100 record e una query consente di richiedere fino a 100 pagine. L’ordine interno _doc non è cronologico, per pertinenza o punteggio. Suddividere periodi o percorrere pagine può organizzare la raccolta, ma non garantisce recupero completo, record unici o risposte identiche in una successiva query remota.
Leggi pagination.total con relation: eq indica il totale esatto della query, gte un limite inferiore e unknown un totale non affidabile, eventualmente null. Sconosciuto non significa zero. Anche un totale esatto non prova di aver scaricato tutti i risultati né che l’archivio contenga tutta la storia. Conserva gli indicatori di paginazione e i limiti insieme alle risposte locali.
HTTP 400 indica parametri non validi, 401 una chiave mancante o non valida, 402 saldo insufficiente e 429 un limite di frequenza. Un recupero riuscito costa un credito, anche vuoto. Le richieste non valide non addebitano il saldo; gli errori del servizio a monte restituiscono la riserva. Il client può perdere la risposta dopo un successo addebitato. Un nuovo tentativo riuscito costa un altro credito: salva il risultato prima di aggiornare l’avanzamento locale.
