İşletme Verisi API

Google İşletme Verisi API

Google'daki işletmeleri kategoriye, isme ya da bir koordinat çevresindeki yarıçapa göre arayın; puan, yorum sayısı, telefon, web sitesi ve konum bilgisini alın. Aynı endpoint tek bir işletmenin tam profilini ve yorumlarını metin, puan, tarih ve işletme cevabıyla birlikte döndürür.

Tek Endpoint, Üç Rapor Türkiye'de 4,88 Milyon İşletme 5.316 Kategori Kullandığınız Kadar Ödeyin Hatalarda Asla Ücret Yok
Python API Example
import requests

response = requests.post(
    "https://data.semust.com/v1/business-data",
    headers={
        "SEMUST-API-USER": "your_username",
        "SEMUST-API-PASSWORD": "your_password",
    },
    json={
        "type": "search",
        "categories": ["cafe"],
        "latitude": 40.9906,
        "longitude": 29.0270,
        "radius_km": 1,
        "sort": "reviews",
        "limit": 20,
    },
    timeout=90,  # longer than ?wait= (60 seconds by default)
)

data = response.json()
if response.status_code == 202:
    # Still running: collect it later from data["poll_url"]
    print(f"Task {data['task_id']} is still running")
elif response.status_code == 200:
    print(f"{data['total']} businesses found")
    for business in data["items"]:
        print(business["name"], business["rating"], business["reviews"], business["phone"])
Cookshop
ideasoft
Yapı Kredi
beko logo
vialand
defacto
koton
venividi logo
Cookshop
ideasoft
Yapı Kredi
beko logo
vialand
defacto
koton
venividi logo

12.000+ markanın güvendiği Semust ile şimdi tanışın.

Tek Endpoint

search, profile ve reviews raporları `type` parametresiyle seçilir. Tek istek şekli, tek kimlik doğrulama, tek hata formatı.

Konuma Göre Arama

Bir enlem, boylam ve yarıçap verin; o alandaki işletmeleri kategori, puan ve yorum sayısı filtreleriyle, en çok yorum alandan başlayarak listeleyin.

Şeffaf Ücret

Arama için istek başına 0,0132 USD + dönen işletme başına 0,000396 USD, profil için 0,00594 USD, yorumlar için her 10 yorum 0,000825 USD.

İşletme Verisi API ile Neler Yapabilirsiniz?

data.semust.com/v1/business-data endpoint'i ile Google'daki işletmelere, profillere ve yorumlara erişin.

search, işletmeleri kategoriye, isme ya da konuma göre listeler. profile, tek bir işletmenin puan dağılımı, çalışma saatleri, açıklaması ve özellikleriyle tam profilini verir. reviews ise yorumları metin, puan, tarih, yazar ve işletme cevabıyla döndürür. İşletmeyi place_id, cid ya da adıyla belirtirsiniz. Kategori listesini GET /v1/business-data/categories ücretsiz olarak verir.

// One endpoint, three reports
POST /v1/business-data

{ "type": "search", "categories": ["cafe"],
  "latitude": 40.9906, "longitude": 29.0270, "radius_km": 1 }
{ "type": "profile", "place_id": "ChIJQ3x3p-e5yhQRCzOLzD3Pdkw" }
{ "type": "reviews", "cid": "5509819058466009867",
  "sort": "newest", "limit": 100 }

// Every category, filterable with ?q= (free)
GET /v1/business-data/categories?q=cafe

Tek bir platform,Organik başarı hikayeleri:

Batuhan Durmaz

Batuhan Durmaz

SEO Uzmanı

SEMUST SEO çalışmalarımız için oldukça değerli verileri çok basit ve anlaşılır bir şekilde bize sunmakta olan harika bir araç. Rakip araçlara baktığımızda çok uygun fiyatlara, çok iyi veriler elde etmek mümkün. Ben SEMUST'ı hem yerli hem de global projelerde anahtar kelime analizleri, Google search console verisi, Sıralama takibi ve içerik üretimi için kullanıyorum. Oldukça da memnunum.

Selen Çetin

Selen Çetin

SEO Uzmanı

Semust'la ilk olarak LinkedIn'de karşılaşmıştım, o zamanlar yeni yeni duyuluyordu. Merak edip denemiştim, şimdi severek kullandığım araçlardan biri haline geldi. Özellikle manuel olarak yapmam gereken birçok işi tek tıkla halletmesi, işimi ciddi anlamda kolaylaştırıyor. İlk kullandığım zamandan bu yana ne kadar hızlı geliştiğini görmek de ayrıca güven veriyor.

Aykut Özcan

Aykut Özcan

SEO Director - Digital UP

Digital UP SEO Ajansı olarak, SEO süreçlerimizde Semust'un sunduğu analiz ve raporlama araçlarından büyük ölçüde faydalanıyoruz. Anahtar kelime takibinden rekabet analizine, site sağlığı taramalarından backlink denetimine kadar birçok kritik alanda bize hız ve derinlik kazandırıyor. Özellikle veri odaklı stratejiler geliştirmemizde sağladığı kapsamlı içgörüler sayesinde, müşterilerimizin arama motorlarındaki performansını istikrarlı biçimde artırıyoruz. Semust, ajansımızın büyüme yolculuğunda güçlü bir destekçidir.

İşletme Verisi API Sıkça Sorulan Sorular

İşletme Verisi API Nedir ve Nasıl Çalışır?

