Google Reverse Image Search

Installation

Download the src folder or download from pip with the terminal command (below)

Run the command in your local terminal with a Virtual Environment (https://docs.python.org/3/library/venv.html#creating-virtual-environments)

> python -m venv your_venv_name

# Downloading from GitHub 
> pip install -r ./path/to/requirements.txt

# Downloading from pip
> pip install google-reverse-image-search

> playwright install chromium

Note : Only works for Chrome (for now but likely won't change)

Usage

Import all functions from the file with

from google_reverse_image_search import google_reverse_search

Then start anywhere with the three basic functions

print(google_reverse_search.search_with_query(query="your query"))
print(google_reverse_search.search_with_url(url="https://link/to/photo"),num=5)
print(google_reverse_search.search_with_file(file_path="C:/path/to/file",num=20))

Examples

All three functions will return the images in a similar manner

Code

res:dict = google_reverse_search.search_with_query(query="boats",num=3)
print(res)

Results

Formatted for easier reading

Connected...
Navigating...
Getting results...
Formatting results...
{'title': 'boats', 
    'data': [
        {'link': 'https://www.discoverboating.com/sites/default/files/small-boats_1.jpg', 'name': 'The Ultimate Guide to Small Boats | Discover Boating', 'dimensions': [1200, 795]}, 
        {'link': 'https://d1nkxkz7ge96ao.cloudfront.net/eyJidWNrZXQiOiJzbW4tbWFpbi1zaXRlLWJ1Y2tldCIsImtleSI6ImltYWdlc1wvaW1hZ2luXC9McktPcmhFcE5FN0FNV3lFQUxRMUpFOE0wTjVsc1VkekxsNU9ZcEZsLmpwZyIsImVkaXRzIjp7InJlc2l6ZSI6eyJ3aWR0aCI6MjYwMCwiaGVpZ2h0IjoxMzAwLCJmaXQiOiJjb3ZlciJ9fX0=', 'name': "Family-Friendly Offshore Center Consoles & Bay Boats from 20' to 35' |  Sportsman Boats", 'dimensions': [2600, 1300]}, 
        {'link': 'https://cdn.britannica.com/27/166127-050-5E3F9372/salmon-fishing-boat-Alaska.jpg', 'name': 'Boat | Definition, History, Types, & Facts | Britannica', 'dimensions': [1600, 1075]}
    ]
}

Bugs and Issues

Please raise any issues you have on the Issues forum, and I'll take a look and fix it 🙏