Anahtar Kelime API

POST

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.

POST https://data.semust.com/v1/keyword-data

Kimlik Doğrulama

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

Başlık	Tür	Açıklama
`SEMUST-API-USER`	string	API kullanıcı adınız
`SEMUST-API-PASSWORD`	string	API şifreniz

API kimlik bilgilerini API Erişim sayfasından oluşturun.

İstek Başlıkları

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

İstek Parametreleri

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

keyword

string

gerekli

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

country

stringvarsayılan: "US"

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

language

stringvarsayılan: "en"

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

limit

integervarsayılan: 100

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

İstek Gövdesi

{
  "keyword": "seo tools",
  "country": "US",
  "language": "en",
  "limit": 100
}

Kod Örnekleri

Farklı dillerde SERP API'yi nasıl çağıracağınızı gösteren eksiksiz örnekler.

cURL

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
  }'

Yanıt

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.

Yanıt Alanları Referansı

Alan	Tür	Açıklama
`success`	boolean	Başarılı yanıtta her zaman true
`result_count`	integer	Döndürülen anahtar kelime sayısı
`cost`	float	USD cinsinden tahsil edilen gerçek maliyet
`data`	array	Anahtar kelime veri nesneleri dizisi

Anahtar Kelime Veri Nesnesi

Alan	Tür	Açıklama
`keyword`	string	Anahtar kelime terimi
`search_volume`	integer	Aylık arama hacmi
`cpc`	float	USD cinsinden tıklama başına maliyet
`competition`	float	Rekabet seviyesi (0-100)
`country`	string	Kod
`language`	string	Kod
`intent`	string	Arama amacı sınıflandırması
`competition_level`	string	Rekabet seviyesi: "low" (0-33), "medium" (34-66) veya "high" (67-100)
`related_keywords`	array \| null	İlgili anahtar kelime önerileri (dize dizisi veya null)

Başarılı Yanıt

{
  "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çlar	Hesaplama	Nihai Maliyet
0-33	Minimum ü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

API, ...+ dili otomatik konum eşleme ile destekler.

Desteklenen diller yükleniyor...

Hata Kodları

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

Durum	Kod	Açıklama
400	`INVALID_REQUEST`	İstek gövdesi hatalı biçimlendirilmiş veya gerekli alanlar eksik
400	`KEYWORD_REQUIRED`	Anahtar kelime alanı boş veya eksik
401	`INVALID_API_KEY`	Kimlik doğrulama başarısız — geçersiz kullanıcı adı veya şifre
401	`INVALID_CREDENTIALS`	Geçersiz kullanıcı adı veya şifre
401	`CREDENTIALS_EXPIRED`	API kullanıcı kimlik bilgilerinin süresi doldu
402	`INSUFFICIENT_CREDITS`	Hesabınızda yeterli kredi yok
403	`IP_NOT_WHITELISTED`	IP adresiniz beyaz listede değil
429	`RATE_LIMIT_EXCEEDED`	Çok fazla istek — hız sınırı aşıldı
500	`INTERNAL_ERROR`	Bir iç sunucu hatası oluştu
502	`WORKER_FAILED`	Anahtar kelime verileri alınamadı
504	`TIMEOUT`	İstek zaman aşımına uğradı (maks 10 dakika)

Hata Yanıtı

{
  "error": "Your account does not have enough credits",
  "code": "INSUFFICIENT_CREDITS"
}

Krediler & Hız Sınırları

Krediler

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

Hız Sınırları

İ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.