Google Maps Store Photo Monitor API

Ne Yapar?

Her sabah aynı sayfaları açıp fiyat, yorum ya da içerik değişimini elle takip etmekten yorulduysanız, bu API tam bu işi sizin yerinize üstlenir. Google Maps Store Photo Monitor API canlı kaynaktan veri çeker, temizler ve tek bir cevapta size sunar. Ekipler bu çıktıyı alarm, dashboard veya otomasyon akışlarına doğrudan bağlayabilir.

Neden Bu API?

Çoğu ekip veri toplamak için ya manuel kontrol yapar ya da kırılgan betikleri sürekli yamalar. Bu da günde saatler kaybettirir. Bu API ile aynı işi saniyeler içinde tekrarlanabilir hale getirirsiniz: geliştirici ekibi “site değişti mi?” sorusuyla uğraşmaz, ürün ve büyüme ekipleri kararını canlı veriye göre verir. Pratikte günde 2-3 saatlik takip işini birkaç saniyelik çağrıya indirirsiniz.

Hızlı Başlangıç (Quick Start)

Adım 1: API Key Al

Apify hesabınızdan bir APIFY_TOKEN oluşturun.

Adım 2: İlk İstek

curl -X POST "https://api.apify.com/v2/acts/ACTOR_ID/runs?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/"}'

Adım 3: Yanıtı Yorumla

Dönüşte gelen request_id izleme için kullanılır. items alanı canlı kaynaktan çıkarılmış satırları içerir.

Endpoint Referansı

Endpoint	Method	Ne Alır	Ne Döndürür	Ne Zaman Kullanılır
/v1/health	GET	Parametre gerekmez	Servis canlılık bilgisi	Uptime kontrolü
/v1/metrics	GET	Parametre gerekmez	Çağrı/metrik özeti	Operasyon izleme
/v1/query	POST	query veya url	Temizlenmiş veri listesi	Canlı veri çekme

Örnek İstek ve Yanıt

// İstek
{"url":"https://example.com/","limit":10}
// Yanıt
{
  "request_id": "req-20260504-001",
  "items": [
    {"title": "Example Domain", "url": "https://example.com/", "source": "html:h1"}
  ],
  "source_timestamp": "2026-05-04T12:00:00+00:00",
  "errors": []
}

Hata Kodları

Kod	Ne Anlama Gelir	Ne Yapmalısınız
INVALID_INPUT	URL veya query geçersiz	Girdi formatını kontrol edin, http/https kullanın
RATE_LIMITED	Çok hızlı istek atıldı	1 saniye bekleyip tekrar deneyin; toplu çağrıda batch kullanın
UPSTREAM_FAILURE	Kaynak site/API geçici hata verdi	Retry uygulayın, 2-3 deneme yapın
INTERNAL_ERROR	Beklenmeyen servis hatası	request_id ile log kaydı açın

Fiyatlandırma

Ücretsiz planda ayda 100 istekle ürünü rahatça denersiniz. Düzenli kullanım için $9.99/ay seviyesi çoğu orta ölçekli proje için yeterli olur. Trafik büyürse istek başı veya daha yüksek planlara geçebilirsiniz.

Destek ve Sınırlar

Rate limit: 60/dk, burst 20. Cache TTL: 900 saniye. Retry: max_attempts=3, backoff_ms=[200, 500, 1200].

Çalıştırma

$python3 src/main.py

Test

$python3 -m unittest discover -s tests -p "test_*.py" -v