Programmable Search Engine Blog

More monitoring options for the Custom Search JSON API

Wednesday, August 12, 2020

The Custom Search JSON API lets you develop websites and applications to retrieve and display search results from Programmable Search Engine (formerly Google Custom Search) programmatically. Basic monitoring for the API has been available through Cloud Platform Console's API Dashboard. Today, we’re excited to announce that the Custom Search JSON API is now integrated with Google Cloud's operations suite (formerly Stackdriver). Google Cloud's operations suite supports a wide variety of metrics, which you can combine with filters and aggregations for new and insightful views into your application performance. For example, you can combine a request count metric with a grouping on the HTTP Response Code to build a dashboard that shows error rates over time, or aggregate a latency metric at varying percentiles. Learn more about creating custom dashboards, setting up alerts, and accessing metrics data programmatically.Example of a custom dashboard showing QPS and error rates:

Custom dashboard showing latency percentiles:

Defining an alert on a QPS threshold:

See Monitoring Your API Usage for a discussion of the different monitoring and alerting capabilities provided by the API Dashboard and the Google Cloud Operations suite.

Improving our Image Search design

Friday, June 5, 2020

We are very excited to bring a new look and feel to our Image Search results for the Programmable Search Element. The new design makes it easier to navigate, peruse, and view image previews.Simply enable image search to start using it today.

Desktop

Before	After

Mobile

Before	After

As always, we welcome your feedback in our forums.

Custom Search Engine is now Programmable Search Engine

Thursday, April 30, 2020

Over the past year, we have made a series of improvements to Custom Search Engine to make it ever more powerful and more flexible. Our launch of Callbacks made it possible to customize the rendering of search results beyond what is possible through our standard controls in the Custom Search Engine control panel. The Knowledge Graph launch made it easy to tap into the power of Google’s understanding of the semantic web to build search experiences based on topics and concepts.

Looking forward, our exciting roadmap will continue to focus on making public web content programmatically accessible and your search engines more flexible. As our product has evolved, we believe our branding should as well. We are excited to announce that Custom Search Engine will now be called Programmable Search Engine.

Over the next several months, you’ll start to see this branding change reflected throughout the entire user experience.

We invite you to learn more about Programmable Search Engine and to get started.

Bringing the Power of Knowledge Graph to Custom Search

Wednesday, July 10, 2019

We're happy to announce that Custom Search Engine (CSE) owners can now use Knowledge Graph entities to configure their CSE. The Knowledge Graph (KG) is used by Google Search to help users discover information more quickly and easily, and contains millions of entries that describe real-world entities like people, places, and things.

CSE owners can use KG Entities to

Define which pages the CSE searches
Create Refinements to narrow down search results within a CSE.

For more information about using Knowledge Graph Entities to define and refine your Custom Search Engine, visit our developer documentation.

Here are some examples of what you can do:

Searching the entire web for specific Entities

CSE's KG Entity support makes it easy to search the entire web for pages (or images) about specific topics.
We've configured this CSE to search the entire web for pages about Alphabet companies, using the CSE control panel as shown below:

Try out the CSE here: https://cse.google.com/cse?cx=000888210889775888983:b2bhygxt4le

Searching specific pages for Entities

Instead of searching the entire web, you can combine KG entities with CSE's existing site search functionality.
For example, we've configured this CSE to search Wikipedia for pages about the entity Pittsburgh:

Try out the CSE here: https://cse.google.com/cse?cx=000888210889775888983:x1jaj-jlc3e

Defining Refinements with Entities

CSE's refinements feature allows users to drill down into their search results. Now, CSE owners can use KG entities to define the refinements if their CSE.

For example, we defined this CSE to be about the Knowledge Graph Entity "basketball":

Then we add refinements for basketball subtopics, like the NBA, WNBA, College, Olympic basketball, and basketball gear. For example, this refinement returns pages that are about both Basketball (from the top-level CSE definition) and Sports Equipment, Shoes, or Jerseys:

Try out the CSE here: https://cse.google.com/cse?cx=000888210889775888983:-nzsrilglze

Introducing Callbacks for even more rendering control

Monday, June 24, 2019

For our power users that are interested in customizing the rendering of search results beyond what is possible through our standard controls in the Custom Search Engine control panel, we are introducing a new set of Callback functions that will unlock new capabilities to customize your search result rendering even further.

Callbacks provide an opportunity to customize the experience during the rendering flow of the search results in powerful new ways. We are introducing callbacks for when the search begins, when the results are ready, and when the results are rendered. If you would like to augment your results with additional information or increased interactivity, callbacks provide an easy way to build on top of the already existing customizations you have for Custom Search Engine.

Please note that this feature only applies to the Custom Search Element API of the Custom Search Engine. These Callbacks are not applicable to the JSON API of the Custom Search Engine. Also, these callbacks only modify the organic search results; they do not modify any of the advertising or the rendering of the advertising returned from the Custom Search Element API.

Learn how to use these new functions in the Search Callbacks section of the Custom Search Element API for more details.

We are excited to see what new customizations our vibrant and creative publisher ecosystem will bring to Customized Search Engines with these new callbacks.

We would like to hear your feedback and comments on this new functionality. We invite you to share your thoughts in our user forum.

The Google Custom Search Engine Team

Improving our mobile layout

Monday, April 22, 2019

We are pleased to announce a new mobile layout that should provide an improved experience for mobile device users. We’ve changed the look of the search box and refinements, increased the size of the thumbnails, and simplified the pagination.

Before After

Most of these changes only affect mobile devices, but the refinements have also been updated for desktop.

Before After

The mobile-specific changes can be optionally disabled by setting the "mobileLayout" attribute of the search element to “disabled”.

Expanding our Custom Search Engine offerings.

Monday, July 16, 2018

We are excited to announce an expansion of our Custom Search Engine offerings. We offer the following implementation options for Custom Search Engine.

Standard Search Element - This free, ads supported search element is easily added to your site with simple javascript, is available for everyone, and has no daily query limit.
Nonprofit Search Element - This free search element is available for non-profit groups (such as charities, schools, and governments), and is similar to the Standard Search Element but does not have advertising.
JSON API - This API costs $5 per thousand queries, allows programmatic access, and does not have advertising or Google branding. However, this API is limited to 10,000 queries per day.

Today, we are excited to add a fourth implementation option.

Site Restricted JSON API - This API is similar to the JSON API above, but there is no daily query cap for Custom Search Engines that search 10 sites or fewer.

Learn more about how to use the Site Restricted JSON API from the developer site, or learn more about the differences between these offerings to help select the implementation option that works best for you.