API JSON Custom Search

L'API JSON Custom Search vous permet de développer des sites Web et des applications permettant de récupérer et d'afficher les résultats de recherche depuis Programmable Search Engine de manière programmatique. Avec cette API, vous pouvez utiliser des requêtes RESTful pour obtenir des résultats de recherche sur le Web ou de recherche d'images au format JSON.

Format des données

L'API JSON Custom Search peut renvoyer des résultats au format de données JSON.

L'API JSON Custom Search utilise la spécification OpenSearch 1.1.

Conditions préalables

ID du moteur de recherche

Avant d'utiliser l'API JSON Custom Search, vous devez créer et configurer votre Programmable Search Engine. Si vous n'avez pas encore créé de Programmable Search Engine, vous pouvez commencer par accéder au panneau de configuration de Programmable Search Engine.

Suivez le tutoriel pour en savoir plus sur les différentes options de configuration.

Après avoir créé un Programmable Search Engine, consultez le Centre d'aide pour savoir comment trouver l'ID de votre moteur de recherche.

Clé API

L'API JSON Custom Search nécessite l'utilisation d'une clé API. Obtenir une clé

Tarification

L'API JSON Custom Search fournit sans frais 100 requêtes de recherche par jour. Si vous avez besoin d'un quota supplémentaire, vous pouvez activer la billing dans la console API. Les requêtes supplémentaires coûtent 5 $pour 1 000 requêtes, jusqu'à un maximum de 10 000 requêtes par jour.

Monitoring

Le tableau de bord des API de la console Cloud Platform permet d'effectuer une surveillance de base de l'API JSON Custom Search. Pour une surveillance plus avancée, la suite Google Cloud Operations (anciennement Stackdriver) est disponible.

La suite Google Cloud Operations vous permet de créer des tableaux de bord personnalisés, de configurer des alertes et d'accéder aux données des métriques de manière automatisée. Pour accéder aux données d'utilisation de l'API JSON Custom Search dans la suite Google Cloud Operations, sélectionnez "Resource type: Consumed API" (Type de ressource : API Consumed) et filtrez "service = 'customsearch.googleapis.com'" dans le générateur de requêtes.

Pour en savoir plus sur les différentes fonctionnalités de surveillance et d'alerte fournies par le tableau de bord des API et la suite Google Cloud Operations, consultez la page Surveiller votre utilisation des API.