> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quale strumento uso?

> Scegli l’endpoint Olostep giusto per il tuo obiettivo — un URL, un intero sito, una lista di URL, una ricerca web o una risposta ricercata.

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](https://docs.olostep.com/get-started/authentication.md)).

## In base all'obiettivo

| Hai | Vuoi | Usa | Endpoint | Sincrono o asincrono |
| - | - | - | - | - |
| Un URL | Il suo contenuto come Markdown, HTML, testo o JSON | [Scrape](https://docs.olostep.com/features/scrapes.md) | `POST /v1/scrapes` | Sincrono |
| Una query, nessun URL | Una lista di link e frammenti rilevanti | [Search](https://docs.olostep.com/features/search.md) | `POST /v1/searches` | Sincrono |
| Una domanda | Una risposta ricercata con fonti | [Answers](https://docs.olostep.com/features/answers.md) | `POST /v1/answers` | Sincrono |
| Un sito web | Ogni URL su di esso, senza contenuto | [Map](https://docs.olostep.com/features/maps.md) | `POST /v1/maps` | Sincrono |
| Un sito web | Il contenuto di ogni pagina (o un sottoinsieme filtrato) | [Crawl](https://docs.olostep.com/features/crawls.md) | `POST /v1/crawls` | Asincrono |
| Una lista di URL conosciuti | Il contenuto di tutti | [Batch](https://docs.olostep.com/features/batches.md) | `POST /v1/batches` | Asincrono |
| Una pagina che cambia | Un avviso quando cambia | [Monitor](https://docs.olostep.com/features/monitors.md) | `POST /v1/monitors` | Esegue secondo un programma |
| Qualsiasi chiamata API | La stessa chiamata a intervalli regolari | [Schedule](https://docs.olostep.com/features/schedules.md) | `POST /v1/schedules` | Esegue secondo un programma |
| Un sito supportato (Google, LinkedIn, Amazon…) | Campi JSON strutturati puliti | [Parsers](https://docs.olostep.com/features/structured-content/parsers.md) | opzione `parser` su scrapes e batches | Come la chiamata su cui si trova |
| Qualsiasi pagina | Campi JSON personalizzati che descrivi | [LLM extraction](https://docs.olostep.com/features/structured-content/llm-extraction.md) | opzione `llm_extract` su scrapes | Come la chiamata su cui si trova |

## 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

* **Agenti AI e strumenti di codifica:** il [server MCP](https://docs.olostep.com/integrations/mcp-server.md) e le [abilità degli agenti](https://docs.olostep.com/features/skills.md) forniscono questi strumenti direttamente agli agenti.
* **Terminale e script:** la [CLI di Olostep](https://docs.olostep.com/cli/overview.md) avvolge ogni endpoint e restituisce JSON.
* **Codice:** gli [SDK Python e Node](https://docs.olostep.com/sdks/overview.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.