Query-Server

The query server can be used to search a keyword/phrase on a search engine (Google, Yahoo, Bing, Ask, DuckDuckGo, Yandex, Baidu, Exalead, Quora, Parsijoo and Youtube) and get the results as json or xml. The tool also stores the searched query string in a MongoDB database for analytical purposes.

Table of Contents

• API
• Error Codes
• Dependencies
• Installation
• Usage
• Contribute

API

The API(s) provided by query-server are as follows:

GET /api/v1/search/<search-engine>?query=query&format=format

search-engine : [google, ask, bing, duckduckgo, yahoo, yandex, baidu, exalead, quora, youtube, parsijoo, mojeek]

query : query can be any string

format : [json, xml]

A sample query : /api/v1/search/bing?query=fossasia&format=xml&num=10

Error Codes

404 Not Found : Incorrect Search Engine, Zero Response
400 Bad Request : query and/or format is not in the correct format
500 Internal Server Error : Server Error from Search Engine

Dependencies

• MongoDB
• Python 2.7
  • BeautifulSoup4
  • dicttoxml
  • Flask
  • pymongo
  • requests
• Node.js
  • bower.io

Installation

1. Local Installation

2. Deployment on Heroku

3. Deployment with Docker

One-click Docker and Heroku deployment is also available:

Contribute

Found an issue? Post it in the issue tracker For pull requests please read Open Source Developer Guide and Best Practices at FOSSASIA

License

This 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.