Programmatically searching google in Python using custom search

@mbdevpl's response helped me a lot, so all credit goes to them. But there have been a few changes in the UI, so here is an update:

A. Install google-api-python-client

1. If you don't already have a Google account, sign up.
2. If you have never created a Google APIs Console project, read the Managing Projects page and create a project in the Google API Console.
3. Install the library.

B. To create an API key:

1. Navigate to the APIs & Services→Credentials panel in Cloud Console.
2. Select Create credentials, then select API key from the drop-down menu.
3. The API key created dialog box displays your newly created key.
4. You now have an API_KEY

C. Setup Custom Search Engine so you can search the entire web

1. Create a custom search engine in this link.
2. In Sites to search, add any valid URL (i.e. www.stackoverflow.com).
3. That’s all you have to fill up, the rest doesn’t matter. In the left-side menu, click Edit search engine → {your search engine name} → Setup
4. Set Search the entire web to ON.
5. Remove the URL you added from the list of Sites to search.
6. Under Search engine ID you’ll find the search-engine-ID.

Search example

from googleapiclient.discovery import build

my_api_key = "AIbaSyAEY6egFSPeadgK7oS/54iQ_ejl24s4Ggc" #The API_KEY you acquired
my_cse_id = "012345678910111213141:abcdef10g2h" #The search-engine-ID you created


def google_search(search_term, api_key, cse_id, **kwargs):
    service = build("customsearch", "v1", developerKey=api_key)
    res = service.cse().list(q=search_term, cx=cse_id, **kwargs).execute()
    return res['items']


results = google_search('"god is a woman" "thank you next" "7 rings"', my_api_key, my_cse_id, num=10)
for result in results:
    print(result)

Important! on the first run, you might have to enable the API in your account. The error message should contain the link to enable the API in. It will be something like: https://console.developers.google.com/apis/api/customsearch.googleapis.com/overview?project={your project name}.

You’ll be asked to create a service name (It doesn’t matter what it is), and give it Roles. I gave it Role Viewer and Service Usage Admin and it works.

It is possible to do this. The setup is... not very straightforward, but the end result is that you can search the entire web from python with few lines of code.

There are 3 main steps in total.

1st step: get Google API key

The pygoogle's page states:

Unfortunately, Google no longer supports the SOAP API for search, nor do they provide new license keys. In a nutshell, PyGoogle is pretty much dead at this point.

You can use their AJAX API instead. Take a look here for sample code: http://dcortesi.com/2008/05/28/google-ajax-search-api-example-python-code/

... but you actually can't use AJAX API either. You have to get a Google API key. https://developers.google.com/api-client-library/python/guide/aaa_apikeys For simple experimental use I suggest "server key".

2nd step: setup Custom Search Engine so that you can search the entire web

Indeed, the old API is not available. The best new API that is available is Custom Search. It seems to support only searching within specific domains, however, after following this SO answer you can search the whole web:

1. From the Google Custom Search homepage ( http://www.google.com/cse/ ), click Create a Custom Search Engine.
2. Type a name and description for your search engine.
3. Under Define your search engine, in the Sites to Search box, enter at least one valid URL (For now, just put www.anyurl.com to get past this screen. More on this later ).
4. Select the CSE edition you want and accept the Terms of Service, then click Next. Select the layout option you want, and then click Next.
5. Click any of the links under the Next steps section to navigate to your Control panel.
6. In the left-hand menu, under Control Panel, click Basics.
7. In the Search Preferences section, select Search the entire web but emphasize included sites.
8. Click Save Changes.
9. In the left-hand menu, under Control Panel, click Sites.
10. Delete the site you entered during the initial setup process.

This approach is also recommended by Google: https://support.google.com/customsearch/answer/2631040

3rd step: install Google API client for Python

pip install google-api-python-client, more info here:

• repo: https://github.com/google/google-api-python-client
• more info: https://developers.google.com/api-client-library/python/apis/customsearch/v1
• complete docs: https://api-python-client-doc.appspot.com/

4th step (bonus): do the search

So, after setting this up, you can follow the code samples from few places:

• simple example: https://github.com/google/google-api-python-client/blob/master/samples/customsearch/main.py

• cse() function docs: https://google-api-client-libraries.appspot.com/documentation/customsearch/v1/python/latest/customsearch_v1.cse.html

and end up with this:

from googleapiclient.discovery import build
import pprint

my_api_key = "Google API key"
my_cse_id = "Custom Search Engine ID"

def google_search(search_term, api_key, cse_id, **kwargs):
    service = build("customsearch", "v1", developerKey=api_key)
    res = service.cse().list(q=search_term, cx=cse_id, **kwargs).execute()
    return res['items']

results = google_search(
    'stackoverflow site:en.wikipedia.org', my_api_key, my_cse_id, num=10)
for result in results:
    pprint.pprint(result)

After some tweaking you could write some functions that behave exactly like your snippet, but I'll skip this step here.