Programmable Search Engine is a customizable tool that allows you to add Google powered search boxes to your website or blog. Formerly known as Google Custom Search, it enables owners to control what content is searched and how the results look. You can use it to help visitors find specific information within your own domains or across a curated collection of third-party sites.
What is Programmable Search Engine?
Programmable Search Engine lets you build a search experience tailored to your specific audience. You decide the scope of the search: it can focus exclusively on your own content (site search) or act as a topical search engine that pulls from multiple sites you trust.
The tool uses Google's core search technology to deliver results, meaning the ranking and speed match standard Google searches. Users can apply their expertise to prioritize, ignore, or highlight specific web pages, ensuring the most relevant information appears first.
Why Programmable Search Engine matters
- High quality results. Because it uses Google’s constantly improving core technology, users receive fast and relevant answers.
- Complete customization. You chose what content to include and decide the visual design of the search result pages.
- Monetization opportunities. By connecting a Google AdSense account, you can earn revenue when users click on ads within your search results.
- Flexible implementation. You can host results on a Google-hosted page or embed them directly into your site using various APIs.
- User satisfaction. Features like image search and search-as-you-type autocompletions create a more responsive experience.
How Programmable Search Engine works
- Create the engine. Start by using the Control Panel to define the basic settings of your search engine.
- Select search targets. Add the specific URLs or domains you want the engine to crawl.
- Configure the UI. Choose a pre-built theme or design a custom results page from scratch to match your branding.
- Refine search behavior. Use the Control Panel to fine-tune rankings, add promotions, or enable image search.
- Install on your site. Embed the tool using client-side JavaScript or retrieve results programmatically via a JSON API.
Summary of offerings
Programmable Search Engine provides four distinct tiers based on user needs and budget.
| 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 |
| Daily Query Limit | None | None | None | 10,000 queries |
| Google Branding | Optional | Required | Optional | No |
| Availability | Everyone | Non-profits only | Everyone | Everyone |
The Paid Search Element and JSON API both require a fee of [$5 per thousand queries] (Google for Developers).
Best practices
- Use structured data. Apply the structured data already on your site to customize and enhance how your search results appear to users.
- Fine-tune the ranking. Use your subject matter expertise to tell the engine which sites to prioritize or ignore.
- Enable autocompletion. Add search-as-you-type functionality to help users find what they need more quickly.
- Integrate AdSense. If you use the free version, connect your AdSense account to monetize the results page.
- Design for mobile. Use the customizable themes to ensure the search box and results display correctly on phones.
Common mistakes
Mistake: Using the Standard version when you need an ad-free environment. Fix: Switch to the Paid Search Element to remove ads and optional Google branding.
Mistake: Exceeding query limits on API-based projects. Fix: Monitor your usage, as the Custom Search JSON API is limited to [10,000 queries per day] (Google for Developers).
Mistake: Failing to utilize expert knowledge. Fix: Regularly review and update the list of included websites to ensure the engine reflects your users' interests.
Examples
- Site-specific search: A blog owner implements a search box that only looks through their own archived articles and images.
- Topic-based search: A medical professional creates a search engine that only pulls results from five trusted health organization websites.
- Monetized search: A community forum includes a search bar and uses AdSense to earn revenue from the resulting clicks.
Programmable Search Engine vs Cloud Search
While both tools provide search functionality, they serve different environments.
| Feature | Programmable Search Engine | Cloud Search |
|---|---|---|
| Primary Goal | Search public web pages and blogs | Search internal organization content |
| Use Case | Websites, blogs, topical collections | Enterprise business environments |
| Access | Publicly available for site visitors | Secure access for employees |
Choose Programmable Search Engine for external web content and Cloud Search for secure, internal business information.
FAQ
How much does Programmable Search Engine cost? The Standard and Non-profit versions are free. However, the Paid Search Element and the Custom Search JSON API both cost [$5 per thousand queries] (Google for Developers).
Can I remove ads from the search results? Yes. Ads are removed if you use the Non-profit Search Element, the Paid Search Element, or the Custom Search JSON API. The Standard Search Element includes ads by default.
Is there a limit on how many searches users can perform? There is no daily limit for the Search Element versions (Standard, Non-profit, or Paid). However, the Custom Search JSON API has a limit of [10,000 queries per day] (Google for Developers).
Can the search engine look at images? Yes. You can configure the engine to search for both web pages and images depending on your site's needs.
How do I make money with this tool? You can connect your Google AdSense account to your search engine. This creates a monetized search engine ad unit where you earn money when users click on ads within the search results.
Do I need to be a developer to use it? The easiest way is using the Control Panel, which requires no coding. Developers who want more control can use the Programmable Search Element Control API or the Custom Search JSON API for programmatic result retrieval.
