Passer au contenu principal
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).

Par objectif

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