API desenvolvida em Flask com o Intuito de realizar buscas no google e retornar as URLs em formato Json.
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 esearch_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 |
Para utilizar a API sera necessario ter o Python instalado e as seguintes Bibliotecas:
- Flask
- googletrans
- bs4
- flask_cors
- requests
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.
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
https://google-search-api-oficial.herokuapp.com/api/search_video?q=ola
https://google-search-api-oficial.herokuapp.com/api/search_video?q=ola&to_iframe=true
https://google-search-api-oficial.herokuapp.com/api/search_video?q=python&lang=en?
https://google-search-api-oficial.herokuapp.com/api/search_video?q=java&lang=en&max_results=200
https://google-search-api-oficial.herokuapp.com/api/get_news
https://google-search-api-oficial.herokuapp.com/api/translate?source=en&lang=pt
https://google-search-api-oficial.herokuapp.com/api/get_finances/?f=USD&t=BRL
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.