API Platformu

Anahtar Kelime API

Birden fazla dil ve ülkede herhangi bir anahtar kelime için arama hacmi, TBM, rekabet ve arama amacı dahil olmak üzere kapsamlı anahtar kelime metrikleri…

Birden fazla dil ve ülkede herhangi bir anahtar kelime için arama hacmi, TBM, rekabet ve arama amacı dahil olmak üzere kapsamlı anahtar kelime metrikleri alın.

Ürün sayfası: Anahtar Kelime API.

Kimlik Doğrulama

Tüm istekler başlık tabanlı kimlik doğrulama gerektirir. Her istekte API kimlik bilgilerinizi ekleyin.

HeaderTypeAçıklama
SEMUST-API-USERstringAPI kullanıcınızın kullanıcı adı
SEMUST-API-PASSWORDstringAPI kullanıcınızın şifresi

API kimlik bilgilerini API Erişim sayfasında doğrulayabilirsiniz.

SEMUST-API-USER: your_username
SEMUST-API-PASSWORD: your_password

Request Parameters

Aşağıdaki parametrelerle bir application/json gövdesi gönderin:

Body

keywordstringrequired

Analiz edilecek anahtar kelime (örn., 'seo araçları', 'en iyi kahve dükkanları')

countrystringdefault: US

Coğrafi hedefli veriler için ISO 3166-1 alpha-2 ülke kodu. Örnekler: "US", "GB", "DE", "TR".

languagestringdefault: en

Dil kodu (ISO 639-1). Arama sonuçlarının dilini kontrol eder. Örnekler: "en", "tr", "de", "fr", "es".

limitintegerdefault: 100

Döndürülecek maksimum anahtar kelime sonucu sayısı. Minimum: 1, Maksimum: 1000. Daha yüksek limitler maliyeti artırabilir.

match_typestringdefault: broad

Anahtar kelime eşleşme tipi. Seçenekler: "broad" (varsayılan — ilişkili anahtar kelimeler), "phrase_match" (sadece girilen ifadeyi içeren anahtar kelimeler), "exact_match" (sadece girilen anahtar kelime, limit=1 olarak ayarlanır), "related" (sadece anlamsal olarak ilişkili sonuçlar).

match_type

DeğerNe döndürür
broadAnlamsal olarak ilişkili kelimeler (varsayılan)
phrase_matchYalnızca tohum ifadeyi içeren kelimeler
exact_matchYalnızca tam kelime — limit zorunlu olarak 1 olur
relatedAlt dize eşleşmesi olmadan saf anlamsal sonuçlar
{
  "keyword": "seo tools",
  "country": "US",
  "language": "en",
  "limit": 100,
  "match_type": "broad"
}

Kod Örnekleri

Aşağıda Keyword Data API'yi farklı dillerden çağırmanın örnekleri yer alıyor.

curl -X POST https://data.semust.com/v1/keyword-data \
  -H "Content-Type: application/json" \
  -H "SEMUST-API-USER: your_username" \
  -H "SEMUST-API-PASSWORD: your_password" \
  -d '{
    "keyword": "seo tools",
    "country": "US",
    "language": "en",
    "limit": 100,
    "match_type": "broad"
  }'

Response

Anahtar kelime metrikleri ve maliyet bilgileri içeren bir JSON nesnesi döndürür.

Not

Sonuçlar arama hacmine göre en yüksekten en düşüğe sıralanır.

Response Fields Reference

AlanTypeAçıklama
successbooleanBaşarılı yanıtta her zaman true
result_countintegerDöndürülen anahtar kelime sayısı
costfloatUSD cinsinden tahsil edilen gerçek maliyet
dataarrayAnahtar kelime veri nesneleri dizisi

Anahtar Kelime Veri Nesnesi

