Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jn513/google_search_api
API desenvolvida em Flask com o Intuito de realizar buscas no google e retornar em formato Json.
https://github.com/jn513/google_search_api
flask flask-restful google google-search-using-python python
Last synced: 18 days ago
JSON representation
API desenvolvida em Flask com o Intuito de realizar buscas no google e retornar em formato Json.
- Host: GitHub
- URL: https://github.com/jn513/google_search_api
- Owner: JN513
- License: mit
- Created: 2021-04-28T17:55:33.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2022-10-25T00:45:28.000Z (about 2 years ago)
- Last Synced: 2023-03-06T05:21:38.182Z (almost 2 years ago)
- Topics: flask, flask-restful, google, google-search-using-python, python
- Language: Python
- Homepage: https://gvcapi.herokuapp.com/
- Size: 47.9 KB
- Stars: 5
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE.md
Awesome Lists containing this project
README
# Google_search_API
API desenvolvida em Flask com o Intuito de realizar buscas no google e retornar as URLs em formato Json.
## Rotas
A API contem as seguintes rotas:
| URL | Métodos | Descrição | Parâmentros |
| -------- | ------------- | --------- | -------------|
| `/api/search_video` | GET | Pesquisa videos no google com base no queryset passado e retorna as URLs dos mesmos | q: str, lang: str, qtd: int |
| `/api/search_all` | GET | Pesquisa no google com base no queryset passado e retorna as URLs dos resultados | q: str, lang: str, qtd: int |
| `/api/get_news` | GET | Pesquisa as ultimas noticias no Google News | qtd: int |
| `/api/translate` | GET, POST | Traduz um texto de uma linguagem para outra | lang: str, source: str |
| `/api/get_languages` | GET | Retorna todas as linguagens suportadas | Null |
| `/api/get_lang_codes` | GET | Retorna o codigo de todas as linguagens suportadas | Null |
| `/api/get_finances` | GET | Retorna o valor da cotação | f: str, t: str, r: int |
| `/api/` | GET | Redireciona para o repositorio da API no Github | Null |
como parâmetros é possivel utilizar:
| Parâmetro | Tipo de valor | Default | Obrigatório | Descrição |
| -------- | ------------- | ---------- | --------- | --------- |
| q | str | null | Sim | Termo utilizado na pesquisa |
| lang | str | pt | Não | Linguagem da pesquisa, só funciona nas rotas *search_all* e*search_video* |
| max_results | int | 30 | Não | Limite de resultados |
| to_iframe | bool | false/0 | Não | Converte o link do youtube para um link pronto para ser usado em um iframe, só funciona na rota *search_video*. |
| source | str | en | Não | Linguagem original do texto que sera traduzido, só funciona na rota *translate*. |
| lang | str | pt | Não | Linguagem para qual o texto sera traduzido, só funciona na rota *translate*. |
| f | str | USD | Não | Moeda base da conversão, só funciona na rota *get_finances* |
| t | str | BRL | Não | Moeda para qual sera realizado a conversão, só funciona na rota *get_finances* |
| r | int | 2 | Não | Quantidade de casas após a virgula, só funcionana rota *get_finances* |
## Dependencias
Para utilizar a API sera necessario ter o Python instalado e as seguintes Bibliotecas:
- Flask
- Google
- googletrans
- bs4
- flask_cors
- requests
## Como instalar
Para instalar as bibliotecas utilize:
``` pip install -r requirements.txt ```
Recomendo que instale as dependencias e utilize a aplicação em uma virtualenv.
Para criar uma virtualenv utilize:
``` python -m venv env ```
Para ativar no Linux utilize:
``` source env/bin/activate ```
Para ativar no Windows utilize:
``` \env\Bin\activate.bat ```
Para desativar tanto no Linux quanto no Windows utilize:
``` deactivate ```
Nota: se você instalar em uma virtualenv toda vez que for utilizar a API sera necessario ativala.
## Execução
Para rodar a API localmente sera necessario exportar a variavel de ambiente "ENV" como "development".
Para exportar no Linux utilize:
``` export ENV=development ```
Para exportar no Windows utilize:
``` set ENV=development ```
Depois disso utilize:
``` python gvsearch.py ```
e a API ira rodar. Caso não queira exportar variaveis de ambiente, utilize:
``` gunicorn gvsearch:app ```
## Exemplos de requisições
## Problemas e sugestões
Fique a vontade para dar sua sujestão ou relatar algum problema na sessão Issues do Git-Hub, caso queira contribuir fique a vontade para criar uma nova branch e realizar um Pull-Request.