API Dokümantasyonu

Kimlik Doğrulama

API'yi kullanmak için bir API anahtarına ihtiyacınız var. Giriş yaptıktan sonra profil sayfanızdan API anahtarınızı oluşturabilirsiniz.

API Anahtarı Kullanımı

API anahtarınızı header veya query parameter olarak gönderebilirsiniz:

# Header ile
curl -H "X-API-Key: your_api_key_here" \
  "https://keyword.ismaiwz.com.tr/api/v1/keywords?q=ayakkabı"

# Query parameter ile  
curl "https://keyword.ismaiwz.com.tr/api/v1/keywords?q=ayakkabı&api_key=your_api_key_here"

API Endpoints

GET /api/v1/keywords

Belirtilen anahtar kelime için öneriler getirir.

Parametreler:

Parametre	Tip	Zorunlu	Açıklama
q	string	✅	Aranacak anahtar kelime
lang	string	❌	Dil (tr, en) - Varsayılan: tr
expand	boolean	❌	Genişletilmiş arama (2 kredi) - Varsayılan: false

Başarılı Yanıt:

{
  "success": true,
  "data": {
    "query": "ayakkabı",
    "language": "tr",
    "expanded": false,
    "keywords": [
      "ayakkabı modelleri",
      "ayakkabı fiyatları",
      "ayakkabı mağazası",
      "ayakkabı markaları"
    ],
    "count": 4,
    "creditsUsed": 1,
    "remainingCredits": 29
  }
}

Kullanım Örnekleri

JavaScript (Fetch API)

const apiKey = 'your_api_key_here';
const query = 'ayakkabı';

fetch(`https://keyword.ismaiwz.com.tr/api/v1/keywords?q=${query}&lang=tr`, {
  headers: {
    'X-API-Key': apiKey
  }
})
.then(response => response.json())
.then(data => {
  if (data.success) {
    console.log('Anahtar kelimeler:', data.data.keywords);
    console.log('Kalan kredi:', data.data.remainingCredits);
  }
})
.catch(error => console.error('Hata:', error));

Python (Requests)

import requests

api_key = 'your_api_key_here'
url = 'https://keyword.ismaiwz.com.tr/api/v1/keywords'

headers = {
    'X-API-Key': api_key
}

params = {
    'q': 'ayakkabı',
    'lang': 'tr',
    'expand': False
}

response = requests.get(url, headers=headers, params=params)
data = response.json()

if data['success']:
    keywords = data['data']['keywords']
    print(f"Bulunan {len(keywords)} anahtar kelime:")
    for keyword in keywords:
        print(f"- {keyword}")
else:
    print(f"Hata: {data['error']}")

PHP (cURL)

Hata Kodları

HTTP Kodu	Açıklama	Çözüm
400	Bad Request - Geçersiz parametreler	Parametreleri kontrol edin
401	Unauthorized - Geçersiz API anahtarı	API anahtarınızı kontrol edin
429	Too Many Requests - Limit aşıldı	Günlük limitinizi kontrol edin
500	Internal Server Error - Sunucu hatası	Destek ekibiyle iletişime geçin

Hata Yanıt Formatı:

{
  "success": false,
  "error": "Query parameter 'q' is required",
  "code": 400
}

Rate Limiting

Başlangıç Paketi

• 30 günlük kredi
• Normal arama: 1 kredi
• Genişletilmiş arama: 2 kredi
• Günlük sıfırlama

Profesyonel Paketi

• 100 günlük kredi
• Normal arama: 1 kredi
• Genişletilmiş arama: 2 kredi
• Günlük sıfırlama

Not: Günlük limitler her gün gece yarısı (UTC) sıfırlanır. Kalan kredi miktarınızı API yanıtlarında görebilirsiniz.

İçindekiler