API Documentation

Bientôt disponible#

Les quatre endpoints ci-dessous sont en bêta privée. Ils sont appelables dès aujourd'hui avec votre clé d'API habituelle, et le décompte des ops ne change pas : chaque appel entame votre quota mensuel exactement comme le décrivent les limites de débit et quotas.

Bêta privée. Ces quatre-là répondent à de vraies requêtes aujourd'hui, mais ils ne sont ni annoncés ni disponibles de façon générale, et leurs formes de requête et de réponse peuvent changer sans préavis. Rien ici ne porte d'engagement de stabilité ou de support, alors gardez-les hors de tout ce qui est critique. Disponibles de façon générale sur V2 aujourd'hui : Perceive et Ingest.

Deux phases#

La phase 1, c'est Distill. Elle passe en disponibilité générale en premier, seule.

La phase 2, c'est Lookup, Watch et Discover. Ces trois-là suivent ensemble, après Distill.

Les quatre pages#

  • Distill (phase 1) prend une liste d'URLs et un schéma que vous fournissez, et retourne des données exactement dans cette forme.
  • Lookup (phase 2) exécute une recherche web et peut rendre les meilleurs résultats dans le même aller-retour.
  • Watch (phase 2) re-génère une page à intervalle régulier, compare chaque vérification à la précédente, et vous notifie quand elle change.
  • Discover (phase 2) liste les URLs d'un site à partir de son sitemap et d'un crawl HTTP, sans rendu et sans artefact stocké.

Comment savoir quand ils arrivent#

Surveillez le changelog. Chaque publication y est annoncée, et il existe un flux RSS à l'adresse /changelog/feed.xml si vous préférez ne pas vérifier à la main. Rien ne passe en disponibilité générale en silence : quand un endpoint y arrive, sa page quitte cette section pour rejoindre Points de terminaison.

Pour tout ce qui est critique, construisez sur la surface disponible de façon générale. Perceive couvre le rendu d'une seule page, et Ingest couvre le crawl d'un site vers des chunks RAG. Les deux sont décrits dans V1 et V2.

← compress-image Distill (Phase 1) →