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

# Quel outil utiliser ?

> Choisissez le bon point d’accès Olostep pour votre objectif — une URL, un site entier, une liste d’URLs, une recherche web, ou une réponse documentée.

Commence par ce que tu as et ce que tu veux obtenir. Chaque point d’accès utilise l’URL de base `https://api.olostep.com` et l’en-tête `Authorization: Bearer <YOUR_API_KEY>` (voir [Authentification](https://docs.olostep.com/get-started/authentication.md)).

## Par objectif

| Tu as | Tu veux | Utiliser | Point d’accès | Synchrone ou asynchrone |
| - | - | - | - | - |
| Une URL | Son contenu en Markdown, HTML, texte ou JSON | [Scrape](https://docs.olostep.com/features/scrapes.md) | `POST /v1/scrapes` | Synchrone |
| Une requête, pas d’URLs | Une liste de liens pertinents et d’extraits | [Search](https://docs.olostep.com/features/search.md) | `POST /v1/searches` | Synchrone |
| Une question | Une réponse documentée avec sources | [Answers](https://docs.olostep.com/features/answers.md) | `POST /v1/answers` | Synchrone |
| Un site web | Chaque URL dessus, sans contenu | [Map](https://docs.olostep.com/features/maps.md) | `POST /v1/maps` | Synchrone |
| Un site web | Le contenu de chaque page (ou un sous-ensemble filtré) | [Crawl](https://docs.olostep.com/features/crawls.md) | `POST /v1/crawls` | Asynchrone |
| Une liste d’URLs connues | Le contenu de toutes | [Batch](https://docs.olostep.com/features/batches.md) | `POST /v1/batches` | Asynchrone |
| Une page qui change | Une alerte lorsqu’elle change | [Monitor](https://docs.olostep.com/features/monitors.md) | `POST /v1/monitors` | Exécute selon un calendrier |
| N’importe quel appel API | Le même appel à intervalles réguliers | [Schedule](https://docs.olostep.com/features/schedules.md) | `POST /v1/schedules` | Exécute selon un calendrier |
| Un site pris en charge (Google, LinkedIn, Amazon…) | Champs JSON structurés propres | [Parsers](https://docs.olostep.com/features/structured-content/parsers.md) | option `parser` sur scrapes et batches | Même que l’appel sur lequel il est |
| N’importe quelle page | Champs JSON personnalisés que tu décris | [LLM extraction](https://docs.olostep.com/features/structured-content/llm-extraction.md) | option `llm_extract` sur scrapes | Même que l’appel sur lequel il est |

## Décisions courantes

* **Scrape vs. Crawl :** utilise scrape quand tu connais l’URL exacte. Utilise crawl quand tu veux plusieurs pages d’un site et que tu ne veux pas les lister toi-même.
* **Map vs. Crawl :** map renvoie uniquement des URLs et est rapide. Utilise-le pour choisir les pages d’abord, puis scrape ou batch seulement celles-là.
* **Crawl vs. Batch :** crawl découvre des pages en suivant des liens. Batch prend une liste d’URLs que tu as déjà, jusqu’à des milliers à la fois.
* **Search vs. Answers :** search renvoie des liens pour que tu (ou ton agent) les lises. Answers lit les pages pour toi et renvoie une seule réponse avec des citations.
* **Parsers vs. LLM extraction :** utilise un parser quand il en existe un pour le site. C’est plus rapide et renvoie les mêmes champs à chaque fois. Utilise LLM extraction pour tout le reste.

## Points d’accès asynchrones

Crawls et batches s’exécutent en arrière-plan. Chacun renvoie un `id` immédiatement. Interroge `GET /v1/crawls/{id}` ou `GET /v1/batches/{id}` jusqu’à ce que le `status` soit `completed`, puis récupère les résultats. Arrête d’interroger si le `status` est `failed`. Un crawl peut toujours se terminer comme `completed` avec 0 pages (vérifie `pages_count`), et un batch peut se terminer comme `completed` avec certains éléments échoués (liste-les avec `?status=failed`). Chaque page de fonctionnalité montre le flux complet.

## Autres façons d’appeler Olostep

* **Agents IA et outils de codage :** le [serveur MCP](https://docs.olostep.com/integrations/mcp-server.md) et les [compétences d’agent](https://docs.olostep.com/features/skills.md) donnent ces outils directement aux agents.
* **Terminal et scripts :** le [CLI Olostep](https://docs.olostep.com/cli/overview.md) enveloppe chaque point d’accès et renvoie du JSON.
* **Code :** les [SDKs Python et Node](https://docs.olostep.com/sdks/overview.md).


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