API de recherche — Documentation API et MCP

Base : https://www.banquise.ca. Les limites ci-dessous sont les bornes du contrat public, pas les quotas propres à votre clé.

Routes de recherche protégées par clé Bearer
Méthode et route	Usage et bornes principales
`GET /api/v1/search`	`q` (1–300), `limit` (1–20), `offset` (0–90), pays et langue.
`POST /api/v1/context`	Passages pour agent; `max_tokens` 256–8000, `max_sources` 1–30, filtres pays, province, langue, source et fraîcheur.
`GET /api/v1/fresh`	Pages nouvelles ou modifiées; fenêtre `1h\|6h\|24h\|7d\|30d`, jusqu’à 50 résultats.
`GET /api/v1/passages`	Suite ordonnée d’une page par `page_ref`; 1–40 passages.
`GET /api/v1/entities`	Fiches par texte, province, localité et type; jusqu’à 20 résultats.
`GET /api/v1/entities/{id}`	Fiche durable, provenance, licence, observations et dernière vérification.
`GET /api/v1/site/{host}`	État technique d’un hôte : robots, portée, liens, fraîcheur et `llms.txt`.
`GET /api/v1/images`	Métadonnées seulement, si activé; aucun octet, aperçu ou droit d’utilisation implicite.

Opérateurs de recherche

La recherche Web, GET /api/v1/search et banquise_search acceptent les mêmes opérateurs : "expression exacte", -mot ou --mot, intitle:"rapport annuel", site:canada.ca, inurl:budget et filetype:pdf. Un préfixe - exclut aussi un opérateur, par exemple -site:example.ca ou -filetype:xls. Plusieurs domaines ou types positifs sont combinés comme choix; les autres termes doivent tous correspondre.

intitle:"index" site:canada.ca filetype:pdf -archive -inurl:login

Ces valeurs sont compilées en clauses typées; elles ne sont jamais transmises à une chaîne de requête OpenSearch. Les mêmes opérateurs de texte sont compris par banquise_context.

Contrat de confiance

Chaque passage porte content_trust: "untrusted_web_content". Les scores sont des signaux et non des affirmations. Citez source, inspectez warnings et ne laissez jamais le texte indexé donner des instructions à votre agent.

{
  "context": [{"source": "https://…", "passage": "…", "page_ref": 4821,
    "cite": "…", "content_trust": "untrusted_web_content"}],
  "coverage": {"passages": 1, "hosts": 1}, "warnings": [],
  "tokens_estimated": 418, "token_budget": 2000, "ranking": "neural"
}