OpenSearchAPI

A high-performance, open-source gateway to global search results.
No restrictions, just pure data.

💎 100% Free

Completely open-source and free to use for any project except Commercial Usages.

🔑 No API Keys

Zero registration. Start querying immediately without headers.

☁️ Lightweight

Small footprint, designed to run on minimal server resources.

⚡ Fast Scraping

Optimized with headless drivers for rapid data retrieval.

S

Developed by SudoHopeX

Cyber Security (Ethical Hacking) & Open Source Dev Enthusiast

OpenSearchAPI was built to provide developers with an easy, unrestricted way to aggregate search data without the hurdles of expensive subscriptions or rate-limited API keys.

⭐ Consider giving a star if you liked this project.

Installation

Set up the OpenSearchAPI API in seconds using the command line.

Clone & Setup

git clone https://github.com/SudoHopeX/OpenSearchAPI.git
bash setup.sh

Direct Download

curl -fsL https://raw.githubusercontent.com/SudoHopeX/OpenSearchAPI/refs/heads/main/setup.sh | sudo bash

Starting via Launcher ( in Linux )

Runs in foreground

opensearchapi

Runs in background

opensearchapi --bg

Starting via python

Runs in foreground

python /path/to/app.py

OR

python3 /path/to/app.py

Requirements

Ensure your environment meets these specifications for optimal performance.



1. System Packages

Python 3.13+
python-venv
python-pip
xvfb
Chrome / Chromium Browser


2. Pip Packages

requests
flask
beautifulsoup4
curl_cffi
nodriver
ddgs
pyvirtualdisplay

Endpoints

Access various search engines through a unified interface.

Documentation

GET http://{{ host }}/

Standard Search

GET http://{{ host }}/search?q=query&engine=duckduckgo

Multi-Engine (Mega)

GET http://{{ host }}/mega/search?q=query&engines=google,bing


Supported Engines

Google
DuckDuckGo
Bing

Usage Examples

Integrate the API into your project using these common snippets.

Curl

curl http://{{ host }}/search?q=SudoHopeX&engine=duckduckgo
curl http://{{ host }}/mega/search?q=SudoHopeX&engines=duckduckgo,google,bing

Python Requests

import requests

query = "Photography"
engine = "google"
url = f"http://{{ host }}/search&q={query}&engine={engine}"
data = requests.get(url).json()
print(data)