{"id":23031191,"url":"https://github.com/jn513/google_search_api","last_synced_at":"2025-10-14T14:15:52.692Z","repository":{"id":46212693,"uuid":"362560746","full_name":"JN513/Google_search_API","owner":"JN513","description":"API desenvolvida em Flask com o Intuito de realizar buscas no google e retornar em formato Json.","archived":false,"fork":false,"pushed_at":"2023-05-23T01:12:19.000Z","size":59,"stargazers_count":4,"open_issues_count":7,"forks_count":2,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-14T17:42:32.564Z","etag":null,"topics":["flask","flask-restful","google","google-search-using-python","python"],"latest_commit_sha":null,"homepage":"https://gvcapi.herokuapp.com/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JN513.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null},"funding":{"github":["JN513"]}},"created_at":"2021-04-28T17:55:33.000Z","updated_at":"2024-01-21T21:36:57.000Z","dependencies_parsed_at":"2025-07-14T15:31:54.545Z","dependency_job_id":"73c93170-22f4-4485-98e6-737de96bc80d","html_url":"https://github.com/JN513/Google_search_API","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/JN513/Google_search_API","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JN513%2FGoogle_search_API","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JN513%2FGoogle_search_API/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JN513%2FGoogle_search_API/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JN513%2FGoogle_search_API/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JN513","download_url":"https://codeload.github.com/JN513/Google_search_API/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JN513%2FGoogle_search_API/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279019124,"owners_count":26086679,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-14T02:00:06.444Z","response_time":60,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["flask","flask-restful","google","google-search-using-python","python"],"created_at":"2024-12-15T15:34:46.835Z","updated_at":"2025-10-14T14:15:52.674Z","avatar_url":"https://github.com/JN513.png","language":"Python","readme":"# Google_search_API\n\nAPI desenvolvida em Flask com o Intuito de realizar buscas no google e retornar as URLs em formato Json.\n\n## Rotas\n\nA API contem as seguintes rotas:\n\n| URL | Métodos | Descrição | Parâmentros |\n| -------- | ------------- | --------- | -------------|\n| `/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 |\n| `/api/search_all` | GET | Pesquisa no google com base no queryset passado e retorna as URLs dos resultados | q: str, lang: str, qtd: int  |\n| `/api/get_news` | GET | Pesquisa as ultimas noticias no Google News | qtd: int |\n| `/api/translate` | GET, POST | Traduz um texto de uma linguagem para outra | lang: str, source: str |\n| `/api/get_languages` | GET | Retorna todas as linguagens suportadas | Null |\n| `/api/get_lang_codes` | GET | Retorna o codigo de todas as linguagens suportadas | Null |\n| `/api/get_finances` | GET | Retorna o valor da cotação | f: str, t: str, r: int |\n| `/api/` | GET | Redireciona para o repositorio da API no Github | Null |\n\ncomo parâmetros é possivel utilizar:\n\n| Parâmetro | Tipo de valor | Default | Obrigatório | Descrição |\n| -------- | ------------- | ---------- | --------- | --------- |\n| q | str | null | Sim | Termo utilizado na pesquisa |\n| lang | str | pt | Não | Linguagem da pesquisa, só funciona nas rotas *search_all* e*search_video* |\n| max_results | int  | 30 | Não | Limite de resultados |\n| 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*. |\n| source | str | en | Não | Linguagem original do texto que sera traduzido, só funciona na rota *translate*. |\n| lang | str | pt | Não | Linguagem para qual o texto sera traduzido, só funciona na rota *translate*. |\n| f | str | USD | Não | Moeda base da conversão, só funciona na rota *get_finances* |\n| t | str | BRL | Não | Moeda para qual sera realizado a conversão, só funciona na rota *get_finances* |\n| r | int | 2 | Não | Quantidade de casas após a virgula, só funcionana rota *get_finances* |\n\n\n## Dependencias\n\nPara utilizar a API sera necessario ter o Python instalado e as seguintes Bibliotecas:\n\n- Flask\n- Google\n- googletrans\n- bs4\n- flask_cors\n- requests\n\n## Como instalar\n\nPara instalar as bibliotecas utilize:\n``` pip install -r requirements.txt ```\n\nRecomendo que instale as dependencias e utilize a aplicação em uma virtualenv.\n\nPara criar uma virtualenv utilize:\n``` python -m venv env ```\n\nPara ativar no Linux utilize:\n``` source env/bin/activate ```\n\nPara ativar no Windows utilize:\n``` \\env\\Bin\\activate.bat ```\n\nPara desativar tanto no Linux quanto no Windows utilize:\n``` deactivate ```\n\nNota: se você instalar em uma virtualenv toda vez que for utilizar a API sera necessario ativala.\n\n## Execução\n\nPara rodar a API localmente sera necessario exportar a variavel de ambiente \"ENV\" como \"development\".\n\nPara exportar no Linux utilize:\n``` export ENV=development ```\n\nPara exportar no Windows utilize:\n``` set ENV=development ```\n\nDepois disso utilize:\n``` python gvsearch.py ```\n\ne a API ira rodar. Caso não queira exportar variaveis de ambiente, utilize:\n``` gunicorn gvsearch:app ```\n\n## Exemplos de requisições\n\n\u003chttps://google-search-api-oficial.herokuapp.com/api/search_video?q=ola\u003e\n\n\u003chttps://google-search-api-oficial.herokuapp.com/api/search_video?q=ola\u0026to_iframe=true\u003e\n\n\u003chttps://google-search-api-oficial.herokuapp.com/api/search_video?q=python\u0026lang=en?\u003e\n\n\u003chttps://google-search-api-oficial.herokuapp.com/api/search_video?q=java\u0026lang=en\u0026max_results=200\u003e\n\n\u003chttps://google-search-api-oficial.herokuapp.com/api/get_news\u003e\n\n\u003chttps://google-search-api-oficial.herokuapp.com/api/translate?source=en\u0026lang=pt\u003e\n\n\u003chttps://google-search-api-oficial.herokuapp.com/api/get_finances/?f=USD\u0026t=BRL\u003e\n\n## Problemas e sugestões\n\nFique 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.\n","funding_links":["https://github.com/sponsors/JN513"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjn513%2Fgoogle_search_api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjn513%2Fgoogle_search_api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjn513%2Fgoogle_search_api/lists"}