Birkaç ay önce, Stack Overflow’da bir geliştirici 2012’den beri açık olan bir soru paylaştı: "Google Places API Place Details 5 yorumla mı sınırlı?" On dört yıl, yüzlerce upvote ve cevap hâlâ aynı: evet, en fazla beş yorum. Tek başına bu sınırlama bile bu tartışmanın neden hâlâ sürdüğünü anlatıyor.
Eğer Google Places verisine büyük ölçekte ihtiyaç duyduysanız — potansiyel müşteri listeleri, rakip yorumları, yaya trafiği örüntüleri, yerel SEO denetimleri — muhtemelen aynı yol ayrımına geldiniz. Resmî Google Places API temiz, yapılandırılmış ve iyi dokümante edilmiş. Ancak Google Maps sayfasında görebildiğiniz her şeyi döndürmüyor; ücretsiz kota aşılınca da fatura hızla kabarabiliyor. Scraping daha fazla veri yakalar, maliyeti farklıdır ve kendi dertleriyle gelir (CAPTCHA, bozulan seçiciler, yasal gri alanlar). Ben iki tarafı da uzun süre inceledim — API dokümanlarını, fiyatlandırma kalemlerini, scraping araç zincirini ve gerçek hayattaki ödünleri — ve bu yazı bunun sonucu. Alan bazında veri eksiklerini, 10K/100K/1M kayıt ölçeğinde gerçek maliyetleri, anti-bot gerçeğini ve pratik bir hibrit yaklaşımı ele alacağız. Bir de karar akış şeması var; çünkü kimse 3.000 kelime okuyup hâlâ ne seçeceğini bilememek istemez.
Google Places API Nedir ve Gerçekte Ne Verir?
Google Places API, işletme verilerini — ad, adres, telefon, puan, yorumlar, fotoğraflar — Google’ın veritabanından çekmenin resmî ve yapılandırılmış yoludur. Bir HTTP isteği gönderirsiniz, karşılığında düzenli JSON alırsınız. Bu, Google’ın onayladığı hattır.
Mevcut sürüm olan Places API "New", her şeyi field mask mantığıyla yönetir. Place Details çağırırken hangi alanları istediğinizi tek tek belirtirsiniz — displayName, formattedAddress, rating, reviews, photos vb. — ve Google size, talep ettiğiniz en yüksek seviye alanın ücretini yansıtır. Field mask belirtmezseniz varsayılan bir yanıt yerine hata alırsınız. Bu bilinçli bir tasarımdır: Google yalnızca kullandığınız kadar ödemenizi ister (ve daha değerli alanlar için daha fazlasını).
Kullanılabilen alanlar fiyatlandırma katmanlarına ayrılır:
| Katman | Örnek Alanlar | Ne Sağlar |
|---|---|---|
| Essentials | Place ID, biçimlendirilmiş adres, konum, fotoğraf meta verileri | Temel kimlik ve konum bilgisi |
| Pro | Görünen ad, işletme durumu, Google Maps URI, ana kategori | Daha zengin işletme bilgisi |
| Enterprise | Puan, kullanıcı puan sayısı, web sitesi, telefon numaraları, çalışma saatleri, fiyat seviyesi | İş kullanıcılarının gerçekten istediği alanlar |
| Enterprise + Atmosphere | Yorumlar, yorum özeti, üretken özet, olanaklar, park, paket servis/teslimat | En zengin (ve en pahalı) veri |
Çoğu kullanıcının önem verdiği başlıca uç noktalar: Autocomplete (yazdıkça arama), Text Search ve Nearby Search (mekân keşfi), Place Details (bilinen bir yeri zenginleştirme) ve Place Photos (görseller).
Şimdi önemli sınırlamalar:
- Yorumlar: Place resource bir yer için en fazla 5 yorum döndürür, üstelik bunlar alaka düzeyine göre sıralanır. Hepsi bu. 50 değil, "tümü" değil. Beş.
- Fotoğraflar: Place resource içinde yer başına en fazla 10 fotoğraf referansı bulunur.
- Popüler saatler / canlı yoğunluk: Standart Places API alanı olarak sunulmaz. Google’ın bu verinin varlığını doğruladığı tüketici yüzlü yüzeyler vardır (toplu ve anonimleştirilmiş Location History’den beslenir); Maps blogu bunun nasıl çalıştığını açıklar — ancak alan listesinde yer almaz.
- Q&A bölümü: Sunulmaz.
- "Şunları da arayanlar" rakip önerileri: Sunulmaz.
- Menü / fiyat listesi: Standart alan değildir.
Google Places API’yi Kimler Kullanır?
- Lojistik şirketleri: adres doğrulama ve coğrafi kodlama
- Seyahat ve konaklama uygulamaları: yakındaki oteller, restoranlar, turistik noktalar
- Emlak platformları: ilanları yerel işletme verileriyle zenginleştirme
- Yerel SEO ajansları: NAP (ad, adres, telefon) tutarlılığı denetimleri
- Satış ekipleri: place ID ve temel işletme bilgilerinden lead listeleri oluşturma
Kullanım senaryonuz "yapılandırılmış place verisini üretim ortamındaki bir uygulamada kullanmam gerekiyor" cümlesine uyuyorsa, API doğru başlangıçtır. Ama senaryoda "tüm yorumlar", "popüler saatler" veya "rakip analizi" geçiyorsa — okumaya devam edin.
Google Places Verisini Scraping Etmek Ne Demek?
Web scraping, bir web sayfasındaki veriyi otomatik olarak çekmek için yazılım kullanmak demektir — bu durumda resmî bir API yerine Google Maps ya da Google Search sonuçlarından veri almak. Scraper, tarayıcınızın sayfayı okuduğu gibi sayfayı okur; ardından görünen yapılandırılmış parçaları çeker: işletme adları, adresler, yorum metinleri, yıldız puanları, popüler saat grafiklerı, Q&A, rakip önerileri, tam fotoğraf galerisi ve ekranda render edilen diğer her şey.
Temel fark şu: API, Google’ın dışarı açmayı seçtiği veriyi verir. Scraping ise teoride sayfada bir insanın görebildiği her şeyi verir.
Ama "scraping" tek bir yöntem değildir. Üç çok farklı yaklaşım vardır ve aralarındaki ödünler önemlidir.
DIY Scriptler, Yönetilen Scraping API’leri ve No-Code Araçlar
| Yaklaşım | Nasıl Çalışır | En Uygun Olduğu Durum | Ana Ödün |
|---|---|---|---|
| DIY scriptler (Puppeteer, Playwright, Selenium) | Google Maps sayfalarında gezen ve DOM’u ayrıştıran headless browser scripti yazarsınız, bakımını da siz yaparsınız | Tam kontrol ve özel mantık isteyen geliştiriciler | En yüksek bakım yükü — Google arayüzü değişince seçiciler bozulur |
| Yönetilen scraping API’leri (Thunderbit API, SerpApi, Outscraper) | API’ye bir URL veya sorgu gönderirsiniz; render, anti-bot ve ayrıştırma tarafını o halleder, yapılandırılmış veri döner | Scraper bakımıyla uğraşmadan yapılandırılmış çıktı isteyen geliştiriciler | Sağlayıcıya göre fiyat ve kalite değişir; üçüncü tarafa güvenirsiniz |
| No-code tarayıcı eklentileri (Thunderbit Chrome Extension) | Tarayıcı içinde tıkla-seç yöntemiyle veri çekersiniz — AI alanları önerir, siz "Scrape" dersiniz, Sheets/Excel’e aktarırsınız | Hızlıca tabloya veri aktarması gereken iş kullanıcıları, pazarlamacılar, satış ekipleri | Karmaşık iş akışlarında daha az esnek; aracın AI kalitesine bağlı |
Kısa versiyon: DIY = en esnek ama en masraflı bakım. Yönetilen API’ler = yapılandırılmış çıktı, bakım yok. No-code araçlar = teknik olmayan kullanıcılar için en hızlı yol.
Google Places API ile Scraping: Alan Bazında Veri Karşılaştırması
Araştırmaya başladığımda böyle bir tabloya çok ihtiyacım vardı. Bir iş kullanıcısının ya da geliştiricinin isteyebileceği her alanı yan yana karşılaştırma:
| Veri Alanı | Google Places API | Web Scraping |
|---|---|---|
| İşletme adı | ✅ Tam (Pro katmanı) | ✅ Tam |
| Adres / konum | ✅ Tam (Essentials katmanı) | ✅ Tam |
| Telefon numarası | ✅ Enterprise katmanı | ✅ Görünüyorsa |
| Web sitesi URL’si | ✅ Enterprise katmanı | ✅ Görünüyorsa |
| Toplam puan | ✅ Enterprise katmanı | ✅ Tam |
| Kullanıcı puan sayısı | ✅ Enterprise katmanı | ✅ Tam |
| Tekil yorumlar (metin + puan) | ⚠️ En fazla 5 yorum | ✅ Mevcut tüm yorumlar |
| Popüler saatler / canlı yoğunluk | ❌ Standart API alanı değil | ✅ Çekilebilir (render edildiğinde) |
| Q&A bölümü | ❌ Sunulmaz | ✅ Çekilebilir |
| Fotoğraf meta verileri | ✅ Photos endpoint üzerinden en fazla 10 referans | ✅ Tam galeri |
| Menü / fiyat listesi | ❌ Standart alan değil | ⚠️ Sayfada varsa |
| "Şunları da arayanlar" (rakipler) | ❌ Sunulmaz | ✅ Çekilebilir |
| Çalışma saatleri | ✅ Enterprise katmanı | ✅ Görünüyorsa |
| Fiyat seviyesi | ✅ Enterprise katmanı | ✅ Görünüyorsa |
| Place ID | ✅ Güçlü (Essentials) | ⚠️ Mümkün, ama kanonik kaynak API’dir |
| Google Maps URI | ✅ Pro katmanı | ✅ Sayfa URL’sidir |
| İşletme sahibinin yorumlara yanıtları | ⚠️ Güncel erişimi doğrulayın | ✅ Sıklıkla görünür |
| SERP / map-pack sıralaması | ❌ API’nin amacı değil | ✅ SERP scraping ile |
En büyük boşluk şu: duygu analizi, itibar takibi veya rakip kıyaslama için tam yorum setlerine ihtiyacınız varsa, yalnızca API yetmez. Bir yer için beş yorum örneklem, veri seti değil.
Popüler saatler ve yaya trafiği örüntüleri mi lazım? Aynı durum. Perakende danışmanı ya da ticari gayrimenkul analistiyseniz, scraping tek yol; bu veri API’de yok.
Öte yandan, güvenilir Place ID’ler, coğrafi kodlama için yapılandırılmış adresler veya bir mağaza bulucu çalıştırmak istiyorsanız, API daha temiz, daha güvenilir ve resmî olarak desteklenir.
Gerçek Maliyet: 10K, 100K ve 1M Kayıtta Google Places API ile Scraping
Bu kararın en çok yanlış anlaşılan kısmı maliyettir. Birçok kullanıcı API’nin ücretsiz kotasına kayıt olur, bir prototip kurar ve ölçek büyüyünce gelen faturayı görünce şoka girer. Scraping tarafında ise proxy maliyetleri ve geliştirici zamanı hafife alınır.
Şimdi hesabı yapalım.
Google Places API Fiyatlandırma Dökümü
Google, 2025 Mart’ında Maps Platform fiyatlandırmasını yeniledi; eski sabit aylık 200 dolar krediyi kaldırıp SKU bazlı ücretsiz kullanım limitleri ve hacme göre katmanlama getirdi. Güncel fiyatlandırma şöyle çalışır:
- Essentials alanları (Place Details): ayda 10.000 ücretsiz istek, ardından 100K’ya kadar 1.000 başına 5,00 ABD doları
- Pro alanları (Place Details): 5.000 ücretsiz, sonra 1K başına 7,00 ABD doları
- Enterprise alanları (Place Details): 1.000 ücretsiz, sonra 1K başına 20,00 ABD doları
- Enterprise + Atmosphere (yorumlar, olanaklar): 1.000 ücretsiz, sonra 1K başına 25,00 ABD doları
Kritik detay: field mask’inizde reviews gibi tek bir Enterprise + Atmosphere alanı bile varsa, isteğin tamamı o katmanda ücretlendirilir. Üstelik tipik bir iş akışı birden fazla SKU zinciri içerir — önce yerleri keşfetmek için Text Search Pro, sonra bunları zenginleştirmek için Place Details Enterprise + Atmosphere — yani maliyetler üst üste biner.
Tek bir “lookup” çoğu zaman tek bir ücretli istek değildir.
Scraping Maliyetleri: Araçlar, Proxy’ler ve Geliştirici Zamanı
Scraping maliyetleri üç başlığa ayrılır:
- Araç aboneliği veya API kredileri: Yönetilen scraping API’leri istek, kredi ya da kayıt başına ücret alır. SerpApi arama başına ücretlendirir. Outscraper kullanım kadar ödeme modelini kayıt başına uygular. Thunderbit’in API’si kredi sistemi kullanır (Extract = istek başına 20 kredi). Thunderbit Chrome Extension, çıktı satırı başına 1 kredi alır.
- Proxy harcaması (yalnızca DIY): Google Maps scraping için residential proxy’ler, hacim ve sağlayıcıya göre genelde ayda 50–300 dolar aralığındadır.
- Geliştirici zamanı (yalnızca DIY): Puppeteer/Playwright scriptlerini kurmak ve sürdürmek. DIY ekonomisini asıl bozan gizli maliyet budur (aşağıda birazdan).
Ölçek Bazında API ve Scraping Yan Yana Maliyet Tablosu
| Ölçek | Google Places API (Enterprise + Atmosphere) | Yönetilen Scraping API (tahmini) | DIY Scraping (proxy + geliştirici zamanı) |
|---|---|---|---|
| Ayda 10K kayıt | ~$225 (1K ücretsiz, 9K × $25/1K) | Sağlayıcıya göre yaklaşık ~$50–$150 | ~$50 proxy + ayda 2–4 saat geliştirme |
| Ayda 100K kayıt | ~$2,475 (ücretsiz sınırdan sonra hacim katmanları uygulanır) | ~$250–$500 | ~$150 proxy + ayda 8–16 saat geliştirme |
| Ayda 1M kayıt | ~$17,975 (hacim katmanları birim maliyeti düşürür ama toplam hâlâ yüksektir) | ~$1,500–$3,000 | ~$300 proxy + ayda 20+ saat geliştirme + kırılma riski |
Notlar: API tahminleri, ücretsiz 1K sınırından sonra Place Details Enterprise + Atmosphere için yayınlanan hacim katmanlarına dayanır. Yönetilen scraping API tahminleri sağlayıcılar arasında yaklaşık aralıklardır. DIY geliştirme zamanı, yüklenmiş saat maliyeti olarak $50–$100/saat varsayar.
Desen açık: hobi ölçeğinde (10K altı) API’nin ücretsiz kotaları onu en ucuz seçenek yapabilir, özellikle yalnızca Essentials veya Pro alanları gerekiyorsa. İş ölçeğinde (100K+), API maliyetleri sert biçimde yükselir, özellikle zengin alanlarda. Kurumsal ölçekte (1M+), API aylık beş haneli rakamlara yaklaşabilir; API’nin sunmadığı ek alanlara gerçekten ihtiyacınız varsa scraping veya veri hizmetleri ekonomik olarak daha cazip hâle gelir.
Eğer sadece adres ve Place ID istiyorsanız, scraping yapmayın. Bu işte API hem daha ucuz hem daha iyidir. Scraping lehine maliyet argümanı yalnızca API’nin döndüremediği verilere ihtiyacınız olduğunda geçerlidir.
Anti-Bot Gerçekliği: DIY Google Scraper’lar Neden Bozulur?
Scraping savunucularının atladığı kısım burası. Google, Google Maps’in scrape edilmesini istemiyor. Birden çok savunma katmanı kurmuş durumda ve bunları düzenli olarak güncelliyor.
Google’ın Katmanlı Savunmaları
- reCAPTCHA engelleri: Otomatik tarayıcılar, insan kullanıcılara göre çok daha sık CAPTCHA tetikler
- İstemci tarafı JavaScript render’ı: Google Maps ağır bir JavaScript uygulamasıdır. Sıradan bir HTTP isteği render edilmiş içeriği vermez — tam bir headless browser gerekir
- Tarayıcı parmak izi: Google, headless browser’ları canvas fingerprint, WebGL, navigator özellikleri ve başka sinyallerle tespit eder
- IP hız sınırlaması: Aynı IP’den (veya aynı proxy subnet’inden) çok fazla istek gelirse engellenirsiniz
- DOM yapısı değişiklikleri: Google sayfaların yapısını düzenli olarak değiştirir — Reddit ve GitHub issue’larındaki genel kanaat, seçicilerin birkaç hafta ile birkaç ay arasında bozulduğudur
Sonuncusu sessiz katildir. Haziran ayında kusursuz çalışan bir Puppeteer scripti, Google bir CSS sınıfının adını değiştirip bir div’i yeniden düzenlediği için Temmuz’da boş sonuç döndürebilir.
DIY Scriptleri Sürdürmenin Gizli Maliyeti
Google DOM’u her değiştirdiğinde, ekipten birinin şunları yapması gerekir:
- Scraper’ın bozulduğunu fark etmek (umarız kötü veri yayılmadan önce)
- Yeni sayfa yapısını incelemek
- Seçicileri güncellemek, yeni CAPTCHA türlerini ele almak, retry mantığını ayarlamak
- Test edip yeniden dağıtmak
Bir yıl içinde bu bakım süresi, yönetilen bir scraping API abonelik maliyetini rahatlıkla aşabilir. Orta karmaşıklıkta bir kurulumda Google Maps scraper’ını ayakta tutmak için yıllık 40+ geliştirici saati harcayan ekipler gördüm — bu da temkinli bir tahmin.
Yönetilen Scraping API’leri Neden Var?
İşte bu bakım yükü yüzünden Thunderbit’in API’si, SerpApi ve Outscraper gibi hizmetler var. JS render, CAPTCHA çözme, proxy rotasyonu, seçici bakımı gibi anti-bot karmaşıklığını üstlenirler ve yapılandırılmış veri döndürürler.
Thunderbit’in renderMode: "full" ile çalışan POST /extract endpoint’i, Google Maps gibi JavaScript ağırlıklı sayfaları işler ve ayrıştırılması gereken ham HTML yerine şemaya uyan yapılandırılmış JSON döndürür. MCP server bunu AI ajanlarına da taşır — Claude, Cursor veya başka LLM tabanlı iş akışları görev ortasında ortamdan çıkmadan Google Maps verisi çekebilir.
Teknik olmayan kullanıcılar için Thunderbit Chrome Extension bakım gerektirmeyen seçenektir: bir Google Maps sayfası açın, "AI Suggest Fields"e tıklayın, "Scrape"e tıklayın, Sheets’e dışa aktarın. Seçici yok, proxy yok, debug yok.
SerpApi ve Outscraper farklı fiyatlandırma modelleri ve çıktı formatlarıyla sağlam alternatiflerdir. SerpApi her arama için yapılandırılmış JSON döndürür; Outscraper ise kullanım kadar ödeme modeliyle kayıt başına ücret alır. Doğru seçim, hacminize, bütçenize ve yapılandırılmış JSON’a mı ihtiyacınız olduğuna yoksa yarı yapılandırılmış çıktıyı ayrıştırmaya rahat olup olmadığınıza bağlıdır.
Hibrit Oyun Planı: Google Places API ve Scraping’i Birlikte Kullanmak
Bu konuda üst sıralardaki yazıların çoğu, pratikte en iyi çalışan yaklaşımı önermiyor: ikisini birlikte kullanmak. Birçok ekip bazı işlerde resmî API’ye, bazı işlerde scraping’e dayanıyor. İşin sırrı, her aracı doğru görevle eşleştirmek.
Resmî API Ne Zaman Kazanır?
- Canlı bir üretim uygulamasında Autocomplete: Düşük gecikme, ToS uyumlu, güvenilir SLA. Tartışmasız.
- Konum tabanlı uygulama arka uçları: Mağaza bulucular, adres doğrulama, place ID eşleştirme. API yapılandırılmış, destekli ve dokümante.
- Uyumluluğun kritik olduğu entegrasyonlar: Kurumsal sözleşmeler, kullanıcıya açık ürünler veya Google ToS uyumunun pazarlık konusu olmadığı her durum.
Scraping Ne Zaman Kazanır?
- Tam yorum çekme (yer başına 5K+ yorum): Duygu analizi, itibar takibi, rakip kıyaslama. API’nin 5 yorum sınırı burada işe yaramaz.
- Tek seferlik lead listesi çıkarma: Sürekli fatura istemeyen batch işler için daha ucuz. Thunderbit gibi no-code bir araç, işletme listesini dakikalar içinde scrape edip tabloya aktarabilir.
- Popüler saatler / yaya trafiği analizi: API ile mevcut değil. Nokta.
- Q&A verisi, rakip "şunları da arayanlar": Yalnızca sayfada görünür, API’de yok.
Hibrit Yaklaşım Ne Zaman Mantıklı?
- Sürekli fiyat/puan takibi: Temel yapılandırılmış veri için API’yi (Place ID, adres, toplam puan) kullanın; ardından API’nin kaçırdığı derin alanlar için scrape edin (tam yorumlar, popüler saatler).
- Zenginleştirme iş akışları: Place ID ve kanonik işletme bilgilerini API ile alın; ardından tekil liste sayfalarını scrape ederek tam yorum setleri, Q&A ve rakip bağlamını çekin.
- Zamanlanmış izleme: Thunderbit’in scheduled scraper’ı (no-code kullanıcılar için) veya cron ile CLI batch extraction (geliştiriciler için) özel altyapı kurmadan tekrarlı scraping yapabilir.
Kullanım Senaryosu Karar Matrisi
| Kullanım Senaryosu | Önerilen Yöntem | Neden |
|---|---|---|
| Canlı uygulamada Autocomplete | ✅ Resmî API | Düşük gecikme, ToS uyumlu, güvenilir |
| 5K+ tam yorum seti çekme | ✅ Scraping / Scraping API | API, yer başına 5 yorumla sınırlı |
| Tek seferlik yerel işletme lead listesi | ✅ Scraping (veya Thunderbit extension) | Batch için daha ucuz; sürekli fatura yok |
| Popüler saatler / yaya trafiği analizi | ✅ Yalnızca scraping | API’de yok |
| Sürekli fiyat/puan takibi | ⚠️ Hibrit | Temel veri API, derin alanlar scraping |
| Konum tabanlı uygulama arka ucu | ✅ Resmî API | Yapılandırılmış, destekli, SLA |
| Yerel SEO SERP pozisyon takibi | ✅ Scraping / SERP API | Places API’nin amacı bu değil |
| Rakip "şunları da arayanlar" | ✅ Yalnızca scraping | API’de sunulmaz |
Karar Akış Şeması: Google Places API mi Scraping mi — Hangisini Seçmelisiniz?
Belirsiz bir "duruma göre değişir" yerine somut bir karar çerçevesi verelim. Şu dört sorudan geçin:
1. Üretim ortamındaki bir uygulama için gerçek zamanlı veriye mi ihtiyacınız var? → Evet: Resmî API’yi kullanın. Desteklidir, SLA’sı vardır ve ToS uyumludur. Burada durun. → Hayır: Devam edin.
2. API’nin döndürmediği verilere mi ihtiyacınız var (tam yorumlar, popüler saatler, Q&A)? → Evet: Scraping gerekir. API bu veriyi kelimenin tam anlamıyla veremez. → Hayır: Devam edin.
3. Ayda kaç kayıt işliyorsunuz? → 10K altı: Özellikle yalnızca Essentials veya Pro alanlarına ihtiyacınız varsa API muhtemelen en ucuz seçenektir. Bu ölçekte ücretsiz kotalar çok şeyi karşılar. → 10K üstü: Özellikle zengin alanlar için scraping veya yönetilen scraping API’si daha ekonomik olabilir.
4. Scraper kurup sürdürmek için geliştirici kaynağınız var mı? → Evet: Puppeteer/Playwright ile DIY en yüksek kontrolü sağlar (ama sürekli bakım bütçesi ayırın). → Hayır: Yönetilen bir scraping API’si (Thunderbit API, SerpApi, Outscraper) veya no-code bir araç (Thunderbit Chrome Extension) kullanın.
Geliştirici Odaklı Alternatiflerin Hızlı Karşılaştırması
| Araç | Fiyatlandırma Modeli | Çıktı Formatı | Anti-Bot Yönetimi | Batch Desteği |
|---|---|---|---|---|
| Thunderbit API / MCP | Kredi bazlı (Extract = istek başına 20 kredi) | Şemaya eşleşen yapılandırılmış JSON | ✅ JS render, proxy rotasyonu, coğrafi yönlendirme | ✅ Batch başına 100 URL’ye kadar |
| SerpApi | Arama başına (katmanlı planlar) | Yapılandırılmış JSON | ✅ | ✅ API parametreleriyle |
| Outscraper | Kayıt başına (kullandıkça öde) | JSON / CSV | ✅ | ✅ Görev kuyruklarıyla |
| DIY (Puppeteer/Playwright) | Proxy + geliştirici zamanı | Ham HTML (siz ayrıştırırsınız) | ❌ Sorumluluk sizde | ✅ Ne kurarsanız |
Thunderbit’in ayrıştığı nokta şu: ham HTML veya hâlâ ayrıştırma gerektiren Markdown değil, tanımladığınız JSON Schema’ya göre şemaya uyumlu yapılandırılmış JSON döndürür. Bir LLM pipeline’ına besliyorsanız ya da veritabanı yüklüyorsanız, bu gerçek post-processing zamanı kazandırır.
Thunderbit Bu Resimde Nereye Oturuyor? (İş Kullanıcıları ve Geliştiriciler İçin)
Thunderbit, "Google Maps verisine ihtiyacım var" ile "scraping altyapı mühendisi olmak istemiyorum" arasındaki boşluğu kapatmak için geliştirildi. İşte iki kitle için nasıl çalıştığı.
Teknik Olmayan Kullanıcılar İçin: Chrome Extension
- Bir Google Maps sayfası açın — arama sonuçları ya da tekil işletme sayfası
- "AI Suggest Fields"e tıklayın — Thunderbit’in AI’si sayfayı okur ve sütunlar önerir (işletme adı, adres, puan, yorumlar, telefon vb.)
- "Scrape"e tıklayın — eklenti veriyi yapılandırılmış tabloya çıkarır. Cloud mode ile aynı anda 50 sayfaya kadar kullanabilirsiniz
- Alt sayfaları scrape edin — her listeye gidip tam detayları çekmek için "Scrape Subpages"e tıklayın
- Dışa aktarın — Excel, Google Sheets, Airtable veya Notion’a. Ücretsiz veri dışa aktarma, ücret duvarı yok
Tekrarlayan izleme için — haftalık rakip puan kontrolleri, yeni işletme listeleri — scheduled scraper belirlediğiniz sıklıkta otomatik çalışır.
Geliştiriciler İçin: API, MCP Server ve CLI
- JSON Schema ile
POST /extract: Bir Google Maps URL’si gönderin, istediğiniz alanları tanımlayın, yapılandırılmış JSON alın. JavaScript ağırlıklı sayfalar içinrenderMode: "full"ayarlayın. Thunderbit render, anti-bot, proxy rotasyonu ve coğrafi yönlendirmeyi üstlenir. POST /distill: Herhangi bir sayfadan temiz Markdown alın — yapılandırılmış alanlardan ziyade ham içerik isteyen LLM pipeline’ları için kullanışlıdır. Extract’e göre istek başına 1 kredi, 20 kredi değil.- MCP Server: AI ajanları (Claude, Cursor) görev sırasında Google Maps verisi çekebilir. Distill, yapılandırılmış extraction, alan önerileri ve 100 URL’ye kadar batch işleri destekler.
- CLI:
thunderbit batch extract --file urls.txt --schema places.jsonile zamanlanmış veya CI/CD’ye entegre scraping.
Kredi fiyatlandırması: Extract = istek başına 20 kredi, Distill = istek başına 1 kredi. API kredileri satır başına değil, istek başınadır (eklenti tarafında 1 kredi = 1 çıktı satırı). Güncel planlar için Thunderbit Pricing sayfasına bakın.
Hukuki ve Hizmet Şartlarıyla İlgili Hususlar
Bunu kısa ve net tutacağım — korkutma yok, satış konuşması yok.
Google Places API net şartlarla gelir: Google’ın hizmete özel şartları, Places API içeriğinin Google Haritası olmadan kullanılabileceğini, ancak Google dışı bir haritayla birlikte kullanılmaması gerektiğini söyler. Enlem/boylam değerleri en fazla 30 ardışık takvim günü önbellekte tutulabilir; Place ID’ler süresiz saklanabilir. Detaylar, fotoğraflar ve yorumlar için atıf zorunludur.
Google Maps scraping Google’ın Hizmet Şartları’nı ihlal edebilir. Uygulama değişkenlik gösterir — riskler IP blokları, CAPTCHA duvarları ve nadiren de olsa yasal işlem içerir. Yönetilen scraping API’leri genellikle bazı uyumluluk yükünü kullanıcı adına üstlenir, ancak bu bir hukuk kalkanı değildir.
Son kullanıcıya dönük üretim uygulamaları için resmî API daha güvenli tercihtir. İç araştırma, batch analiz ve rekabet istihbaratı için scraping sektörde yaygın bir pratiktir. Ticari iş akışlarınız için kendi hukuk danışmanınıza başvurun.
Ben Gerçekte Hangisini Seçerdim ve Neden?
Fiyatlandırma kalemlerini, alan listelerini, topluluk başlıklarını ve araç dokümanlarını inceledikten sonra vardığım sonuç şu:
- Resmî API’yi kullanın: Üretim uygulamasında gerçek zamanlı, ToS uyumlu veriye ihtiyacınız varsa ya da Essentials/Pro alanları yeterliyse ve hacminiz ayda 10K altındaysa. Ücretsiz kotalar küçük ölçekte cömerttir ve veri kalitesi tartışmasızdır.
- Scraping kullanın (yönetilen API veya no-code araç): Tam yorumlar, popüler saatler, Q&A, rakip bağlamı veya API’nin açmadığı herhangi bir alan gerekiyorsa. Ayrıca hacminiz ayda 10K–100K kayıt aralığını aşıyorsa ve zengin (Enterprise + Atmosphere) alanlar istiyorsanız — API faturası savunması zor bir seviyeye çıkar.
- İkisini birlikte kullanın: İş akışınız hem kanonik Place ID’ler ve temel yapılandırılmış veri (API) hem de derin görünür sayfa zekâsı (scraping) gerektiriyorsa. Bu, çoğu yazının kabul ettiğinden daha yaygındır.
Maliyette kırılma noktası şu: temel alanlarla ayda yaklaşık 10K kayda kadar API daha basit ve çoğu zaman ücretsizdir. Bunun üstünde, özellikle zengin veri için, scraping daha ekonomik olur. 1M kayıt ve Enterprise + Atmosphere alanlarında, API tarafında aylık yaklaşık 18K dolar, yönetilen bir scraper’da ise bunun çok daha küçük bir kısmı söz konusudur.
Bunu kendiniz test etmek isterseniz, Thunderbit Chrome Extension scraping’in API’ye kıyasla neleri yakaladığını görmek için en hızlı yoldur. Geliştirici iş akışları için Thunderbit API dokümanları başlangıç için ihtiyacınız olan her şeyi sunar. Ve kodsuz web scraping ya da genel olarak AI web scraping hakkında daha fazla okumak isterseniz, blogda bu konuları ayrıntılı biçimde ele aldık.
Önemli Çıkarımlar
- Google Places API, üretim uygulamaları, autocomplete ve yapılandırılmış place sorguları için doğru araçtır — ancak yorumları 5, fotoğrafları 10 ile sınırlar ve popüler saatler, Q&A ya da rakip önerilerini açmaz.
- Scraping, tam yorum setleri ve popüler saat verisi dahil Google Maps sayfasında görünen her şeyi yakalar; ancak anti-bot savunmalarını yönetmeyi ya da yönetilen bir hizmet için ödeme yapmayı gerektirir.
- Ayda 10K kayıt altı kullanımda, API’nin ücretsiz kotaları çoğu zaman en ucuz seçenek olur. 100K üstünde ise, zengin veri için scraping veya yönetilen scraping API’leri genellikle daha ekonomiktir.
- DIY scraper’lar, Google’ın anti-bot savunmaları ve DOM değişiklikleri nedeniyle düzenli olarak bozulur — bakım için yıllık 40+ geliştirici saati bütçe ayırın ya da yönetilen bir araç kullanın.
- Gerçek dünyadaki en iyi strateji çoğu zaman hibrittir: kanonik ID’ler ve temel alanlar için API, API’nin veremediği derin içgörü için scraping.
- Thunderbit iki tarafı da destekler: no-code kullanıcılar için Chrome Extension ve geliştiriciler için yapılandırılmış JSON API/MCP server.
SSS
Places API üzerinden 5’ten fazla Google yorumu alınabilir mi?
Hayır. Google Places API, yorum dönüşünü yer başına 5 ile sınırlar ve bunlar alaka düzeyine göre sıralanır. Bu, API ilk çıktığından beri böyle ve yıllardır gelen geliştirici taleplerine rağmen değişmedi. Bir işletmenin mevcut tüm yorumlarına erişmek için scraping (ister DIY ister yönetilen bir scraping API üzerinden) tek seçenektir.
Google Maps scraping yasal mı?
Tek bir evet/hayır cevabı yok. Kamuya açık Google Maps verisini scrape etmek Google’ın Hizmet Şartları’nı ihlal edebilir ve yaptırımlar IP bloklarından nadiren yasal işlemlere kadar uzanabilir. Birçok işletme iç araştırma ve rekabet istihbaratı için scraping kullanır ve sorun yaşamaz. Yönetilen scraping API’leri bazı uyumluluk risklerini üstlenir, ancak bu bir hukuki koruma değildir. Ticari bir ürün geliştiriyorsanız veya kişisel veri işliyorsanız, hukuk danışmanına başvurun.
100K sorgu için Google Places API maliyeti ne olur?
Bu, hangi alanları istediğinize bağlıdır. Place Details için Essentials katmanında yaklaşık ~$450. Pro katmanında yaklaşık ~$1,615. Enterprise + Atmosphere’da ise (yorumlar ve olanaklar dahil) yaklaşık ~$2,475. İş akışınız keşif için Text Search Pro da gerektiriyorsa, buna yaklaşık ~$3,040 daha ekleyin. Bu tahminler Google’ın yayınladığı hacim katmanlarını kullanır ve ücretsiz kotadan sonra kayıt başına bir ücretli istek varsayar.
Scraping API ile no-code scraping aracı arasındaki fark nedir?
Bir scraping API’si (örneğin Thunderbit’in Open API’si), geliştiricilerin scraping’i HTTP istekleriyle kod, otomasyon hatları veya AI ajan iş akışlarına entegre etmesi içindir. No-code bir araç (örneğin Thunderbit Chrome Extension), teknik olmayan kullanıcıların tarayıcı üzerinden kod yazmadan veri seçip dışa aktarmasını sağlar. İkisi de yapılandırılmış veri döndürebilir; fark arayüz ve entegrasyon modelidir.
Thunderbit Google Maps sayfalarında çalışır mı?
Evet. Chrome Extension, Google Maps arama sonuçlarını ve tekil işletme sayfalarını scrape edebilir — AI alanları otomatik önerir ve cloud mode ile aynı anda 50 sayfaya kadar çalışabilirsiniz. API’nin renderMode: "full" ile çalışan POST /extract endpoint’i, Google Maps’in JavaScript ile render edilen sayfalarını işler ve şemaya uyumlu yapılandırılmış JSON döndürür. MCP server, AI ajanlarının iş akışı sırasında Google Maps verisi çekmesini sağlar.
Daha Fazla Bilgi
