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
—
Parámetros de consulta
Parámetro
Valor / tipo / intervalo
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
Navegación y Recuperación de Datos Estructurados
Las consultas GET se envían a https://api.redditscraping.com con X-API-Key: <clave> o Authorization: Bearer <clave>. Ambas cabeceras están admitidas. Guarda el secreto en tu servidor. La sesión Secure HttpOnly del panel de cuenta es independiente y no sustituye estas cabeceras. El servicio consulta registros históricos: no recibe instrucciones para rastrear páginas actuales ni para sortear restricciones de otro sitio.
Una recuperación exitosa, incluso con resultado vacío, cuesta un crédito. Las solicitudes inválidas no descuentan saldo; los fallos del servicio de origen devuelven el crédito reservado. Una conexión perdida por el cliente puede ocurrir después de un éxito cobrado, y otra recuperación exitosa cuesta otro crédito. No confundas una respuesta perdida con un reembolso de la consulta o de un pago en criptomonedas.
limit y page aceptan valores de 1 a 100. Cada solicitud obtiene una página de hasta 100 registros; una consulta permite solicitar hasta 100 páginas. El orden interno _doc no es cronológico, de relevancia o puntuación. Recorrer páginas o dividir períodos puede organizar la extracción, pero no garantiza registros únicos, cobertura exhaustiva o resultados idénticos al repetirla.
Rutas, Filtros y Semántica de Consulta Precisas
/v1/search busca publicaciones y comentarios; /v1/posts restringe a publicaciones y /v1/comments a comentarios. Admiten q, subreddit, author, kind, from, to, min_score, limit y page. kind acepta post o comment. /v1/item?id=... exige id y busca un registro individual, sin otros filtros. /v1/subreddits admite solo prefix y limit; sus recuentos no son un censo global exacto garantizado.
min_score es un umbral numérico y no controla la ordenación. q realiza una búsqueda textual, no una clasificación de sentimientos ni un lenguaje arbitrario de consultas. from y to usan YYYY-MM-DD en UTC y se aplican a created_utc; el día to se incluye completo. No aceptan horas ni segundos y no seleccionan el momento de incorporación al archivo.
Lee pagination.total junto con relation. eq indica un total exacto de la consulta; gte una cota inferior; unknown un total no fiable, posiblemente null. Desconocido no equivale a cero. Ni un total exacto prueba que hayas descargado todas las coincidencias o que existan todas las publicaciones históricas. Conserva los indicadores recibidos y las limitaciones junto a tu conjunto local.
Gestión de Errores, Autenticación y Estructura de Respuesta
HTTP 400 indica parámetros inválidos, 401 una clave ausente o inválida, 402 saldo insuficiente y 429 un límite de frecuencia. Distingue el problema antes de repetir: comprar más créditos no elimina un límite de frecuencia. Guarda los resultados y actualiza el avance local solo tras procesar la respuesta, evitando que una repetición silenciosa o un salto de página distorsionen el registro de trabajo.
Las respuestas de la API contienen registros planos, no árboles de hilos ensamblados por el servidor. Si los campos parent_id o link_id están presentes, el cliente puede agruparlos localmente, pero esto no garantiza una conversación completa ni una ascendencia garantizada. No existen filtros de consulta expuestos para link_id o parent_id, lo que significa que la jerarquía se gestiona parcialmente en el lado del cliente basado en los datos planos devueltos.
/v1/status es público y gratuito. Devuelve una descripción estática y demuestra que responde la aplicación HTTP; no consulta el motor de búsqueda, valida la clave o confirma disponibilidad, latencia o cobertura de registros. Los datos son históricos e independientes, sin garantía de conservación o disponibilidad permanente. La política de retención de datos de cuenta no establece cuánto permanecerá disponible un registro del archivo.
