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

# Welke tool gebruik ik?

> Kies het juiste Olostep endpoint voor je doel — één URL, een hele site, een lijst van URLs, een webzoekopdracht, of een onderzocht antwoord.

Begin met wat je hebt en wat je terug wilt. Elke endpoint gebruikt de basis-URL `https://api.olostep.com` en de header `Authorization: Bearer <YOUR_API_KEY>` (zie [Authenticatie](https://docs.olostep.com/get-started/authentication.md)).

## Per doel

| Je hebt | Je wilt | Gebruik | Endpoint | Sync of async |
| - | - | - | - | - |
| Eén URL | De inhoud als Markdown, HTML, tekst of JSON | [Scrape](https://docs.olostep.com/features/scrapes.md) | `POST /v1/scrapes` | Sync |
| Een query, geen URLs | Een lijst van relevante links en fragmenten | [Search](https://docs.olostep.com/features/search.md) | `POST /v1/searches` | Sync |
| Een vraag | Een onderzocht antwoord met bronnen | [Answers](https://docs.olostep.com/features/answers.md) | `POST /v1/answers` | Sync |
| Een website | Elke URL erop, zonder inhoud | [Map](https://docs.olostep.com/features/maps.md) | `POST /v1/maps` | Sync |
| Een website | De inhoud van elke pagina (of een gefilterde subset) | [Crawl](https://docs.olostep.com/features/crawls.md) | `POST /v1/crawls` | Async |
| Een lijst van bekende URLs | De inhoud van allemaal | [Batch](https://docs.olostep.com/features/batches.md) | `POST /v1/batches` | Async |
| Een pagina die verandert | Een melding wanneer het verandert | [Monitor](https://docs.olostep.com/features/monitors.md) | `POST /v1/monitors` | Draait volgens schema |
| Elke API-oproep | Dezelfde oproep op een timer | [Schedule](https://docs.olostep.com/features/schedules.md) | `POST /v1/schedules` | Draait volgens schema |
| Een ondersteunde site (Google, LinkedIn, Amazon…) | Schone gestructureerde JSON-velden | [Parsers](https://docs.olostep.com/features/structured-content/parsers.md) | `parser` optie op scrapes en batches | Zelfde als de oproep waarop het staat |
| Elke pagina | Aangepaste JSON-velden die je beschrijft | [LLM extraction](https://docs.olostep.com/features/structured-content/llm-extraction.md) | `llm_extract` optie op scrapes | Zelfde als de oproep waarop het staat |

## Veelvoorkomende beslissingen

* **Scrape vs. Crawl:** scrape wanneer je de exacte URL weet. Crawl wanneer je veel pagina's van één site wilt en ze niet zelf wilt opsommen.
* **Map vs. Crawl:** map retourneert alleen URLs en is snel. Gebruik het om eerst pagina's te kiezen, en scrape of batch dan alleen die.
* **Crawl vs. Batch:** crawl ontdekt pagina's door links te volgen. Batch neemt een lijst van URLs die je al hebt, tot duizenden tegelijk.
* **Search vs. Answers:** search retourneert links voor jou (of je agent) om te lezen. Answers leest de pagina's voor jou en retourneert een enkel antwoord met citaten.
* **Parsers vs. LLM extraction:** gebruik een parser wanneer er een bestaat voor de site. Het is sneller en retourneert elke keer dezelfde velden. Gebruik LLM extraction voor alles anders.

## Asynchrone endpoints

Crawls en batches draaien op de achtergrond. Elk retourneert direct een `id`. Poll `GET /v1/crawls/{id}` of `GET /v1/batches/{id}` totdat de `status` `completed` is, en haal dan de resultaten op. Stop met polleren als de `status` `failed` is. Een crawl kan nog steeds eindigen als `completed` met 0 pagina's (controleer `pages_count`), en een batch kan eindigen als `completed` met enkele mislukte items (lijst ze met `?status=failed`). Elke functiepagina toont de volledige flow.

## Andere manieren om Olostep aan te roepen

* **AI-agenten en coderingstools:** de [MCP-server](https://docs.olostep.com/integrations/mcp-server.md) en [agentvaardigheden](https://docs.olostep.com/features/skills.md) geven agenten deze tools direct.
* **Terminal en scripts:** de [Olostep CLI](https://docs.olostep.com/cli/overview.md) omhult elke endpoint en retourneert JSON.
* **Code:** de [Python en Node SDKs](https://docs.olostep.com/sdks/overview.md).


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