API Referansı

Proxy Dokümentasyonu Güncellendi Feb 28, 2026

ArtadoProxy, yüksek performanslı meta-arama sonuçlarını JSON formatında sunar.

1. Web Arama

Genel web sonuçlarını getirmek için kullanılır.

GET /search

Sorgu Parametreleri

Parametre	Tip	Varsayılan	Açıklama
`q`	string	Zorunlu	Arama yapılacak anahtar kelime.
`engines`	string	Hepsi	Virgülle ayrılmış motorlar (örn: `duckduckgo,brave`).
`limitTotal`	number	20	Dönecek maksimum toplam sonuç sayısı (Maks: 200).
`limitPerEngine`	number	5	Her motor başına çekilecek maksimum sonuç.
`region`	string	-	Bölge kodu (örn: `tr`, `us`, `uk`).
`cache`	string	"1"	Önbellek kullanımı (`1` aktif, `0` kapalı).

2. Medya ve Haber Araması

Farklı içerik türleri için özelleşmiş uç noktalar:

Görsel Arama: GET /search/images?q=typescript
Video Arama: GET /search/videos?q=nature
Haber Arama: GET /search/news?q=teknoloji

3. Yanıt Formatı (Örnek)

Tüm arama istekleri aşağıdaki standart yapıda döner:

{
  "query": "typescript",
  "engines": ["duckduckgo", "brave"],
  "count": 15,
  "results": [
    {
      "engine": "duckduckgo",
      "title": "TypeScript: JavaScript That Scales",
      "url": "[https://www.typescriptlang.org/](https://www.typescriptlang.org/)",
      "snippet": "TypeScript is a strongly typed programming language..."
    }
  ],
  "errors": [
    {
      "engine": "brave",
      "message": "timeout_error"
    }
  ]
}

4. Sistem Durumu (Status)

GET /status uç noktası, servis hakkında teknik detaylar ve motorların anlık sağlık durumunu HTML olarak döner. JSON formatında sistem bilgisi almak için /health rotasını kullanın.