Asyncio API wrapper for the Google Custom Search JSON API.
pip install -U cse.py
pip3 install -U git+https://github.com/Hype3808/cse.py
import cse
client = cse.Engine("Your API Key") # create the Search client (uses Google by default!)
results = await client.search("Python", safesearch=False) # returns a list of cse.Result objects
print(results[0].title, results[0].description, results[0].url, results[0].image_url) # Title, snippet, URL, and Image URL
await client.close() # Run this when cleaning up.
import cse
client = cse.Engine("Your API Key") # create the Search client (uses Google by default!)
results = await client.search("Python", safesearch=False, image_search=True) # returns a list of cse.Result objects
print(results[0].title, results[0].description, results[0].url, results[0].image_url) # Title, snippet, URL, and Image URL
await client.close() # Run this when cleaning up.
To use Search objects with a custom search engine, provide the ID of the search engine.
cse.Engine("Your API Key", engine_id="015786823554162166929:mywctwj8es4")
SafeSearch can also be turned off by setting safesearch=False
when using the search()
method.
You can get an API key by going here and scrolling down to the API key section.