Creating a Programmable Search Engine

There are two ways of creating a Programmable Search Engine:

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 engine's XML files and modify them to add further customizations. Since you're experimenting and figuring out some basic concepts, spend only a couple of minutes making your first search engine. Keep it simple so that you can follow what's happening when you start testing it. You can always change it later.

Defining a Programmable Search Engine in Control Panel

To create a Programmable Search Engine:

  1. Sign into Control Panel using your Google Account (get an account if you don't have one).
  2. In the Name your search engine section, specify your search engine's name. You can change this name at any time.
  3. In the What to search? section, add the pages you want to include in your search engine. You can include any sites you want, not just the sites you own. You can include whole site URLs or individual pages URLs. You can also use URL patterns.
  4. Click Create.

Your basic search engine is ready to use! To see more configuration options, go to the Control Panel.

To learn more about options available in Control Panel, visit the Programmable Search Engine Help Center. To add advanced options (e.g. filtering or results order) and further customize your search engine via XML configuration files, see the Developer Guide.

Using the engine

Once you have defined your search engine, it can be accessed in two ways:

  • Google-hosted Programmable Search Engine homepage - you can find the Public URL for your engine homepage in the Overview page's Basic section and share it with your users.
  • A search box in your website - If you embed a search box in your webpage, your users can make searches from your website.


Continue to Implementing search box.