API Platformu

Google Görseller API

Google Görseller'de programatik olarak arama yapın.

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.

Ürün sayfası: Google Görseller API.

Kimlik Doğrulama

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

HeaderTypeAçıklama
SEMUST-API-USERstringAPI kullanıcınızın kullanıcı adı
SEMUST-API-PASSWORDstringAPI kullanıcınızın şifresi

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

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

Request Parameters

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

Body

keywordstringrequired

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

languagestringdefault: en

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

countrystringdefault: US

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

depthintegerdefault: 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.

{
  "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 -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
  }'

Response

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

Yanıt Alanları

AlanTypeAçıklama
successbooleanBaşarılı yanıtta her zaman true
result_countintegerDöndürülen görsel sayısı
keywordstringKullanılan arama anahtar kelimesi
countrystringArama için kullanılan ülke
languagestringArama için kullanılan dil
imagesarrayGörsel sonuç nesneleri dizisi
related_searchesarrayİlgili arama önerileri (boş olabilir)

Görsel Nesne Alanları

AlanTypeAçıklama
positionintegerGörselin sonuçlardaki sırası (1'den başlar)
titlestringGörselin başlığı veya adı
subtitlestringEk alt başlık veya açıklama
altstringGörselin alt metni
urlstringGörsel dosyasının doğrudan URL'si
source_urlstringGörseli içeren web sayfasının URL'si

İlgili Arama Alanları

AlanTypeAçıklama
titlestringÖnerilen ilgili arama terimi
urlstringİlgili arama URL'si (boş olabilir)
{
  "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.

HTTPKodAnlamı
400INVALID_REQUESTİstek gövdesi hatalı biçimlendirilmiş veya gerekli alanlar eksik
400KEYWORD_REQUIREDAnahtar kelime alanı boş veya eksik
401INVALID_API_KEYKimlik doğrulama başarısız — geçersiz kullanıcı adı veya şifre
402INSUFFICIENT_CREDITSHesabınızda yeterli kredi yok
200EMPTY_RESULTSBu sorgu için görsel sonuç bulunamadı
500INTERNAL_ERRORBir iç sunucu hatası oluştu
502WORKER_FAILEDWorker'dan Google Görseller sonuçları alınamadı
504TIMEOUTİstek zaman aşımına uğradı (maks 10 dakika)
{
  "error": "Your account does not have enough credits",
  "code": "INSUFFICIENT_CREDITS"
}

Krediler & Rate Limits

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.

Rate Limits

İ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.

Ö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.

Son güncelleme: 2026-08-22