Metadata-Version: 2.1
Name: google-custom-search
Version: 0.2.1
Summary: This is for google custom search api.
Home-page: https://github.com/tuna2134/google-custom-search
Author: DMS
Author-email: masato190411@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Description-Content-Type: text/markdown
Requires-Dist: requests
Provides-Extra: async
Requires-Dist: aiohttp (>=3.8.1) ; extra == 'async'

# google-custom-search

[![Downloads](https://pepy.tech/badge/google-custom-search)](https://pepy.tech/project/google-custom-search)

# How to use this package.

## Next version can search image.

## first please install this package
```bash
pip install google-custom-search
```
or if you want use async/await, please install.
```bash
pip install google-custom-search[async]
```

## sample code
```py
import google_custom_search

google = google_custom_search.custom_search(apikey="your api_key", engine_id="your engine_id")
# if image is True, it's can search, but you need to setting at google console search

result = google.search("Hello")

# get a list of title.
for title in result.titles:
    print(title)
  
# get a list of link.
for url in result.urls:
    print(url)
  
# get a list of displayLink.
for i in result.display_urls:
    print(i)

# get a list of htmlTitle.
for i in result.html_titles:
    print(i)
  
# get a list of snippet.
for i in result.snippets:
    print(i)
```

## sample code async version
```py
import asyncio
import google_custom_search

google = google_custom_search.custom_search(token="your api_key", engine_id="your engine_id", image=True)
# if image is True, it's can search, but you need to setting at google console search

async def main():
    result = await google.search_async("word!")
    for i in result.titles:
        print(i)
    for i in result.urls:
        print(i)
    for i in result.display_urls:
        print(i)
    for i in result.html_titles:
        print(i)
    for i in result.snippets:
        print(i)
    
loop = asyncio.get_event_loop() 
loop.run_until_complete(main())
```


