API Setup'a Dön🟢 Google Keyword Planner Kurulumu

Google'ın Resmi
Keyword Planner API

Google'ın resmi ve ücretsiz anahtar kelime verileri. Milyarlarca gerçek arama sorgusu ve CPC bilgilerine tam erişim.

Resmi Google Verisi

Direkt Google'dan

Ücretsiz

$0 maliyet

Güncel Veriler

Anlık güncellemeler

Güvenilir

%100 doğru veriler

Adım Adım Kurulum Rehberi

Toplam süre: ~15 dakika • Zorluk: Orta

1
2
3
4
5
1

Google Ads Hesabı Oluşturun

5 dakika

Keyword Planner'a erişim için Google Ads hesabı gerekli

Google Ads'e gidin ve 'Şimdi Başlayın' tıklayın
İş hedeflerinizi seçin (herhangi birini seçebilirsiniz)
Reklam kampanyası oluşturmayı geçin (sonra iptal edebilirsiniz)
Ödeme bilgilerini girin (ücret kesilmez)
Hesabınızı doğrulayın

Kredi kartı bilgisi gerekli ama ücret kesilmez. Sadece hesap doğrulaması için.

Google Ads'e Git
2

Google Cloud Console Projesİ

3 dakika

API kullanımı için Google Cloud projesi oluşturun

Google Cloud Console'a gidin
Yeni proje oluşturun: 'SEOTING Keyword Analysis'
Proje ID'sini kopyalayın (sonra lazım olacak)
Billing hesabı bağlayın (ücretsiz tier kullanacağız)
Projeyi aktifleştirin

Billing gerekli ama Google $300 ücretsiz kredi veriyor. Keyword Planner ücretsiz.

Cloud Console'a Git
3

Google Ads API'sını Aktifleştirin

2 dakika

Keyword Planner verilerine programatik erişim

Cloud Console'da APIs & Services → Library
'Google Ads API' arayın ve aktifleştirin
Credential oluşturun: APIs & Services → Credentials
'OAuth 2.0 Client ID' seçin
Application type: 'Web application' seçin

OAuth 2.0 seçin, API key değil. Keyword Planner OAuth gerektirir.

API Library'e Git
4

Developer Token Alın

2 dakika

Google Ads hesabınızdan özel token alın

Google Ads hesabına gidin
Tools & Settings → Setup → API Center
'Create Token' tıklayın
Token'ı kopyalayın ve saklayın
Token test modunda başlar (yeterli bizim için)

Token ilk başta 'Test' modunda. Production için Google'a başvuru gerekir.

Google Ads'e Git
5

Environment Variables Kurulumu

1 dakika

API anahtarlarını projeye ekleyin

.env.local dosyasını açın
Aşağıdaki değişkenleri ekleyin
Değerleri kendi bilgilerinizle değiştirin
Dosyayı kaydedin
Sunucuyu yeniden başlatın

Bu bilgileri asla GitHub'a commit etmeyin!

Environment Variables (.env.local)

OAuth 2.0 Client ID

GOOGLE_ADS_CLIENT_ID=your-client-id.googleusercontent.com

OAuth 2.0 Client Secret

GOOGLE_ADS_CLIENT_SECRET=your-client-secret

OAuth 2.0 Refresh Token

GOOGLE_ADS_REFRESH_TOKEN=your-refresh-token

Google Ads Developer Token

GOOGLE_ADS_DEVELOPER_TOKEN=your-developer-token

Google Ads Müşteri ID (tire olmadan)

GOOGLE_ADS_CUSTOMER_ID=123-456-7890
Güvenlik: Bu değişkenleri .env.local dosyasına ekleyin ve asla GitHub'a commit etmeyin. .gitignore dosyası zaten .env.local'i hariç tutuyor.

🎉 Kurulum Tamamlandı!

Artık Google'ın resmi anahtar kelime verilerini kullanabilirsiniz. Aracı test etmek için aşağıdaki butona tıklayın.

Aracı Test EtTeknik Destek

🔧 Sorun Giderme

"Developer token in test mode" hatası

Bu normal! Test modunda sınırlı veriye erişim var ama bizim için yeterli.

Production modu için Google'a başvuru gerekir (~2 hafta).

"Authentication failed" hatası

OAuth token'ın süresi dolmuş. Refresh token ile yeni token alın.

Otomatik token yenileme sistemi aktif.

"Quota exceeded" hatası

Günlük API limiti dolmuş. 24 saat bekleyin veya billing aktifleştirin.

Google $300 ücretsiz kredi veriyor.