Google Görseller API

POST

Google Görseller'de programatik olarak arama yapın. Herhangi bir anahtar kelime, dil ve ülke için başlık, URL, kaynak sayfa ve ilgili aramalar içeren görsel sonuçları alın.

POST https://data.semust.com/v1/google-images

Kimlik Doğrulama

Tüm istekler başlık tabanlı kimlik doğrulama gerektirir. Her istekte API kimlik bilgilerinizi ekleyin.

Başlık	Tür	Açıklama
`SEMUST-API-USER`	string	API kullanıcı adınız
`SEMUST-API-PASSWORD`	string	API şifreniz

API kimlik bilgilerini API Erişim sayfasında doğrulayabilirsiniz.

İstek Başlıkları

SEMUST-API-USER: your_username
SEMUST-API-PASSWORD: your_password

İstek Parametreleri

Aşağıdaki parametrelerle bir application/json gövdesi gönderin:

keyword

string

gerekli

Google Görseller için arama sorgusu (ör: "istanbul manzara", "modern mimari").

language

stringvarsayılan: "en"

Dil kodu (ISO 639-1). Arama sonuçlarının dilini kontrol eder. Örnekler: "en", "tr", "de", "fr", "es".

country

stringvarsayılan: "US"

Ülke kodu (ISO 3166-1 alpha-2). Görsel sonuçlarını belirli bir ülkeye yönlendirir. Örnekler: "US", "TR", "DE", "GB".

depth

integervarsayılan: 100

Döndürülecek görsel sonuç sayısı. Minimum: 1, Maksimum: 700. Varsayılan: 100. Yüksek değerler daha fazla sonuç döndürür ancak maliyeti artırabilir.

Derinlik Limiti: Depth parametresi 1 ile 700 arasında olmalıdır. Yüksek değerler daha fazla görsel döndürür ancak işlem süresini ve maliyeti artırır.

İstek Gövdesi

{
  "keyword": "istanbul manzara",
  "language": "tr",
  "country": "TR",
  "depth": 10
}

Kod Örnekleri

Farklı programlama dillerinde Google Görseller API'yi nasıl kullanacağınızı gösteren örnekler.

cURL

curl -X POST https://data.semust.com/v1/google-images \
  -H "Content-Type: application/json" \
  -H "SEMUST-API-USER: your_username" \
  -H "SEMUST-API-PASSWORD: your_password" \
  -d '{
    "keyword": "istanbul manzara",
    "language": "tr",
    "country": "TR",
    "depth": 10
  }'

Yanıt

Görsel sonuçları ve ilgili arama önerilerini içeren bir JSON nesnesi döndürür.

Yanıt Alanları

Alan	Tür	Açıklama
`success`	boolean	Başarılı yanıtta her zaman true
`result_count`	integer	Döndürülen görsel sayısı
`keyword`	string	Kullanılan arama anahtar kelimesi
`country`	string	Arama için kullanılan ülke
`language`	string	Arama için kullanılan dil
`images`	array	Görsel sonuç nesneleri dizisi
`related_searches`	array	İlgili arama önerileri (boş olabilir)

Görsel Nesne Alanları

Alan	Tür	Açıklama
`position`	integer	Görselin sonuçlardaki sırası (1'den başlar)
`title`	string	Görselin başlığı veya adı
`subtitle`	string	Ek alt başlık veya açıklama
`alt`	string	Görselin alt metni
`url`	string	Görsel dosyasının doğrudan URL'si
`source_url`	string	Görseli içeren web sayfasının URL'si

İlgili Arama Alanları

Alan	Tür	Açıklama
`title`	string	Önerilen ilgili arama terimi
`url`	string	İlgili arama URL'si (boş olabilir)

Başarılı Yanıt

{
  "success": true,
  "result_count": 10,
  "keyword": "istanbul manzara",
  "country": "TR",
  "language": "tr",
  "images": [
    {
      "position": 1,
      "title": "İstanbul Boğazı Manzarası",
      "subtitle": "Galata Kulesi'nden çekilmiş",
      "alt": "Istanbul Bosphorus view at sunset",
      "url": "https://example.com/images/istanbul-bosphorus.jpg",
      "source_url": "https://example.com/istanbul-photos"
    },
    {
      "position": 2,
      "title": "İstanbul Silueti",
      "subtitle": "",
      "alt": "Istanbul skyline panorama",
      "url": "https://example.com/images/istanbul-skyline.jpg",
      "source_url": "https://example.com/travel-gallery"
    }
  ],
  "related_searches": [
    {
      "title": "istanbul gece manzarası",
      "url": ""
    },
    {
      "title": "istanbul boğaz manzarası",
      "url": ""
    }
  ]
}

Hata Kodları

Tüm hatalar, insan tarafından okunabilir bir mesaj ve bir hata kodu içeren bir JSON nesnesi döndürür.

Durum	Kod	Açıklama
400	`INVALID_REQUEST`	İstek gövdesi hatalı biçimlendirilmiş veya gerekli alanlar eksik
400	`KEYWORD_REQUIRED`	Anahtar kelime alanı boş veya eksik
401	`INVALID_API_KEY`	Kimlik doğrulama başarısız — geçersiz kullanıcı adı veya şifre
402	`INSUFFICIENT_CREDITS`	Hesabınızda yeterli kredi yok
200	`EMPTY_RESULTS`	Bu sorgu için görsel sonuç bulunamadı
500	`INTERNAL_ERROR`	Bir iç sunucu hatası oluştu
502	`WORKER_FAILED`	Worker'dan Google Görseller sonuçları alınamadı
504	`TIMEOUT`	İstek zaman aşımına uğradı (maks 10 dakika)

Hata Yanıtı

{
  "error": "Your account does not have enough credits",
  "code": "INSUFFICIENT_CREDITS"
}

Krediler & Hız Sınırları

Krediler

Her istek, depth parametresine bağlı olarak bakiyenizden kredi tüketir. Bakiyeniz yetersizse API HTTP 402 döndürür. Başarısız istekler otomatik olarak iade edilir.

Önbellekleme

Yanıtlar 24 saat boyunca önbelleğe alınır. Aynı anahtar kelime, dil, ülke ve depth ile yapılan tekrar istekler, ek kredi maliyeti olmadan önbellekten sunulur.

Hız Sınırları

İstekler, planınıza göre dakika başına ve gün başına sınırlara tabidir. Sınırların aşılması HTTP 429 döndürür.