edited google custom search engine api tutorial

Author: x4nth055

general/using-custom-search-engine-api/README.md

@@ -2,7 +2,7 @@
 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:
+- Change `API_KEY` and `SEARCH_ENGINE_ID` variables to yours, and then:
     ```
     python search_engine.py "python"
     ```
@@ -25,4 +25,31 @@ To run this:
     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/
+    <..SNIPPED..>
+    ```
+- You can specify the page number, let's get 3rd result page for instance:
+    ```
+    python search_engine.py "python" 3
+    ```
+    Here is a **truncated output**:
+    ```
+    ========== Result #21 ==========
+    Title: Python Tutorial - Tutorialspoint
+    Description: Python is a general-purpose interpreted, interactive, object-oriented, and high-  
+    level programming language. It was created by Guido van Rossum during 1985-
+    ...
+    URL: https://www.tutorialspoint.com/python/index.htm
+
+    ========== Result #22 ==========
+    Title: Google Python Style Guide
+    Description: Python is the main dynamic language used at Google. This style guide is a list of 
+    dos and don'ts for Python programs. To help you format code correctly, we've ...
+    URL: http://google.github.io/styleguide/pyguide.html
+
+    ========== Result #23 ==========
+    Title: Individual Edition | Anaconda
+    Description: Open Source Anaconda Individual Edition is the world's most popular Python        
+    distribution platform with over 20 million users worldwide. You can trust in…
+    URL: https://www.anaconda.com/products/individual
+    <..SNIPPED..>
     ```

general/using-custom-search-engine-api/search_engine.py

@@ -2,14 +2,27 @@
 import sys
 
 # get the API KEY here: https://developers.google.com/custom-search/v1/overview
-API_KEY = "<INSERT_YOUR_API_KEY_HERE>"
+API_KEY = "AIzaSyCzSrJGrnLjkRovkjxvHTjaogMZX63MEo0"
 # 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]
+SEARCH_ENGINE_ID = "017479214723175900468:rx94qcojslh"
+# the search query you want, from the command line (e.g python search_engine.py 'python')
+try:
+    query = sys.argv[1]
+except:
+    print("Please specify a search query")
+    exit()
+try:
+    page = int(sys.argv[2])
+    # make sure page is positive
+    assert page > 0
+except:
+    print("Page number isn't specified, defaulting to 1")
+    page = 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}"
+# calculating start, (page=2) => (start=11), (page=3) => (start=21)
+start = (page - 1) * 10 + 1
+url = f"https://www.googleapis.com/customsearch/v1?key={API_KEY}&cx={SEARCH_ENGINE_ID}&q={query}&start={start}"
 
 # make the API request
 data = requests.get(url).json()
@@ -26,7 +39,7 @@
     # extract the page url
     link = search_item.get("link")
     # print the results
-    print("="*10, f"Result #{i}", "="*10)
+    print("="*10, f"Result #{i+start-1}", "="*10)
     print("Title:", title)
     print("Description:", snippet)
     print("URL:", link, "\n")