Trends API

Google Trends API

Google Trends verisini programatik olarak çekin: en fazla beş anahtar kelime için zamana göre ilgi, bölgelere göre ilgi ve ilgili aramalar, üstüne yaş ve cinsiyet tahmini. Dört rapor tek bir endpoint'te, istek başına sabit ücretle.

Tek Endpoint, Dört Rapor 5 Kelimeye Kadar Karşılaştırma İstek Başına Sabit Ücret Türkiye İçin İl Bazında Veri Hatalarda Asla Ücret Yok
Python API Example
import requests

response = requests.post(
    "https://data.semust.com/v1/trends",
    headers={
        "SEMUST-API-USER": "your_username",
        "SEMUST-API-PASSWORD": "your_password",
    },
    json={
        "type": "interest",
        "keywords": ["iphone 17", "samsung s26", "pixel 10"],
        "country": "TR",
        "period": "past_12_months",
    },
    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:
    # every per-keyword list follows data["keywords"]
    print("Averages:", dict(zip(data["keywords"], data["averages"])))
    for point in data["items"]:
        print(point["time"], dict(zip(data["keywords"], point["values"])))
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

Dört raporun tamamı `type` parametresiyle seçilir. Tek bir istek şekli, tek bir kimlik doğrulama; kelime başına her liste, gönderdiğiniz kelimelerle aynı sırada döner.

Yan Yana Karşılaştırma

Tek istekte beş anahtar kelimeye kadar karşılaştırın. interest raporunda kelimeler ortak bir 0–100 ölçeğini paylaşır; onları doğrudan kıyaslayabilirsiniz.

Sabit Ücret

Zamana göre ilgi, bölgeler ve ilgili aramalar için istek başına 0,0121 USD, demografi için 0,00264 USD. Beş kelime, tek kelimeyle aynı ücreti öder.

Trends API ile Neler Yapabilirsiniz?

data.semust.com/v1/trends endpoint'i ile Google Trends verisine ve kitle tahminlerine erişin.

interest, zamana göre ilgiyi her aralık için bir nokta ve her kelimenin ortalamasıyla verir. regions, ilginin nereden geldiğini (Türkiye için iller) ve kelimelerin her bölgedeki payını gösterir. related, tek bir kelime için en çok aranan ve yükselen ilgili aramaları ve konuları döndürür. demographics ise yaş grubuna ve cinsiyete göre ilgiyi tahmin eder. Dördü de aynı istek şekli ve kimlik doğrulamayla çalışır; desteklenen tüm ülke ve dilleri GET /v1/trends/markets ücretsiz olarak listeler.

// One endpoint, four reports
POST /v1/trends

{ "type": "interest", "keywords": ["iphone 17", "samsung s26"] }
{ "type": "regions", "keywords": ["iphone 17", "samsung s26"] }
{ "type": "related", "keywords": ["iphone 17"] }
{ "type": "demographics", "keywords": ["iphone 17"] }

// Every supported country and language (free)
GET /v1/trends/markets

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.

Trends API Sıkça Sorulan Sorular

Trends API Nedir ve Nasıl Çalışır?

Trends API, bir konuya olan arama ilgisinin zaman içinde nasıl değiştiğini programatik olarak sorgulamanızı sağlayan bir arayüzdür. Google Trends'i açıp kelimeleri elle karşılaştırmak yerine, kendi uygulamanızdan tek bir HTTP isteğiyle veriyi yapılandırılmış JSON olarak alırsınız; dilediğiniz gibi saklayabilir, grafiğe dökebilir ya da kendi raporlarınıza aktarabilirsiniz. Bu da onu SEO araçları geliştiren ekipler, içerik ekipleri, ajanslar ve talebi zaman içinde izleyen herkes için pratik bir yapı taşı yapar.

Semust Trends API tek bir endpoint üzerinden çalışır: data.semust.com/v1/trends adresine gönderdiğiniz POST isteğinde type parametresiyle dört rapordan birini seçersiniz — interest, regions, related veya demographics. Zamana göre ilgi, bölgeler ve ilgili aramalar Google Trends verisidir; demografi ise tıklama akışı (clickstream) verisine dayalı bir tahmindir. Kimlik doğrulama header tabanlıdır ve her yanıt JSON'dur.

Arama Trendi Verisi Neden Önemli?

Arama hacmi bir kelimenin ne kadar büyük olduğunu söyler; trend verisi ise hangi yöne gittiğini. Bir ürüne, konuya ya da markaya olan ilginin ne zaman yükselip düştüğünü görmek; içeriğinizi doğru zamanda yayınlamanıza, mevsimsel talebe hazırlıklı olmanıza ve bir terimin yerini daha yeni bir terime bıraktığını fark etmenize yardımcı olur.

search_type ile aramaların nerede sayılacağını seçersiniz: web, haberler, görseller, YouTube veya alışveriş. Web aramasında yatay seyreden bir kelime YouTube'da ya da alışverişte bambaşka davranabilir; bunları karşılaştırmak hangi kanala emek vermeniz gerektiğini gösterir. Bu kontrolleri API üzerinden kurduğunuzda, yalnızca birinin aklına geldiğinde değil, düzenli aralıklarla çalıştırabilirsiniz.

Kelimeleri Karşılaştırmak: Göreli İlgi Nasıl Çalışır?

Trend değerleri arama sayısı değil, görelidir. interest raporunda 100, dönem içinde herhangi bir kelimenin ulaştığı en yüksek noktadır ve diğer tüm değerler buna göre ölçeklenir. En fazla beş kelime aynı ölçeği paylaştığı için onları doğrudan karşılaştırabilirsiniz. Yanıt her kelimenin dönem ortalamasını da verir; böylece hangi terimin ne kadar önde olduğunu tek bir istekte görürsünüz.

Son bir günden son beş yıla kadar altı dönem arasından seçim yapabilirsiniz. Aralık döneme göre değişir: past_day için dakikalar, past_7_days için saatler, daha uzun dönemler için günler ya da haftalar. En son aralık hâlâ devam ediyor olabilir; bu aralık partial: true ile işaretlenir, böylece değerinin değişeceğini bilir ve karşılaştırmalarınızın dışında tutabilirsiniz.

Trends API Fiyatlandırması

Fiyatlandırma istek başına sabittir: interest, regions ve related için 0,0121 USD, demographics için 0,00264 USD. Ücret kelime sayısına, döneme ya da arama türüne göre değişmez; beş kelimeyi beş yıllık dönemde karşılaştırmak, tek bir kelimeye son bir gün için bakmakla aynı ücreti öder.

Verisi olmayan bir kelime de geçerli bir yanıttır — items boş, değerler null döner — ve diğer istekler gibi ücretlendirilir. Sonuçlar past_day için 1 saat, past_7_days için 6 saat, daha uzun dönemler için 24 saat önbellekte tutulur; önbellekten dönen yanıt cached: true ile işaretlenir ve canlı yanıtla aynı ücreti öder. Bir hata için ise asla ücret alınmaz.

Bölgesel İlgi: Türkiye İçin İl Bazında Veri

regions raporu ilginin nereden geldiğini gösterir. Türkiye için ilgiyi il bazında ayırır ve her satır bölgenin ISO 3166-2 kodunu (ör. TR-34) taşır; böylece veriyi kendi verilerinizle eşleştirebilir ya da haritaya dökebilirsiniz. Satırlar ilk kelimenin ilgisine göre, en yüksekten başlayarak sıralanır.

Her satır iki farklı görünüm sunar. interest her kelimeyi kendi ölçeğine koyar (100, o kelimenin en güçlü olduğu bölgedir); share ise o bölgedeki aramaların kelimeler arasında nasıl bölündüğünü yüzde olarak verir. İkisi birlikte, bir kelimenin nerede en güçlü olduğunu ve diğerlerine karşı nerede öne geçip nerede geride kaldığını gösterir. Bölge adları seçtiğiniz dilde döner.

İlgili Aramalar ve Yükselen Konular

related raporu, insanların bir kelimenin yanında neler aradığını döndürür: en çok aranan ve yükselen ilgili aramalar ile en çok aranan ve yükselen ilgili konular. Her konu, kategorisiyle birlikte gelir. Rapor istek başına tek bir kelime alır.

En çok arananlar listelerinde value 0–100 arası göreli ilgidir. Yükselenler listelerinde ise önceki döneme göre yüzde artışı gösterir; bu da onları yeni içerik fikirleri ve ilgi görmeye yeni başlayan uzun kuyruklu kelimeler için iyi bir kaynak yapar.

Yaş ve Cinsiyet Demografisi

Google Trends insanların nerede ve ne zaman aradığını gösterir, ama kimin aradığını göstermez. demographics raporu bu boşluğu, en fazla beş kelime için yaş grubuna ve cinsiyete göre ilgiyle doldurur. Bu rapor Google verisi değil, tıklama akışı (clickstream) verisine dayalı bir tahmindir.

Değerler, kelimenin en büyük grubuna göre 0–100 arasındadır; yani kaç kişinin aradığını değil, grupların birbirine göre nasıl dağıldığını gösterir. Rapor istek başına 0,00264 USD tutar. language ve search_type parametrelerini kullanmaz; bunlardan biri gönderilirse sessizce yok sayılmaz, reddedilir.

Trends 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. Her hata sabit bir kod, okunabilir bir mesaj ve faydalı olduğunda bir ipucu içerir; Accept-Language: tr göndererek mesajları Türkçe alabilirsiniz. Yanlış yazılmış bir parametre ise hatada adıyla ve bir öneriyle bildirilir.

İstekler task olarak çalışır. 60 saniyeden uzun süren bir istek task_id içeren bir 202 döndürür ve sonucu GET /v1/tasks/{task_id} ile alırsınız. Her yanıt task id'yi X-Task-Id header'ında taşır; sonuçlar task bittikten sonra 72 saat saklanır. Zaman aşımından sonra güvenle tekrar denemek için Idempotency-Key gönderin: 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