OpenSERP provides free API and CLI access to multiple search engines including [Google, Yandex, Baidu, Bing, DuckDuckGo]. Get comprehensive search results without expensive API subscriptions!
- 🔍 Multi-Engine Support: Google, Yandex, Baidu, Bing, DuckDuckGo...
- 🌐 Megasearch: Aggregate results from multiple engines simultaneously
- 🖼 Images: Image search is also available!
- 🎯 Advanced Filtering: Language, date range, file type, site-specific searches
- 🌍 Proxy Support: HTTP/SOCKS5 proxy support
- 🐳 Docker Ready: Easy deployment with Docker
# Run the API server via prebuilt image docker run -p 127.0.0.1:7000:7000 -it karust/openserp serve -a 0.0.0.0 -p 7000 # Or use docker-compose docker compose up --build# Clone and build git clone https://github.com/karust/openserp.git cd openserp go build -o openserp . # Run the server ./openserp serveMegasearch aggregates results from multiple engines simultaneously with automatic deduplication. Megaimage does the same for image searches!
# Search ALL engines at once curl "http://localhost:7000/mega/search?text=golang&limit=10" # Pick specific engines curl "http://localhost:7000/mega/search?text=golang&engines=duckduckgo,bing&limit=15" # Advanced filtering curl "http://localhost:7000/mega/search?text=Donald+Trump&engines=duckduckgo,bing&limit=20&date=20251005..20251005&lang=EN"- API response example:
[ { "rank": 1, "url": "https://en.wikipedia.org/wiki/Golden_Retriever", "title": "Golden Retriever - Wikipedia", "description": "The Golden Retriever is a Scottish breed of retriever dog of medium size. It is characterised by a gentle and affectionate nature and a striking golden coat. It is a working dog, and registration is subject to successful completion of a working trial. [2] It is commonly kept as a companion dog and is among the most frequently registered breeds in several Western countries; some may compete in ...", "ad": false, "engine": "duckduckgo" }, { "rank": 2, "url": "https://www.bing.com/ck/a?!&&p=6f15ac4589858d0a104cd6f55cc8e91e8d8d6da91f905b626921f67f2323a467JmltdHM9MTc1OTE5MDQwMA&ptn=3&ver=2&hsh=4&fclid=2357c2f4-6131-68de-359f-d48c607c691d&u=a1aHR0cHM6Ly93d3cuZ29sZGVucmV0cmlldmVyZm9ydW0uY29tL3RocmVhZHMvdW5kZXJzdGFuZGluZy13aHktZ29sZGVuLXJldHJpZXZlciVFMiU4MCU5OXMtbGlmZXNwYW4taGFsdmVkLWluLXRoZS1sYXN0LTM1LXllYXJzLjM1NzMyMi8&ntb=1", "title": "Golden Retriever Dog Forums\nhttps://www.goldenretrieverforum.com › threads › understanding-why-g...", "description": "Oct 20, 2024 · Back in the 1970s, Golden Retrievers routinely lived until 16 and 17 years old, they are now living until 9 or 10 years old. Golden Retrievers seem to be dying mostly of bone ...", "ad": false, "engine": "bing" }, { "rank": 3, "url": "http://www.baidu.com/link?url=2544q3ugc68j0scVxdpWCSX-gl2AmuCy1l7uRR3loIfS1hmJWMiJKW4MDGWoZrLE7X-ybu1L7T8PspoL7iy_dK", "title": "golden retrievers是什么意思_golden retrievers怎么读_解释_用法...", "description": "\n\n2025年9月21日golden retrievers 读音:美英 golden retrievers基本解释 金毛猎犬 分词解释 golden金(黄)色的 retrievers寻猎物犬( retriever的名词复数 ) 词组短语 golden retrieversfor sale出售金毛寻回犬 golden retrieversnear me我附近的金毛寻回犬 golden retrieverspuppies金毛寻回犬幼犬...\ndanci.gei6.com/golden...retrievers...", "ad": false, "engine": "baidu" } ]# Search images across ALL engines curl "http://localhost:7000/mega/image?text=golang logo&limit=20"# Check which engines are available curl "http://localhost:7000/mega/engines"Available engines: google, yandex, baidu, bing, duckduckgo
| Parameter | Description | Example |
|---|---|---|
text | Search query | golang programming |
lang | Language code | EN, DE, RU, ES |
date | Date range | 20230101..20231231 |
file | File extension | PDF, DOC, XLS |
site | Site-specific search | github.com, stackoverflow.com |
limit | Number of results | 10, 25, 50 |
| Parameter | Supported engines | Notes |
|---|---|---|
start | google, bing, yandex, baidu | Web search pagination offset. |
filter | google | Duplicate filter (true => hide similar, false => include similar). |
answers | google | Include Google answer boxes in output (negative ranks). |
# DuckDuckGo search curl "http://localhost:7000/duck/search?text=golang&limit=7" # Google search curl "http://localhost:7000/google/search?text=golang&lang=EN&limit=10" # Google search (pagination + include similar/hidden results) curl "http://localhost:7000/google/search?text=golang&lang=EN&limit=10&start=10&filter=false" # Bing search (offset 20 => around page 3 for 10 results/page) curl "http://localhost:7000/bing/search?text=golang&limit=10&start=20" # Yandex search (offset 10 => second page) curl "http://localhost:7000/yandex/search?text=golang&limit=10&start=10"# Bing Images curl "http://localhost:7000/bing/image?text=golang&limit=20" # Baidu Images curl "http://localhost:7000/baidu/image?text=golang&limit=15"OpenSERP supports HTTP and SOCKS5 proxies with authentication:
# SOCKS5 proxy ./openserp serve --proxy socks5://127.0.0.1:1080 # HTTP proxy with authentication ./openserp search bing "query" --proxy http://user:pass@127.0.0.1:8080curl -i "http://127.0.0.1:7000/health"Response includes:
status:healthy,degraded, orunhealthyuptime- per-engine readiness in
engines - basic runtime stats in
system
HTTP status behavior:
200forhealthyanddegraded503forunhealthy
This project is licensed under the MIT License - see the LICENSE file for details.
Contributions are welcome! Please feel free to submit a Pull Request.
If you encounter any issues or have questions:
- Open an issue on GitHub
- Check existing issues for solutions
- Review the documentation above
