Overview
Stay organized with collections
Save and categorize content based on your preferences.
What Is Programmable Search Engine?
Programmable Search Engine lets you create a search engine for your website,
your blog, or a collection of websites. You can configure your search engine to
search both web pages and images. You can fine-tune the ranking, customize the
look and feel of the search results, and invite your friends or trusted users to
help you build your Programmable Search Engine. You can even make money from
your search engine by using your Google AdSense account.
There are two main use cases for Programmable Search Engine - you can create a
search engine that searches only the contents of one website (site search), or
you can create one that focuses on a particular topic from multiple sites. You
can use your expertise about a subject to tell Programmable Search Engine which
websites to search, prioritize, or ignore. Because you know your users well, you
can tailor the search engine to their interests.
With Programmable Search Engine, you can:
- Create Programmable Search Engines that search across a specified collection
of sites or pages
- Enable image search for your site
- Customize the look and feel of search results, including adding
search-as-you-type autocompletions
- Add promotions to your search results
- Leverage structured data on your site to customize search results
- Create a monetized search engine ad unit with your Google AdSense account,
so you make money whenever users click ads on your search results pages.
Summary of Programmable Search Engine Offerings
Programmable Search Engine has four offerings available for use. Use this chart
to help you select which offering is best for your site.
| Offering |
Standard Search Element |
Non-profit Search Element |
Paid Search Element |
Custom Search JSON API |
| Cost |
Free |
Free |
$5 per thousand queries |
$5 per thousand queries |
| Ads |
Yes |
No |
No |
No |
| Google Branding |
Optional |
Yes |
Optional |
No |
| Daily Query Limit |
No Daily Limit |
No Daily Limit |
No Daily Limit |
10,000 queries per day |
| Implementation |
Client side javascript |
Client side javascript |
Client side javascript |
Client side or server side JSON API |
| Availability |
Everyone |
Non-profits only |
Everyone |
Everyone |
| Getting Started |
Learn More
|
Learn More |
Learn More |
Learn More
|
Available APIs
After creating a Programmable Search Engine, you can use a default page hosted
by Google to show your results to the user, or you can embed search
functionality directly in your website. The following resources are available to
developers who want more control over creating search engines and customizing
the appearance of search results:
The Programmable Search Element Control API
lets you embed the Programmable Search Element in your web pages and other
web applications using JavaScript.
The Custom Search JSON API lets you
develop websites and programs to retrieve and display search results from
Programmable Search Engine programmatically. With this API, you can use
RESTful requests to get search results in JSON format.
Getting started
The easiest way to get started with Programmable Search Engine is to create a
basic search engine using the Control Panel. You can
then download the key XML files you need to modify to customize your search
engine programmatically.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-08-21 UTC.
[null,null,["Last updated 2024-08-21 UTC."],[[["\u003cp\u003eProgrammable Search Engine allows you to build custom search engines for your website, blog, or a collection of websites, enabling searches across web pages and images.\u003c/p\u003e\n"],["\u003cp\u003eYou can refine search rankings, personalize the appearance of search results, and potentially monetize your search engine using Google AdSense.\u003c/p\u003e\n"],["\u003cp\u003eProgrammable Search Engine offers four distinct offerings: Standard, Non-profit, Paid, and Custom Search JSON API, each with varying features and costs.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can leverage APIs like the Programmable Search Element Control API and the Custom Search JSON API for advanced customization and integration.\u003c/p\u003e\n"],["\u003cp\u003eCreating a basic search engine through the Control Panel is the easiest way to begin using Programmable Search Engine.\u003c/p\u003e\n"]]],[],null,["# Overview\n\nWhat Is Programmable Search Engine?\n-----------------------------------\n\nProgrammable Search Engine lets you create a search engine for your website,\nyour blog, or a collection of websites. You can configure your search engine to\nsearch both web pages and images. You can fine-tune the ranking, customize the\nlook and feel of the search results, and invite your friends or trusted users to\nhelp you build your Programmable Search Engine. You can even make money from\nyour search engine by using your [Google AdSense account](https://www.google.com/adsense/login?sourceid=aso&subid=ww-en-et-aso_api3&medium=link).\n\nThere are two main use cases for Programmable Search Engine - you can create a\nsearch engine that searches only the contents of one website (site search), or\nyou can create one that focuses on a particular topic from multiple sites. You\ncan use your expertise about a subject to tell Programmable Search Engine which\nwebsites to search, prioritize, or ignore. Because you know your users well, you\ncan tailor the search engine to their interests.\n\nWith Programmable Search Engine, you can:\n\n- Create Programmable Search Engines that search across a specified collection of sites or pages\n- Enable image search for your site\n- Customize the look and feel of search results, including adding search-as-you-type autocompletions\n- Add promotions to your search results\n- Leverage structured data on your site to customize search results\n- Create a monetized search engine ad unit with your Google AdSense account, so you make money whenever users click ads on your search results pages.\n\nSummary of Programmable Search Engine Offerings\n-----------------------------------------------\n\nProgrammable Search Engine has four offerings available for use. Use this chart\nto help you select which offering is best for your site.\n\n|-------------------|-------------------------------------------|------------------------------------------------------------------------------|-----------------------------------------------------------------------------|------------------------------------------|\n| Offering | Standard Search Element | Non-profit Search Element | Paid Search Element | Custom Search JSON API |\n| Cost | Free | Free | $5 per thousand queries | $5 per thousand queries |\n| Ads | Yes | No | No | No |\n| Google Branding | Optional | Yes | Optional | No |\n| Daily Query Limit | No Daily Limit | No Daily Limit | No Daily Limit | 10,000 queries per day |\n| Implementation | Client side javascript | Client side javascript | Client side javascript | Client side or server side JSON API |\n| Availability | Everyone | Non-profits only | Everyone | Everyone |\n| Getting Started | [Learn More](/custom-search/docs/element) | [Learn More](https://support.google.com/programmable-search/answer/12423873) | [Learn More](https://developers.google.com/custom-search/docs/paid_element) | [Learn More](/custom-search/v1/overview) |\n\nAvailable APIs\n--------------\n\nAfter creating a Programmable Search Engine, you can use a default page hosted\nby Google to show your results to the user, or you can embed search\nfunctionality directly in your website. The following resources are available to\ndevelopers who want more control over creating search engines and customizing\nthe appearance of search results:\n\n- The [Programmable Search Element Control API](/custom-search/docs/element)\n\n lets you embed the Programmable Search Element in your web pages and other\n web applications using JavaScript.\n- The [Custom Search JSON API](/custom-search/v1/overview) lets you\n develop websites and programs to retrieve and display search results from\n Programmable Search Engine programmatically. With this API, you can use\n RESTful requests to get search results in JSON format.\n\nGetting started\n---------------\n\nThe easiest way to get started with Programmable Search Engine is to create a\nbasic search engine using the [Control Panel](https://programmablesearchengine.google.com/controlpanel/all). You can\nthen download the key XML files you need to modify to customize your search\nengine programmatically."]]