added using cse tutorial

Author: x4nth055

Diff for: README.md

@@ -63,6 +63,7 @@ This is a repository of all the tutorials of [The Python Code](https://www.thepy
     - [How to Get the Size of Directories in Python](https://www.thepythoncode.com/article/get-directory-size-in-bytes-using-python). ([code](general/calculate-directory-size))
     - [How to Download Torrent Files in Python](https://www.thepythoncode.com/article/download-torrent-files-in-python). ([code](general/torrent-downloader))
     - [How to Play and Record Audio in Python](https://www.thepythoncode.com/article/play-and-record-audio-sound-in-python). ([code](general/recording-and-playing-audio))
+    - [How to Use Google Custom Search Engine API in Python](https://www.thepythoncode.com/article/use-google-custom-search-engine-api-in-python). ([code](general/using-custom-search-engine-api))
 
 - ### [Web Scraping](https://www.thepythoncode.com/topic/web-scraping)
     - [How to Access Wikipedia in Python](https://www.thepythoncode.com/article/access-wikipedia-python). ([code](web-scraping/wikipedia-extractor))

Diff for: general/using-custom-search-engine-api/README.md

@@ -0,0 +1,28 @@
+# [How to Use Google Custom Search Engine API in Python](https://www.thepythoncode.com/article/use-google-custom-search-engine-api-in-python)
+To run this:
+- `pip3 install -r requirements.txt`
+- You need to setup a CSE account, check [the tutorial](https://www.thepythoncode.com/article/use-google-custom-search-engine-api-in-python) on how you can set up one. 
+- Change `API_KEY` and `SEARCH_ENGINE_ID` to yours, and then:
+    ```
+    python search_engine.py "python"
+    ```
+    This will use the query "python" to search for results, here is a cropped output:
+    ```
+    ========== Result #1 ==========
+    Title: Welcome to Python.org
+    Description: The official home of the Python Programming Language.
+    URL: https://www.python.org/
+
+    ========== Result #2 ==========
+    Title: The Python Tutorial — Python 3.8.2 documentation
+    Description: It has efficient high-level data structures and a simple but effective approach to 
+    object-oriented programming. Python's elegant syntax and dynamic typing,
+    together ...
+    URL: https://docs.python.org/3/tutorial/
+
+    ========== Result #3 ==========
+    Title: Download Python | Python.org
+    Description: Looking for Python with a different OS? Python for Windows, Linux/UNIX, Mac OS     
+    X, Other. Want to help test development versions of Python? Prereleases ...
+    URL: https://www.python.org/downloads/
+    ```

Diff for: general/using-custom-search-engine-api/requirements.txt

@@ -0,0 +1 @@
+requests

Diff for: general/using-custom-search-engine-api/search_engine.py

@@ -0,0 +1,32 @@
+import requests
+import sys
+
+# get the API KEY here: https://developers.google.com/custom-search/v1/overview
+API_KEY = "<INSERT_YOUR_API_KEY_HERE>"
+# get your Search Engine ID on your CSE control panel
+SEARCH_ENGINE_ID = "<INSERT_YOUR_SEARCH_ENGINE_ID_HERE>"
+# the search query you want, from the command line
+query = sys.argv[1]
+# constructing the URL
+# doc: https://developers.google.com/custom-search/v1/using_rest
+url = f"https://www.googleapis.com/customsearch/v1?key={API_KEY}&cx={SEARCH_ENGINE_ID}&q={query}"
+
+# make the API request
+data = requests.get(url).json()
+# get the result items
+search_items = data.get("items")
+# iterate over 10 results found
+for i, search_item in enumerate(search_items, start=1):
+    # get the page title
+    title = search_item.get("title")
+    # page snippet
+    snippet = search_item.get("snippet")
+    # alternatively, you can get the HTML snippet (bolded keywords)
+    html_snippet = search_item.get("htmlSnippet")
+    # extract the page url
+    link = search_item.get("link")
+    # print the results
+    print("="*10, f"Result #{i}", "="*10)
+    print("Title:", title)
+    print("Description:", snippet)
+    print("URL:", link, "\n")