API Documentation

Standart web araması sonuçlarını döner.

Parametreler

Parametre	Tip	Varsayılan	Açıklama
q	string	Zorunlu	Arama sorgusu
engines	string	Tüm motorlar	Virgülle ayrılmış motor listesi
limitTotal	number	20	Toplam sonuç sayısı (maks: 200)
limitPerEngine	number	5	Her motor için sonuç sayısı (maks: 20)
pageno	number	1	Sayfa numarası
offset	number	-	Sonuç başlangıç ofseti
region	string	-	Bölge kodu (örn: tr, us)
includeDomains	string	-	Sadece belirli domain'leri dahil et
excludeDomains	string	-	Belirli domain'leri hariç tut
cache	string	"1"	Önbellek kullanımı ("1" veya "0")
timeoutMs	number	12000	İstek zaman aşımı süresi (ms)

Örnek İstek

GET /search?q=typescript&engines=duckduckgo,brave&limitTotal=10®ion=tr

Yanıt Formatı

{
  "query": "typescript",
  "engines": ["duckduckgo", "brave"],
  "limitTotal": 10,
  "limitPerEngine": 5,
  "pageno": 1,
  "count": 8,
  "results": [
    {
      "engine": "duckduckgo",
      "title": "TypeScript: JavaScript That Scales",
      "url": "https://www.typescriptlang.org/",
      "snippet": "TypeScript is a strongly typed programming language..."
    }
  ],
  "errors": [
    {
      "engine": "brave",
      "message": "timeout_error"
    }
  ]
}

Parametreler

Parametre	Tip	Varsayılan	Açıklama
q	string	Zorunlu	Arama sorgusu
limitTotal	number	50	Toplam sonuç sayısı (maks: 200)
pageno	number	1	Sayfa numarası
cache	string	"1"	Önbellek kullanımı

Örnek İstek

GET /search/images?q=nature&limitTotal=20

Parametreler

Parametre	Tip	Varsayılan	Açıklama
q	string	Zorunlu	Arama sorgusu
limitTotal	number	30	Toplam sonuç sayısı (maks: 100)
pageno	number	1	Sayfa numarası
cache	string	"1"	Önbellek kullanımı

Örnek İstek

GET /search/videos?q=typescript+tutorial

Parametreler

Parametre	Tip	Varsayılan	Açıklama
q	string	Zorunlu	Arama sorgusu
limitTotal	number	30	Toplam sonuç sayısı (maks: 100)
pageno	number	1	Sayfa numarası
cache	string	"1"	Önbellek kullanımı

Örnek İstek

GET /search/news?q=artificial+intelligence

HTML formatında detaylı servis durumu sayfası döner.

JSON formatında servis sağlığı bilgisi döner.

Yanıt Formatı

{
  "ok": true,
  "service": "proxy",
  "now": "2026-02-27T10:33:11.291Z",
  "runtime": {
    "node": "v20.19.2",
    "pid": 25350,
    "platform": "linux",
    "arch": "x64",
    "uptimeSec": 171
  },
  "engines": {
    "supported": ["duckduckgo", "google", "brave", "startpage", "qwant", "mojeek", "ask", "marginalia"],
    "health": {
      "google": {
        "totalRequests": 10,
        "totalErrors": 2,
        "totalResults": 45,
        "avgResponseTime": 850.5,
        "lastSuccess": "2026-02-27T10:30:00.000Z",
        "lastError": "2026-02-27T10:32:00.000Z",
        "lastErrorMessage": "blocked_or_captcha"
      }
    }
  },
  "memory": {
    "rss": 109563904,
    "heapTotal": 27860992,
    "heapUsed": 20077608,
    "external": 5106692
  }
}