Passer au contenu principal
Point de terminaison : GET /customsearch/v1 Effectuez une recherche Google Custom Search avec le cx que vous fournissez. S’il est omis, la requête utilise le moteur de recherche par défaut de YouRouter. Ce point de terminaison est utile pour des résultats web à jour, la consultation de documentation ou un moteur programmable sur vos propres sites.
Les requêtes de recherche sont couvertes par l’assurance zéro complétion. Les recherches en échec ou vides ne sont pas facturées comme des complétions réussies.
import requests
import json

response = requests.get(
    "https://api.yourouter.ai/customsearch/v1",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={
        "q": "how to set up billing",
        "cx": "YOUR_CUSTOM_SEARCH_ENGINE_ID",
        "num": 3
    }
)
print(json.dumps(response.json(), indent=2))

​
Paramètres

ParamètreTypeDescriptionObligatoire
qstringRequête de recherche.Oui
cxstringID du moteur Programmable Search. Valeur par défaut YouRouter si omis.Non
numintegerNombre de résultats (1 à 10).Non
startintegerIndex du premier résultat à renvoyer.Non
siteSearchstringRestreint la recherche à un site.Non

Format de réponse

Une réponse réussie contient un tableau items d’objets résultat.
{
  "kind": "customsearch#search",
  "items": [
    {
      "kind": "customsearch#result",
      "title": "Billing Information - Example Docs",
      "link": "https://docs.example-app.ai/billing"
    }
  ]
}

​
Cas d’usage typiques

Créez un Google Programmable Search Engine qui indexe uniquement vos domaines de documentation, puis transmettez les meilleurs résultats à un modèle pour répondre aux questions produit avec un contexte plus à jour.
Utilisez les résultats de recherche pour récupérer articles, pages ou annonces récents avant de demander au modèle de les résumer ou de raisonner dessus.