Saltar al contenido principal
Empieza con lo que tienes y lo que quieres obtener. Cada endpoint utiliza la URL base https://api.olostep.com y el encabezado Authorization: Bearer <YOUR_API_KEY> (ver Autenticación).

​
Por objetivo

​
Decisiones comunes

  • Scrape vs. Crawl: usa scrape cuando conoces la URL exacta. Usa crawl cuando quieres muchas páginas de un sitio y no quieres listarlas tú mismo.
  • Map vs. Crawl: map devuelve solo URLs y es rápido. Úsalo para elegir páginas primero, luego scrapea o procesa por lotes solo esas.
  • Crawl vs. Batch: crawl descubre páginas siguiendo enlaces. Batch toma una lista de URLs que ya tienes, hasta miles a la vez.
  • Search vs. Answers: search devuelve enlaces para que tú (o tu agente) los leas. Answers lee las páginas por ti y devuelve una sola respuesta con citas.
  • Parsers vs. LLM extraction: usa un parser cuando existe uno para el sitio. Es más rápido y devuelve los mismos campos cada vez. Usa LLM extraction para cualquier otra cosa.

​
Endpoints asincrónicos

Crawls y batches se ejecutan en segundo plano. Cada uno devuelve un id de inmediato. Haz polling a GET /v1/crawls/{id} o GET /v1/batches/{id} hasta que el status sea completed, luego obtén los resultados. Deja de hacer polling si el status es failed. Un crawl aún puede terminar como completed con 0 páginas (verifica pages_count), y un batch puede terminar como completed con algunos elementos fallidos (listalos con ?status=failed). Cada página de características muestra el flujo completo.

​
Otras formas de llamar a Olostep