{"id":13733912,"url":"https://github.com/fossasia/query-server","last_synced_at":"2025-05-15T18:07:43.695Z","repository":{"id":43175003,"uuid":"74786144","full_name":"fossasia/query-server","owner":"fossasia","description":"Query Server Search Engines","archived":false,"fork":false,"pushed_at":"2021-01-23T16:48:56.000Z","size":5323,"stargazers_count":1669,"open_issues_count":27,"forks_count":264,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-31T22:18:25.761Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fossasia.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2016-11-25T20:24:01.000Z","updated_at":"2025-03-23T19:11:27.000Z","dependencies_parsed_at":"2022-09-13T21:41:11.745Z","dependency_job_id":null,"html_url":"https://github.com/fossasia/query-server","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fossasia%2Fquery-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fossasia%2Fquery-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fossasia%2Fquery-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fossasia%2Fquery-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fossasia","download_url":"https://codeload.github.com/fossasia/query-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247744332,"owners_count":20988783,"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","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":[],"created_at":"2024-08-03T03:00:50.830Z","updated_at":"2025-04-07T23:08:02.068Z","avatar_url":"https://github.com/fossasia.png","language":"Python","funding_links":[],"categories":["Apps deployable on Scalingo"],"sub_categories":["Apps deployed without adaptation"],"readme":"# Query-Server\n\n[![Build Status](https://travis-ci.org/fossasia/query-server.svg?branch=master)](https://travis-ci.org/fossasia/query-server)\n[![Dependency Status](https://david-dm.org/fossasia/query-server.svg)](https://david-dm.org/ossasia/query-server)\n[![Join the chat at https://gitter.im/fossasia/query-server](https://badges.gitter.im/fossasia/query-server.svg)](https://gitter.im/fossasia/query-server?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n[![codecov](https://codecov.io/gh/fossasia/query-server/branch/master/graph/badge.svg)](https://codecov.io/gh/fossasia/query-server)\n\nThe query server can be used to search a keyword/phrase on a search engine (Google, Yahoo, Bing, Ask, DuckDuckGo, Baidu, Exalead, Quora, Parsijoo, Dailymotion, Mojeek and Youtube) and get the results as `json`, `xml` or `csv`. The tool also stores the searched query string in a MongoDB database for analytical purposes.\n\n[![Deploy to Docker Cloud](https://files.cloud.docker.com/images/deploy-to-dockercloud.svg)](https://cloud.docker.com/stack/deploy/?repo=https://github.com/fossasia/query-server) [![Deploy](https://www.herokucdn.com/deploy/button.svg)](https://heroku.com/deploy?template=https://github.com/fossasia/query-server) [![Deploy on Scalingo](https://cdn.scalingo.com/deploy/button.svg)](https://my.scalingo.com/deploy?source=https://github.com/fossasia/query-server#master) [![Deploy to Bluemix](https://bluemix.net/deploy/button.png)](https://bluemix.net/deploy?repository=https://github.com/fossasia/query-server\u0026branch=master)\n\n## Table of Contents\n\n- [Test Deployment](#test-deployment)\n- [API](#api)\n- [Error Codes](#error-codes)\n- [Dependencies](#dependencies)\n- [Installation](#installation)\n- [Contribute](#contribute)\n\n## Test Deployment\n\nA test deployment of the project is available here: https://query-server.herokuapp.com\n\n## API\n\nThe API(s) provided by query-server are as follows:\n\n` GET /api/v1/search/\u003csearch-engine\u003e?query=query\u0026format=format `\n\n\u003e *search-engine* : [`google`, `ask`, `bing`, `duckduckgo`, `yahoo`, `baidu`, `exalead`, `quora`, `youtube`, `parsijoo`, `mojeek`, `dailymotion`]\n\n\u003e *query* : query can be any string \n\n\u003e *format* : [`json`, `xml`, `csv`]\n\nA sample query : `/api/v1/search/bing?query=fossasia\u0026format=xml\u0026num=10`\n\n## Error Codes\n    404 Not Found : Incorrect Search Engine, Zero Response\n    400 Bad Request : query and/or format is not in the correct format\n    500 Internal Server Error : Server Error from Search Engine\n\n## Dependencies\n\n* [MongoDB](https://www.mongodb.com)\n* [Python 2.7](https://python.org)\n    * [BeautifulSoup4](https://www.crummy.com/software/BeautifulSoup/bs4/doc)\n    * [dicttoxml](https://github.com/quandyfactory/dicttoxml)\n    * [Flask](http://flask.pocoo.org)\n    * [pymongo](https://api.mongodb.com/python/current)\n    * [requests](http://docs.python-requests.org)\n* [Node.js](https://nodejs.org/en)\n    * [bower.io](https://bower.io)\n\n## Installation\n\n1. [Local Installation](/docs/installation/local.md)\n\n2. [Deployment on Heroku](/docs/installation/heroku.md)\n\n3. [Deployment with Docker](/docs/installation/docker.md)\n\n\n## Contribute\n\nFound an issue? Post it in the [issue tracker](https://github.com/fossasia/query-server/issues)  For pull requests please read [Open Source Developer Guide and Best Practices at FOSSASIA](https://blog.fossasia.org/open-source-developer-guide-and-best-practices-at-fossasia/)\n\n## License\n\nThis project is currently licensed under the Apache License version 2.0. A copy of `LICENSE` should be present along with the source code. To obtain the software under a different license, please contact [FOSSASIA](http://blog.fossasia.org/contact/).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffossasia%2Fquery-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffossasia%2Fquery-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffossasia%2Fquery-server/lists"}