PhilSearch — Développeurs

Gère tes clés API PhilSearch, ton quota, et tes paliers.

Connexion avec PhilMail

Créer une nouvelle clé

Tes clés

Paliers disponibles

📖 Comment intégrer PhilSearch chez toi

Étape 1 — Vérifier ton domaine
Après avoir créé une clé, tu reçois un code (ex. philsearch-verify-xxxx). Ajoute-le dans le <head> HTML de la page d'accueil de ton site :

<meta name="philsearch-verification" content="TON_CODE">

Publie ton site avec cette balise, puis reviens ici cliquer "Vérifier le domaine" sur ta clé. Sans cette étape, ta clé ne fonctionnera pas sur /v1/search.

Étape 2A — Option simple : le widget
Colle ces 2 lignes n'importe où dans le HTML de ton site (palier Free : un encart "Propulsé par Philtech" s'affiche automatiquement, retiré dès le palier Starter) :

<div data-philsearch-key="TA_CLE"></div>
<script src="https://philsearch.henockagbo4.workers.dev/widget.js"></script>

Étape 2B — Option avancée : appeler l'API toi-même
Pour construire ta propre interface, appelle directement :

GET https://philsearch.henockagbo4.workers.dev/v1/search?key=TA_CLE&q=TA_REQUETE&category=general

Réponse en JSON avec phil_results (contenu de l'écosystème Phil) et results (résultats web). Le paramètre category est optionnel (valeurs selon ton palier, voir "Paliers disponibles" ci-dessus).

Limites à connaître

  • Palier Free : 1 requête toutes les 3 secondes maximum
  • Le quota se réinitialise automatiquement chaque mois
  • Dépasser le quota ou le débit renvoie une erreur HTTP 429
  • Une catégorie non incluse dans ton palier renvoie une erreur HTTP 403