AlanTypeAçıklama
keywordstringAnahtar kelime terimi
search_volumeintegerAylık arama hacmi
cpcfloatUSD cinsinden tıklama başına maliyet
competitionfloatRekabet seviyesi (0-100)
countrystringKod
languagestringKod
intentstringArama amacı sınıflandırması
competition_levelstringRekabet seviyesi: "low" (0-33), "medium" (34-66) veya "high" (67-100)
related_keywordsarray | nullİlgili anahtar kelime önerileri (dize dizisi veya null)
{
  "success": true,
  "result_count": 3,
  "cost": 0.01,
  "data": [
    {
      "keyword": "seo tools",
      "search_volume": 12100,
      "cpc": 15.75,
      "competition": 85,
      "competition_level": "high",
      "country": "us",
      "language": "en",
      "intent": "commercial",
      "related_keywords": ["best seo tools", "free seo tools"]
    },
    {
      "keyword": "best seo tools",
      "search_volume": 8100,
      "cpc": 12.50,
      "competition": 72,
      "competition_level": "high",
      "country": "us",
      "language": "en",
      "intent": "commercial",
      "related_keywords": null
    },
    {
      "keyword": "free seo tools",
      "search_volume": 5400,
      "cpc": 8.25,
      "competition": 45,
      "competition_level": "medium",
      "country": "us",
      "language": "en",
      "intent": "informational",
      "related_keywords": null
    }
  ]
}

Fiyatlandırma

Ön ödeme ve otomatik iade ile sonuç tabanlı fiyatlandırma.

Formül

Cost = max($0.01, (result_count / 100) × $0.03)

Fiyatlandırma Örnekleri

SonuçHesaplamaNihai maliyet
0-33Minimum ücret$0.01
50(50/100) × $0.03$0.015
100(100/100) × $0.03$0.03
150(150/100) × $0.03$0.045
200(200/100) × $0.03$0.06

Ön Ödeme

0,03 $ peşin (maksimum fiyat) olarak ücretlendirilirsiniz ve işlem tamamlandıktan sonra fazlalık iade edilir. Bu, yalnızca alınan gerçek sonuçlar için ücretlendirme yaparken bakiyenizin yeterli olmasını sağlar.

Hatalarda Tam İade

İsteğiniz zaman aşımı, çalışan hataları veya herhangi bir sunucu sorunu nedeniyle başarısız olursa, otomatik olarak tam iade alırsınız. Yalnızca API başarıyla anahtar kelime verilerini döndürdüğünde ücretlendirilirsiniz.

Desteklenen Diller

Diller yükleniyor…

Bir dil kodu bulunamazsa, sistem varsayılan olarak Türkçe'ye (tr) döner.

Hata Kodları

Tüm hatalar, insan tarafından okunabilir bir mesaj ve bir hata kodu içeren bir JSON nesnesi döndürür.

HTTPKodAnlamı
400INVALID_REQUESTİstek gövdesi hatalı biçimlendirilmiş veya gerekli alanlar eksik
400KEYWORD_REQUIREDAnahtar kelime alanı boş veya eksik
400INVALID_MATCH_TYPEmatch_type değeri geçerli değil. İzin verilen değerler: broad, phrase_match, exact_match, related.
401INVALID_API_KEYKimlik doğrulama başarısız — geçersiz kullanıcı adı veya şifre
401INVALID_CREDENTIALSGeçersiz kullanıcı adı veya şifre
401CREDENTIALS_EXPIREDAPI kullanıcı kimlik bilgilerinin süresi doldu
402INSUFFICIENT_CREDITSHesabınızda yeterli kredi yok
403IP_NOT_WHITELISTEDIP adresiniz beyaz listede değil
429RATE_LIMIT_EXCEEDEDÇok fazla istek — hız sınırı aşıldı
500INTERNAL_ERRORBir iç sunucu hatası oluştu
502WORKER_FAILEDAnahtar kelime verileri alınamadı
504TIMEOUTİstek zaman aşımına uğradı (maks 10 dakika)
{
  "error": "Your account does not have enough credits",
  "code": "INSUFFICIENT_CREDITS"
}

Krediler & Rate Limits

Krediler

Her istek, bakiyenizden kredi tüketir. Maliyet, mobile parametresine göre değişebilir. Bakiyeniz yetersizse, API HTTP 402 döndürür.

Rate Limits

İstekler, planınıza göre dakika başına ve gün başına sınırlara tabidir. Sınırların aşılması HTTP 429 döndürür.

Son güncelleme: 2026-08-22