Image search abstraction layer: Here are some instructions for working with Google Custom Search

Hi everyone! I wanted to share with you some instructions to start working with Google Custom Search for out Image Search Abstraction Layer project, since this is a great API for the project. I hope it helps! :smile:

  1. First of all, you must go to Google Custom Search https://developers.google.com/custom-search/
  2. Click on Sign In at the top right corner of the screen
  3. Log in to your account
  4. Go to Create a custom search engine tab and read the section Defining a Custom Search Engine in Control Panel
  5. Click on the link “Control panel”
  6. Next, provide a url to create your search engine e.g www.google.com (don’t worry, we will remove this later)
  7. select language and give the search engine a name
  8. Then, create the search engine and go to the Edit search engine tab
  9. Select your custom search engine
  10. Enable image search by clicking on the button to the right of Image search
  11. On the panel that displays the site you entered initially, click on the top menu, where it says search only site you’ve included and change it to search the whole web but emphasize sites you’ve included
  12. next, delete the site you included.

Now you’ve configured your custom search engine, but to get the actual URL to query the API you must:

  1. go to the “details” section right above the previous panel and click on "Search Engine ID" . This will be the cx parameter on your URL, one of the three required parameters
  2. Next you need a key parameter that you can find in the documentation by being logged in to your account and clicking on the button key.
  3. AND… for this project, you will want to filter the search to only images by adding the searchType parameter in the url set to image.

You can find the documentation and a “playground” on these links:
https://developers.google.com/custom-search/json-api/v1/reference/cse/list
https://developers.google.com/custom-search/docs/tutorial/creatingcse

Hope it helps! Good luck with your project :sunny:

6 Likes

Solid work. I’ve moved this to the wiki section.

@PortableStick Thank you!