Vai al contenuto principale
Inizia da quello che hai e da quello che vuoi ottenere. Ogni endpoint utilizza l’URL base https://api.olostep.com e l’intestazione Authorization: Bearer <YOUR_API_KEY> (vedi Autenticazione).

​
In base all’obiettivo

​
Decisioni comuni

  • Scrape vs. Crawl: usa scrape quando conosci l’URL esatto. Usa crawl quando vuoi molte pagine da un sito e non vuoi elencarle tu stesso.
  • Map vs. Crawl: map restituisce solo URL ed è veloce. Usalo per scegliere le pagine prima, poi esegui scrape o batch solo su quelle.
  • Crawl vs. Batch: crawl scopre le pagine seguendo i link. Batch prende una lista di URL che hai già, fino a migliaia alla volta.
  • Search vs. Answers: search restituisce link per te (o il tuo agente) da leggere. Answers legge le pagine per te e restituisce una singola risposta con citazioni.
  • Parsers vs. LLM extraction: usa un parser quando esiste per il sito. È più veloce e restituisce gli stessi campi ogni volta. Usa LLM extraction per qualsiasi altra cosa.

​
Endpoint asincroni

Crawls e batches vengono eseguiti in background. Ognuno restituisce subito un id. Esegui il polling di GET /v1/crawls/{id} o GET /v1/batches/{id} fino a quando lo status è completed, poi recupera i risultati. Interrompi il polling se lo status è failed. Un crawl può comunque terminare come completed con 0 pagine (controlla pages_count), e un batch può terminare come completed con alcuni elementi falliti (elencali con ?status=failed). Ogni pagina delle funzionalità mostra il flusso completo.

​
Altri modi per chiamare Olostep