İşletme Verisi API, Google'daki işletme kayıtlarını programatik olarak sorgulamanızı sağlayan bir arayüzdür. Haritada işletmeleri tek tek açıp bilgileri elle toplamak yerine, kendi uygulamanızdan tek bir HTTP isteğiyle veriyi yapılandırılmış JSON olarak alırsınız; saklayabilir, CRM'inize aktarabilir ya da kendi raporlarınızda kullanabilirsiniz.

Semust İşletme Verisi API tek bir endpoint üzerinden çalışır: data.semust.com/v1/business-data adresine gönderdiğiniz POST isteğinde type parametresiyle üç rapordan birini seçersiniz — search, profile veya reviews. Kimlik doğrulama header tabanlıdır ve her yanıt JSON'dur.

Yerel SEO İçin İşletme Verisi

Yerel aramalarda görünürlük; doğru kategori, eksiksiz profil bilgisi, güncel çalışma saatleri ve yorumların sayısı ve puanıyla şekillenir. İşletme verisi, bir bölgede rakiplerin nasıl konumlandığını ve hangi alanlarda öne çıkabileceğinizi gösterir.

API ile bir ilçedeki tüm rakiplerin puanlarını ve yorum sayılarını tek istekte çekebilir, profilinizdeki eksikleri onlarınkiyle karşılaştırabilir ve bu kontrolleri düzenli aralıklarla otomatik çalıştırabilirsiniz.

Kategori ve Konuma Göre İşletme Arama

search raporu en fazla 10 kategoriyi, isimde geçen bir ifadeyi ve bir enlem, boylam ve yarıçapla tanımlanan alanı birlikte kullanmanıza izin verir. Sonuçlar en düşük puana, en az yorum sayısına ve profilin sahiplenilmiş olmasına göre süzülebilir; yanıt toplam eşleşme sayısını da verir.

Türkçe isimlerde büyük I harfi iki şekilde okunabildiği için isim aramasında iki yazım da aranır; KADIKÖY yazdığınızda hem Kadıköy hem Kadiköy yazılmış kayıtlar bulunur. Sayfalama page ve limit ile yapılır, tek istekte en fazla 1.000 işletme döner.

İşletme Verisi API Fiyatlandırması

search için istek başına 0,0132 USD artı dönen her işletme için 0,000396 USD ödersiniz; 100 işletmelik bir sayfa 0,0528 USD tutar. profile istek başına 0,00594 USD'dir. reviews için istenen her 10 yorum 0,000825 USD'dir; 100 yorum 0,00825 USD tutar.

Arama ve profil sonuçları 24 saat, yorumlar 6 saat önbellekte tutulur; önbellekten dönen yanıt canlı yanıtla aynı ücreti öder. Bulunamayan bir işletme, bilinmeyen bir kategori ya da diğer tüm hatalar ücretlendirilmez.

İşletme Profilleri

profile raporu bir işletmenin Google'daki kaydını eksiksiz döndürür: ad, ana ve ek kategoriler, adres, telefon, web sitesi, koordinatlar, puan ve 1–5 yıldız dağılımı, yorum sayısı, fotoğraf sayısı, fiyat seviyesi ve profilin sahiplenilip sahiplenilmediği.

Bunlara ek olarak günlere göre çalışma saatleri, işletmenin açıklaması, mevcut ve mevcut olmayan özellikleri ve kullanıcıların birlikte aradığı işletmeler gelir. Bir ajans için müşterinin profilini rakipleriyle kıyaslamanın en hızlı yoludur.

Google Yorumları

reviews raporu yorumları metin, puan, yayın tarihi ve yazar bilgisiyle döndürür; yazarın toplam yorum ve fotoğraf sayısı ile yerel rehber olup olmadığı da yer alır. Yorum çevrilmişse orijinal metni ve dili de gelir; işletme cevap verdiyse cevap ve tarihi eklenir.

En yeni yorumları izleyerek olumsuz geri bildirimlere hızla cevap verebilir, en düşük puanlı yorumlardan tekrar eden sorunları çıkarabilir ya da yorum metinlerini duygu analizi için kullanabilirsiniz.

Kategoriler ve Doğrulama

Kategori listesi 5.316 kategori içerir ve GET /v1/business-data/categories ile ücretsiz olarak alınır. Her istek bu listeye göre doğrulanır: yanlış yazılmış bir kategori boş bir sonuç ve ücret yerine, en yakın kategorinin önerildiği bir UNKNOWN_CATEGORY hatası döndürür.

Hatalar sabit bir kod, okunabilir bir mesaj ve bir ipucu içerir; Accept-Language: tr göndererek mesajları Türkçe alabilirsiniz. Yanlış yazılmış bir parametre de hatada adıyla ve bir öneriyle bildirilir.

İşletme Verisi API Entegrasyonu

Entegrasyon için tek ihtiyacınız, hesap panelinizdeki API Erişimi sayfasından oluşturacağınız ve SEMUST-API-USER ile SEMUST-API-PASSWORD header'larında göndereceğiniz API kullanıcı adı ve şifresidir. İstekler standart HTTP POST'tur, yanıtlar JSON'dur.

İstekler task olarak çalışır. 60 saniyeden uzun süren bir istek ve her yorum isteği task_id içeren bir 202 döndürür; sonucu GET /v1/tasks/{task_id} ile alırsınız. Sonuçlar task bittikten sonra 72 saat saklanır. Idempotency-Key gönderirseniz aynı anahtar aynı task'ı döndürür ve bir kez ücretlendirilir.

Daha fazla organik trafik 

  • 14 gün ücretsiz deneme
  • Kurulum gerekmez
  • Search Console entegrasyonu