Skip to main content
POST
Extraire des données structurées depuis des pages à l’aide de LLM
Remarque : Une nouvelle version v2 de cette API est désormais disponible, avec des fonctionnalités améliorées et de meilleures performances.

Autorisations

Authorization
string
header
requis

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Corps

application/json
urls
string<uri>[]
requis

Les URL à partir desquelles extraire les données. Les URL doivent utiliser le format glob.

Lorsque la valeur est définie sur true, l’extraction utilisera la recherche sur le Web pour trouver des données supplémentaires

ignoreInvalidURLs
boolean
défaut:false

Si des URL non valides sont spécifiées dans le tableau urls, elles seront ignorées. Au lieu de faire échouer toute la requête, une extraction sera effectuée à partir des URL valides restantes, et les URL non valides seront renvoyées dans le champ invalidURLs de la réponse.

ignoreSitemap
boolean
défaut:false

Lorsque cette option est à true, les fichiers sitemap.xml sont ignorés lors de l’analyse du site web

includeSubdomains
boolean
défaut:true

Si activé, les sous-domaines des URL fournies seront également explorés

prompt
string

Prompt guidant le processus d’extraction

schema
object

Schéma qui définit la structure des données extraites. Doit être conforme à la spécification JSON Schema.

scrapeOptions
object
showSources
boolean
défaut:false

Lorsque cette option est définie sur true, les sources utilisées pour extraire les données seront incluses dans la réponse sous la clé sources.

threatProtection
Threat Protection Override · object

Dérogation par requête à la Protection contre les menaces. Les champs que vous fournissez remplacent les champs correspondants de la politique de votre organisation pour cette requête uniquement ; les champs omis conservent leurs valeurs définies au niveau de l’organisation. La Protection contre les menaces doit être activée pour votre équipe (fonctionnalité Enterprise) — sinon, la requête est rejetée avec un code 403. Si votre organisation a désactivé les dérogations par requête, toute requête incluant cet objet est rejetée avec un code 403. Si la Protection contre les menaces est imposée pour votre équipe, mode ne peut pas être défini sur off.

Réponse

Extraction réussie

id
string
invalidURLs
string[] | null

Si ignoreInvalidURLs est défini sur true, il s’agit d’un tableau contenant les URL invalides spécifiées dans la requête. S’il n’y a aucune URL invalide, ce sera un tableau vide. Si ignoreInvalidURLs est défini sur false, ce champ sera undefined.

success
boolean