Custom Search Site Restricted JSON API

This document describes how to use the Custom Search Site Restricted JSON API.

About the Custom Search Site Restricted JSON API

If your Custom Search Engine is restricted to only searching specific sites (10 or fewer), you can use the Custom Search Site Restricted JSON API. This API is similar to the JSON Custom Search API except this version has no daily query limit. To use this version, confirm that you see 10 or fewer sites to search in the “Sites to Search” section of your Custom Search Engine control panel, the are no global top level domain patterns, and that “Search the entire web” is set to OFF.

When using the Custom Search Site Restricted JSON API endpoint, be mindful that if your Custom Search Engine configuration is changed so that it does not conform with the site restriction rules above, the Custom Search Site Restricted JSON API may not return the expected results.

Making a request

Making a request to Custom Search Site Restricted JSON API is similar to making a request to JSON Custom Search API; however, the URI is different. The format for the Custom Search Site Restricted JSON API is

https://www.googleapis.com/customsearch/v1/siterestrict?[parameters]

The [parameters] are the same as the JSON Custom Search API parameters

Pricing

Custom Search Site Restricted JSON API requests cost $5 per 1000 queries and there is no daily query limit. You may sign up for billing in the API Console.

Send feedback about...

Custom Search