Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
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.
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.
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.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/31 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/31 (UTC)."],[[["\u003cp\u003eThe Custom Search JSON API allows you to programmatically retrieve and display web and image search results from your Programmable Search Engine using RESTful requests.\u003c/p\u003e\n"],["\u003cp\u003eResults are delivered in JSON format and the API adheres to the OpenSearch 1.1 Specification.\u003c/p\u003e\n"],["\u003cp\u003eTo use the API, you need a Search engine ID (obtained by creating a Programmable Search Engine) and an API key.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers 100 free daily search queries, with additional usage billed at $5 per 1000 queries (up to 10,000 per day).\u003c/p\u003e\n"],["\u003cp\u003eMonitor API usage and performance through the Cloud Platform Console's API Dashboard or Google Cloud's Operations suite for more advanced insights.\u003c/p\u003e\n"]]],[],null,["# Custom Search JSON API\n\nThe Custom Search JSON API lets you develop websites and applications to retrieve\nand display search results from Programmable Search Engine programmatically.\nWith this API, you can use RESTful requests to get either **web search** or\n**image search** results in JSON format.\n\nData format\n-----------\n\nCustom Search JSON API can return results in [JSON](/custom-search/docs/glossary#json) data format.\n\nRelated documents\n-----------------\n\nThe Custom Search JSON API uses the [OpenSearch 1.1 Specification](https://github.com/dewitt/opensearch/blob/master/opensearch-1-1-draft-6.md).\n\nPrerequisites\n-------------\n\n### Search engine ID\n\nBefore using the Custom Search JSON API you will first need to create and configure your Programmable Search Engine. If you have not already created a Programmable Search Engine, you can start by visiting the [Programmable Search Engine control panel](https://programmablesearchengine.google.com/controlpanel/all).\n\nFollow the [tutorial](/custom-search/docs/tutorial/creatingcse) to learn more about different configuration options.\n\nAfter you have created a Programmable Search Engine, visit the [help center](https://support.google.com/programmable-search/answer/2649143) to learn how to locate your Search engine ID.\n\n### API key\n\nCustom Search JSON API requires the use of an API key.\nGet a Key\n\nPricing\n-------\n\nCustom Search JSON API provides 100 search queries per day for free.\nIf you need more, you may sign up for [billing](https://cloud.google.com/billing/docs/how-to/manage-billing-account)\nin the API Console. Additional requests cost $5 per 1000\nqueries, up to 10k queries per day.\n\nMonitoring\n----------\n\nBasic monitoring for the Custom Search JSON API is available through [Cloud Platform Console's API Dashboard](https://console.cloud.google.com/apis/dashboard). For more advanced monitoring [Google Cloud's Operations suite](https://cloud.google.com/products/operations) (formerly Stackdriver) is available.\n\nWith Google Cloud Operations you can create [custom dashboards](https://cloud.google.com/monitoring/charts), [set up\nalerts](https://cloud.google.com/monitoring/alerts), and\n[access metrics data programmatically](https://cloud.google.com/monitoring/api/v3). To access Custom Search JSON API usage data in Google Cloud Operations, select \"Resource type: Consumed API\" and filter on \"service = 'customsearch.googleapis.com'\" in the Query Builder.\n\nSee [Monitoring Your API Usage](https://cloud.google.com/apis/docs/monitoring) for a discussion of the different monitoring and alerting capabilities provided by the API Dashboard and the Google Cloud Operations suite."]]
