API referansı

REST API normalleştirilmiş otel kayıtları sunar. Tüm istekler bir proje API anahtarı gerektirir.

Kimlik doğrulama

Anahtarını bearer token olarak gönder. Anahtarları paneldeki bir projenin sayfasından oluştur.

Authorization başlığı

Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx

Otelleri getir

GET /v1/hotels

Anahtarın projesine kapsamlı normalleştirilmiş otel kayıtlarını döndürür.

Sorgu parametreleri

city — şehre göre filtrele (büyük/küçük harf duyarsız)
country — 2 harfli ülke kodu
min_price / max_price — fiyat aralığı
available — yalnızca müsait otelleri döndürmek için true
limit — maksimum sonuç (varsayılan 50, en fazla 200)

İstek

curl "https://your-app.vercel.app/v1/hotels?city=istanbul&min_price=80&limit=2" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx"

200 OK

{
  "data": [
    {
      "name": "Grand Bosphorus Hotel",
      "city": "Istanbul",
      "country": "TR",
      "stars": 5,
      "price": 142.0,
      "currency": "EUR",
      "availability": "available",
      "sourceId": "src_...",
      "extractedAt": "2026-09-24T10:22:00.000Z"
    }
  ],
  "count": 1
}

Hatalar

401 — eksik veya geçersiz API anahtarı
402 — kota aşıldı veya yetersiz kredi
403 — anahtar iptal edildi
400 — geçersiz sorgu parametresi
429 — çok fazla istek (hız sınırı)