L'API JSON Custom Search vous permet de développer des sites Web et des applications afin de récupérer et d'afficher des résultats de recherche à partir de Programmable Search Engine par programmation. 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.
Documents associés
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 d'abord créer et configurer votre Programmable Search Engine. Si vous n'avez pas encore créé de Programmable Search Engine, commencez par consulter le 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é
Tarifs
L'API JSON Custom Search permet de bénéficier sans frais de 100 requêtes de recherche par jour. Si vous avez besoin d'espace supplémentaire, vous pouvez activer la facturation dans la console API. Les requêtes supplémentaires coûtent 5 $pour 1 000 requêtes, dans la limite de 10 000 requêtes par jour.
Si vous avez besoin de plus de 10 000 requêtes par jour et que votre Programmable Search Engine effectue des recherches sur 10 sites ou moins, vous pouvez vous intéresser à l'API JSON Custom Site Restricted JSON, qui n'a pas de limite de requêtes quotidiennes.
Surveillance
La surveillance de base de l'API JSON Custom Search est disponible via le tableau de bord de l'API de la console Cloud Platform. Pour une surveillance plus avancée, la suite Google Cloud Operations (anciennement Stackdriver) est disponible.
Avec la suite Google Cloud Operations, vous pouvez créer des tableaux de bord personnalisés, configurer des alertes et accéder aux données de 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 "Type de ressource: Consumed API" et filtrez sur "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 Contrôler votre utilisation des API.