{"openapi":"3.1.0","info":{"title":"Kostoway API","description":"\nKostoway API, Semrush kaynaklı SEO verisini (alan adı özeti, backlink, organik\nanahtar kelime, rakip, referans alan adı, trafik geçmişi) JSON olarak sunar.\n\n**Kimlik doğrulama:** her istekte `X-API-Key: sm_...` başlığı. (`?api_key=` hâlâ\nkabul edilir ama önerilmez: adres satırındaki anahtar kayıtlara sızar.)\n\n**Zaman aşımı:** ilk kez sorgulanan bir alan adı canlı çekilir. İstemci zaman\naşımınızı **en az 120 saniye** yapın; sunucu 110 saniyede\npes eder ve krediyi iade eder.\n\n**Hatalar:** tüm hatalar aynı gövdeyle döner:\n`{\"error\": {\"code\": \"insufficient_credits\", \"message\": \"Yetersiz kredi\", \"request_id\": \"req_...\"}, \"detail\": \"Yetersiz kredi\"}`.\nProgramınız `error.code` alanına göre dallanmalı; `message`/`detail` insanlar içindir.\n\n**Başlıklar:** her yanıtta `X-Request-Id`; anahtarlı yanıtlarda `X-RateLimit-Limit`,\n`X-RateLimit-Remaining`, `X-RateLimit-Reset` (epoch saniye), `X-Credits-Charged`,\n`X-Credits-Remaining`; veri uçlarında `X-Cache: HIT|MISS`. 429 ve 503 yanıtlarında\n`Retry-After` bulunur.\n\n**Sandbox:** `X-API-Key: sm_test_kostoway` ile `/v1/domains/semrush.com/...` ve\n`/v1/domains/getkosto.com/...` uçlarını ücretsiz deneyin (yalnızca önbellek, IP başına\ndakikada 10 istek).\n\n**Sürümler:** değişiklikler `GET /v1/changelog`. Eski sürümsüz yollar `Wed, 01 Jul 2027 00:00:00 GMT`\ntarihinde kapanır.\n","version":"1.0.0"},"paths":{"/v1/domains/{domain}/overview":{"get":{"tags":["Alan adı"],"summary":"Get domain overview","description":"Authority score, organik/ücretli trafik, anahtar kelime, backlink ve referans alan adı sayıları.\nMaliyet: plans.costs.overview.","operationId":"getDomainOverview","security":[{"ApiKey":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir).","title":"Domain"},"description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir)."},{"name":"db","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"description":"Ülke veritabanı (us, uk, de, tr...). Boş = global.","title":"Db"},"description":"Ülke veritabanı (us, uk, de, tr...). Boş = global."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek.","default":false,"title":"Fresh"},"description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DomainOverview"}}},"headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}},"X-Cache":{"description":"HIT = önbellekten, MISS = canlı çekildi.","schema":{"type":"string"}}}},"401":{"description":"API anahtarı yok ya da geçersiz (missing_api_key, invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Yetersiz kredi (insufficient_credits)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Anahtar iptal edilmiş, süresi dolmuş ya da sandbox anahtarına kapalı (key_revoked, key_expired, sandbox_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (invalid_domain, unsupported_db, sandbox_domain, sandbox_not_cached, validation_error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Hız ya da günlük limit (rate_limited, daily_limit_reached); Retry-After başlığı var","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Kaynaktan veri çekilemedi (upstream_failed); kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Geçici yoğunluk (upstream_busy, upstream_refreshing, upstream_timeout); Retry-After başlığı var, kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/domains/{domain}/backlinks":{"get":{"tags":["Alan adı"],"summary":"List backlinks","description":"Backlink detayları: kaynak sayfa, anchor text, hedef URL (100 satır/sayfa).","operationId":"getBacklinks","security":[{"ApiKey":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir).","title":"Domain"},"description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir)."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Sayfa (100 satır/sayfa).","default":1,"title":"Page"},"description":"Sayfa (100 satır/sayfa)."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek.","default":false,"title":"Fresh"},"description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacklinksPage"}}},"headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}},"X-Cache":{"description":"HIT = önbellekten, MISS = canlı çekildi.","schema":{"type":"string"}}}},"401":{"description":"API anahtarı yok ya da geçersiz (missing_api_key, invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Yetersiz kredi (insufficient_credits)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Anahtar iptal edilmiş, süresi dolmuş ya da sandbox anahtarına kapalı (key_revoked, key_expired, sandbox_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (invalid_domain, unsupported_db, sandbox_domain, sandbox_not_cached, validation_error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Hız ya da günlük limit (rate_limited, daily_limit_reached); Retry-After başlığı var","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Kaynaktan veri çekilemedi (upstream_failed); kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Geçici yoğunluk (upstream_busy, upstream_refreshing, upstream_timeout); Retry-After başlığı var, kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/domains/{domain}/keywords":{"get":{"tags":["Alan adı"],"summary":"List organic keywords","description":"Organik anahtar kelimeler: pozisyon, hacim, CPC, zorluk, trafik payı, URL (100 satır/sayfa).","operationId":"getKeywords","security":[{"ApiKey":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir).","title":"Domain"},"description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir)."},{"name":"db","in":"query","required":false,"schema":{"type":"string","description":"Ülke veritabanı (us, uk, de, tr...).","default":"us","title":"Db"},"description":"Ülke veritabanı (us, uk, de, tr...)."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Sayfa (100 satır/sayfa).","default":1,"title":"Page"},"description":"Sayfa (100 satır/sayfa)."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek.","default":false,"title":"Fresh"},"description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KeywordsPage"}}},"headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}},"X-Cache":{"description":"HIT = önbellekten, MISS = canlı çekildi.","schema":{"type":"string"}}}},"401":{"description":"API anahtarı yok ya da geçersiz (missing_api_key, invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Yetersiz kredi (insufficient_credits)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Anahtar iptal edilmiş, süresi dolmuş ya da sandbox anahtarına kapalı (key_revoked, key_expired, sandbox_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (invalid_domain, unsupported_db, sandbox_domain, sandbox_not_cached, validation_error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Hız ya da günlük limit (rate_limited, daily_limit_reached); Retry-After başlığı var","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Kaynaktan veri çekilemedi (upstream_failed); kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Geçici yoğunluk (upstream_busy, upstream_refreshing, upstream_timeout); Retry-After başlığı var, kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/domains/{domain}/competitors":{"get":{"tags":["Alan adı"],"summary":"List organic competitors","description":"Organik rakipler: rakip alan adı, rekabet düzeyi, ortak kelime, trafik (tek sayfa).","operationId":"getCompetitors","security":[{"ApiKey":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir).","title":"Domain"},"description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir)."},{"name":"db","in":"query","required":false,"schema":{"type":"string","description":"Ülke veritabanı (us, uk, de, tr...).","default":"us","title":"Db"},"description":"Ülke veritabanı (us, uk, de, tr...)."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek.","default":false,"title":"Fresh"},"description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompetitorsPage"}}},"headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}},"X-Cache":{"description":"HIT = önbellekten, MISS = canlı çekildi.","schema":{"type":"string"}}}},"401":{"description":"API anahtarı yok ya da geçersiz (missing_api_key, invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Yetersiz kredi (insufficient_credits)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Anahtar iptal edilmiş, süresi dolmuş ya da sandbox anahtarına kapalı (key_revoked, key_expired, sandbox_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (invalid_domain, unsupported_db, sandbox_domain, sandbox_not_cached, validation_error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Hız ya da günlük limit (rate_limited, daily_limit_reached); Retry-After başlığı var","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Kaynaktan veri çekilemedi (upstream_failed); kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Geçici yoğunluk (upstream_busy, upstream_refreshing, upstream_timeout); Retry-After başlığı var, kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/domains/{domain}/refdomains":{"get":{"tags":["Alan adı"],"summary":"List referring domains","description":"Referans alan adları: otorite, backlink sayısı, ilk/son görülme, ülke (100 satır/sayfa).","operationId":"getRefdomains","security":[{"ApiKey":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir).","title":"Domain"},"description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir)."},{"name":"page","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"description":"Sayfa (100 satır/sayfa).","default":1,"title":"Page"},"description":"Sayfa (100 satır/sayfa)."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek.","default":false,"title":"Fresh"},"description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefdomainsPage"}}},"headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}},"X-Cache":{"description":"HIT = önbellekten, MISS = canlı çekildi.","schema":{"type":"string"}}}},"401":{"description":"API anahtarı yok ya da geçersiz (missing_api_key, invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Yetersiz kredi (insufficient_credits)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Anahtar iptal edilmiş, süresi dolmuş ya da sandbox anahtarına kapalı (key_revoked, key_expired, sandbox_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (invalid_domain, unsupported_db, sandbox_domain, sandbox_not_cached, validation_error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Hız ya da günlük limit (rate_limited, daily_limit_reached); Retry-After başlığı var","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Kaynaktan veri çekilemedi (upstream_failed); kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Geçici yoğunluk (upstream_busy, upstream_refreshing, upstream_timeout); Retry-After başlığı var, kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/domains/{domain}/history":{"get":{"tags":["Alan adı"],"summary":"Get traffic history","description":"Aylık organik trafik ve kelime geçmişi (en eski -> en yeni).","operationId":"getHistory","security":[{"ApiKey":[]}],"parameters":[{"name":"domain","in":"path","required":true,"schema":{"type":"string","description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir).","title":"Domain"},"description":"Alan adı, örn. example.com (şema, www. ve yol otomatik temizlenir)."},{"name":"db","in":"query","required":false,"schema":{"type":"string","description":"Ülke veritabanı (us, uk, de, tr...).","default":"us","title":"Db"},"description":"Ülke veritabanı (us, uk, de, tr...)."},{"name":"months","in":"query","required":false,"schema":{"type":"integer","maximum":240,"minimum":1,"description":"Kaç aylık geçmiş (1-240).","default":24,"title":"Months"},"description":"Kaç aylık geçmiş (1-240)."},{"name":"fresh","in":"query","required":false,"schema":{"type":"boolean","description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek.","default":false,"title":"Fresh"},"description":"true = önbellekteki kayıt 6 saatten eskiyse canlı çek."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HistoryPage"}}},"headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}},"X-Cache":{"description":"HIT = önbellekten, MISS = canlı çekildi.","schema":{"type":"string"}}}},"401":{"description":"API anahtarı yok ya da geçersiz (missing_api_key, invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Yetersiz kredi (insufficient_credits)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Anahtar iptal edilmiş, süresi dolmuş ya da sandbox anahtarına kapalı (key_revoked, key_expired, sandbox_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (invalid_domain, unsupported_db, sandbox_domain, sandbox_not_cached, validation_error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Hız ya da günlük limit (rate_limited, daily_limit_reached); Retry-After başlığı var","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Kaynaktan veri çekilemedi (upstream_failed); kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Geçici yoğunluk (upstream_busy, upstream_refreshing, upstream_timeout); Retry-After başlığı var, kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/bulk/overview":{"post":{"tags":["Toplu"],"summary":"Start a bulk overview job","description":"En fazla 50 alan adının özetini arka planda çeker; `Location` (GET /v1/bulk/{job_id}) ile izlenir.\nBenzersiz alan adı başına 1 kredi baştan düşülür; başarısız olanlar iade edilir. İşler sunucu\nyeniden başlatmalarına dayanıklıdır: yarıda kalan iş `failed` olur ve çalışmayan alan adları iade edilir.\nSandbox anahtarıyla kullanılamaz.","operationId":"startBulkOverview","security":[{"ApiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"description":"Aynı anahtar + aynı değer 24 saat içinde aynı işi döner, ikinci kez ücret alınmaz.","title":"Idempotency-Key"},"description":"Aynı anahtar + aynı değer 24 saat içinde aynı işi döner, ikinci kez ücret alınmaz."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkIn"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkAccepted"}}},"headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}},"Location":{"description":"İşin durum adresi: /v1/bulk/{job_id}","schema":{"type":"string"}}}},"401":{"description":"API anahtarı yok ya da geçersiz (missing_api_key, invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Yetersiz kredi (insufficient_credits)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Anahtar iptal edilmiş, süresi dolmuş ya da sandbox anahtarına kapalı (key_revoked, key_expired, sandbox_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Çakışma","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (invalid_domain, unsupported_db, sandbox_domain, sandbox_not_cached, validation_error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Hız ya da günlük limit (rate_limited, daily_limit_reached); Retry-After başlığı var","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Geçici yoğunluk (upstream_busy, upstream_refreshing, upstream_timeout); Retry-After başlığı var, kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/bulk/backlinks":{"post":{"tags":["Toplu"],"summary":"Start a bulk backlink profile job","description":"En fazla 200 alan adının backlink profilini tek seferde çeker: otorite skoru, backlink ve\nreferans alan adı sayısı, follow/nofollow/sponsored/ugc, bağlantı türleri, referans IP ve alt ağ,\naylık ziyaret, giden bağlantılar, en çok bağlantı veren ülkeler ve uzantılar.\n`Location` (GET /v1/bulk/{job_id}) ile izlenir. Alan adı başına kredi baştan düşülür, başarısız\nolanlar iade edilir. Daha önce sorgulanan alan adları önbellekten anında döner.\nSandbox anahtarıyla kullanılamaz.","operationId":"startBulkBacklinks","security":[{"ApiKey":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string","maxLength":255},{"type":"null"}],"description":"Aynı anahtar + aynı değer 24 saat içinde aynı işi döner, ikinci kez ücret alınmaz.","title":"Idempotency-Key"},"description":"Aynı anahtar + aynı değer 24 saat içinde aynı işi döner, ikinci kez ücret alınmaz."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkBacklinksIn"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkAccepted"}}},"headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}},"Location":{"description":"İşin durum adresi: /v1/bulk/{job_id}","schema":{"type":"string"}}}},"401":{"description":"API anahtarı yok ya da geçersiz (missing_api_key, invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"402":{"description":"Yetersiz kredi (insufficient_credits)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Anahtar iptal edilmiş, süresi dolmuş ya da sandbox anahtarına kapalı (key_revoked, key_expired, sandbox_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"409":{"description":"Çakışma","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (invalid_domain, unsupported_db, sandbox_domain, sandbox_not_cached, validation_error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Hız ya da günlük limit (rate_limited, daily_limit_reached); Retry-After başlığı var","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"503":{"description":"Geçici yoğunluk (upstream_busy, upstream_refreshing, upstream_timeout); Retry-After başlığı var, kredi iade edilir","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/bulk/{job_id}":{"get":{"tags":["Toplu"],"summary":"Get bulk job status","description":"Toplu işin durumu (queued | running | done | failed) ve o ana kadarki sonuçlar. Ücretsiz.","operationId":"getBulkJob","security":[{"ApiKey":[]}],"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkJob"}}},"headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}}}},"401":{"description":"API anahtarı yok ya da geçersiz (missing_api_key, invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Anahtar iptal edilmiş, süresi dolmuş ya da sandbox anahtarına kapalı (key_revoked, key_expired, sandbox_not_allowed)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"404":{"description":"Bulunamadı","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (validation_error, invalid_domain, unsupported_db ...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/v1/me":{"get":{"tags":["Hesap"],"summary":"Get API key status","description":"Kredi bakiyesi, geçerlilik, kullanım ve 30 günlük geçmiş. Ücretsiz (kredi düşmez).\nSandbox anahtarı `status: \"sandbox\"` profili döner.","operationId":"getMe","responses":{"200":{"description":"Successful Response","headers":{"X-Request-Id":{"description":"İsteğin kimliği (destek için).","schema":{"type":"string"}},"X-RateLimit-Limit":{"description":"Dakikalık istek limiti (30).","schema":{"type":"integer"}},"X-RateLimit-Remaining":{"description":"Bu dakikalık pencerede kalan istek.","schema":{"type":"integer"}},"X-RateLimit-Reset":{"description":"Pencerenin sıfırlanacağı an (epoch saniye).","schema":{"type":"integer"}},"X-Credits-Charged":{"description":"Bu istekte düşülen kredi.","schema":{"type":"number"}},"X-Credits-Remaining":{"description":"Kalan kredi ya da 'unlimited' (sandbox anahtarında gönderilmez; yerine X-Sandbox: true).","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Me"}}}},"401":{"description":"Anahtar gönderilmedi (missing_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"403":{"description":"Geçersiz anahtar (invalid_api_key)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"422":{"description":"Geçersiz parametre (validation_error, invalid_domain, unsupported_db ...)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}},"security":[{"ApiKey":[]}]}},"/v1/plans":{"get":{"tags":["Fiyat"],"summary":"List packages and endpoint costs","description":"Herkese açık fiyat listesi: kredi paketleri ve her uç noktanın kredi maliyeti.","operationId":"getPlans","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Plans"}}}}}}},"/v1/quote":{"get":{"tags":["Fiyat"],"summary":"Quote a custom credit amount","description":"Özel kredi miktarı için fiyat (ücretsiz, anahtar gerekmez). Aralık dışı → 422 `quote_out_of_range`.","operationId":"getQuote","parameters":[{"name":"credits","in":"query","required":true,"schema":{"type":"integer","description":"Özel kredi miktarı (plans.custom.min_credits–max_credits).","title":"Credits"},"description":"Özel kredi miktarı (plans.custom.min_credits–max_credits)."}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Quote"}}}},"422":{"description":"Geçersiz parametre (invalid_domain, unsupported_db, sandbox_domain, sandbox_not_cached, validation_error)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/health":{"get":{"tags":["Sistem"],"summary":"Service health","description":"`ok`: veri çekilebilir; `degraded`: kullanılabilir kaynak oturumu yok ya da kuyruk dolu\n(önbellekteki veriler yine döner). `last_success_at`: son başarılı canlı çekim (ISO 8601 UTC).","operationId":"getHealth","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}}}}},"/v1/changelog":{"get":{"tags":["Sistem"],"summary":"List API versions and changes","description":"Sürüm geçmişi (en yeni önce). Eski sürümsüz yollar 2027-07-01'de kapanır (Sunset başlığı).","operationId":"getChangelog","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ChangelogEntry"},"type":"array","title":"Response Getchangelog"}}}}}}}},"components":{"schemas":{"BacklinksPage":{"properties":{"domain":{"type":"string","title":"Domain"},"db":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Db","description":"Ülke veritabanı; null = global."},"fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fetched At","description":"Verinin kaynaktan çekildiği an, ISO 8601 UTC (2026-11-15T08:15:08Z)."},"cached":{"type":"boolean","title":"Cached","description":"Yanıt önbellekten mi geldi."},"cached_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cached At","description":"Önbelleğe yazıldığı an, ISO 8601 UTC."},"fresh_applied":{"type":"boolean","title":"Fresh Applied","description":"fresh=true istendi VE önbellek 6 saatten eski olduğu için canlı çekildi."},"credits":{"$ref":"#/components/schemas/Credits"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","description":"Bu sayfadaki satır sayısı."},"pagination":{"$ref":"#/components/schemas/Pagination"},"total_backlinks":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Backlinks"},"backlinks":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Backlinks"}},"additionalProperties":true,"type":"object","required":["domain","cached","fresh_applied","credits","pagination"],"title":"BacklinksPage"},"BulkAccepted":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","enum":["queued","running","done","failed"],"title":"Status"},"total":{"type":"integer","title":"Total","description":"Benzersiz alan adı sayısı."},"status_url":{"type":"string","title":"Status Url","description":"İşin durum adresi (Location başlığıyla aynı)."},"credits":{"$ref":"#/components/schemas/Credits"}},"additionalProperties":true,"type":"object","required":["job_id","status","total","status_url","credits"],"title":"BulkAccepted"},"BulkBacklinksIn":{"properties":{"domains":{"items":{"type":"string"},"type":"array","maxItems":200,"minItems":1,"title":"Domains","description":"En fazla 200 alan adı (kök alan adı)."}},"type":"object","required":["domains"],"title":"BulkBacklinksIn"},"BulkIn":{"properties":{"domains":{"items":{"type":"string"},"type":"array","maxItems":50,"minItems":1,"title":"Domains","description":"En fazla 50 alan adı."},"db":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Db","description":"Ülke veritabanı; boş = global."}},"type":"object","required":["domains"],"title":"BulkIn"},"BulkItem":{"properties":{"domain":{"type":"string","title":"Domain"},"ok":{"type":"boolean","title":"Ok"},"result":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Result"},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"}},"additionalProperties":true,"type":"object","required":["domain","ok"],"title":"BulkItem"},"BulkJob":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","enum":["queued","running","done","failed"],"title":"Status","description":"queued → running → done; failed = sunucu yeniden başladı ya da iş çöktü (çalışmayan alan adları iade edilir)."},"created":{"type":"string","title":"Created","description":"ISO 8601 UTC."},"started":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Started","description":"ISO 8601 UTC."},"finished":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Finished","description":"ISO 8601 UTC."},"error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error"},"total":{"type":"integer","title":"Total"},"done":{"type":"integer","title":"Done"},"db":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Db"},"results":{"items":{"$ref":"#/components/schemas/BulkItem"},"type":"array","title":"Results"}},"additionalProperties":true,"type":"object","required":["job_id","status","created","total","done"],"title":"BulkJob"},"ChangelogEntry":{"properties":{"version":{"type":"string","title":"Version"},"date":{"type":"string","title":"Date"},"changes":{"items":{"type":"string"},"type":"array","title":"Changes"}},"additionalProperties":true,"type":"object","required":["version","date","changes"],"title":"ChangelogEntry"},"CompetitorsPage":{"properties":{"domain":{"type":"string","title":"Domain"},"db":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Db","description":"Ülke veritabanı; null = global."},"fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fetched At","description":"Verinin kaynaktan çekildiği an, ISO 8601 UTC (2026-11-15T08:15:08Z)."},"cached":{"type":"boolean","title":"Cached","description":"Yanıt önbellekten mi geldi."},"cached_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cached At","description":"Önbelleğe yazıldığı an, ISO 8601 UTC."},"fresh_applied":{"type":"boolean","title":"Fresh Applied","description":"fresh=true istendi VE önbellek 6 saatten eski olduğu için canlı çekildi."},"credits":{"$ref":"#/components/schemas/Credits"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","description":"Bu sayfadaki satır sayısı."},"pagination":{"$ref":"#/components/schemas/Pagination"},"total_competitors":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Competitors"},"competitors":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Competitors"}},"additionalProperties":true,"type":"object","required":["domain","cached","fresh_applied","credits","pagination"],"title":"CompetitorsPage"},"Credits":{"properties":{"charged":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Charged","description":"Bu istekte düşülen kredi (iade edildiyse 0)."},"remaining":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Remaining","description":"Kalan kredi; sınırsız anahtarda ve sandbox anahtarında null."}},"additionalProperties":true,"type":"object","required":["charged"],"title":"Credits"},"DomainOverview":{"properties":{"domain":{"type":"string","title":"Domain"},"db":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Db","description":"Ülke veritabanı; null = global."},"fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fetched At","description":"Verinin kaynaktan çekildiği an, ISO 8601 UTC (2026-11-15T08:15:08Z)."},"cached":{"type":"boolean","title":"Cached","description":"Yanıt önbellekten mi geldi."},"cached_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cached At","description":"Önbelleğe yazıldığı an, ISO 8601 UTC."},"fresh_applied":{"type":"boolean","title":"Fresh Applied","description":"fresh=true istendi VE önbellek 6 saatten eski olduğu için canlı çekildi."},"credits":{"$ref":"#/components/schemas/Credits"},"metrics":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metrics","description":"authority_score, organic_traffic, paid_traffic, referring_domains, organic_keywords, paid_keywords, backlinks."}},"additionalProperties":true,"type":"object","required":["domain","cached","fresh_applied","credits"],"title":"DomainOverview"},"ErrorBody":{"properties":{"code":{"type":"string","title":"Code","description":"Kararlı makine kodu, örn. insufficient_credits."},"message":{"type":"string","title":"Message","description":"İnsan için Türkçe açıklama; değişebilir."},"request_id":{"type":"string","title":"Request Id","description":"X-Request-Id başlığıyla aynı; destek için iletin."},"details":{"anyOf":[{"items":{"$ref":"#/components/schemas/ErrorDetail"},"type":"array"},{"type":"null"}],"title":"Details"}},"additionalProperties":true,"type":"object","required":["code","message","request_id"],"title":"ErrorBody"},"ErrorDetail":{"properties":{"field":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Field"},"message":{"type":"string","title":"Message"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"}},"additionalProperties":true,"type":"object","required":["message"],"title":"ErrorDetail"},"ErrorResponse":{"properties":{"error":{"$ref":"#/components/schemas/ErrorBody"},"detail":{"type":"string","title":"Detail","description":"error.message ile aynı (geriye dönük uyumluluk)."}},"additionalProperties":true,"type":"object","required":["error","detail"],"title":"ErrorResponse"},"Health":{"properties":{"status":{"type":"string","enum":["ok","degraded"],"title":"Status"},"version":{"type":"string","title":"Version"},"scrape_queue":{"type":"integer","title":"Scrape Queue","description":"Sırada bekleyen canlı çekim sayısı."},"last_success_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Success At","description":"Son başarılı canlı çekim, ISO 8601 UTC (sunucu açıldığından beri yoksa null)."}},"additionalProperties":true,"type":"object","required":["status","version","scrape_queue"],"title":"Health"},"HistoryPage":{"properties":{"domain":{"type":"string","title":"Domain"},"db":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Db","description":"Ülke veritabanı; null = global."},"fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fetched At","description":"Verinin kaynaktan çekildiği an, ISO 8601 UTC (2026-11-15T08:15:08Z)."},"cached":{"type":"boolean","title":"Cached","description":"Yanıt önbellekten mi geldi."},"cached_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cached At","description":"Önbelleğe yazıldığı an, ISO 8601 UTC."},"fresh_applied":{"type":"boolean","title":"Fresh Applied","description":"fresh=true istendi VE önbellek 6 saatten eski olduğu için canlı çekildi."},"credits":{"$ref":"#/components/schemas/Credits"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","description":"Bu sayfadaki satır sayısı."},"pagination":{"$ref":"#/components/schemas/Pagination"},"months":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Months"},"history":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"History"},"latest_daily":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Latest Daily"}},"additionalProperties":true,"type":"object","required":["domain","cached","fresh_applied","credits","pagination"],"title":"HistoryPage"},"KeywordsPage":{"properties":{"domain":{"type":"string","title":"Domain"},"db":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Db","description":"Ülke veritabanı; null = global."},"fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fetched At","description":"Verinin kaynaktan çekildiği an, ISO 8601 UTC (2026-11-15T08:15:08Z)."},"cached":{"type":"boolean","title":"Cached","description":"Yanıt önbellekten mi geldi."},"cached_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cached At","description":"Önbelleğe yazıldığı an, ISO 8601 UTC."},"fresh_applied":{"type":"boolean","title":"Fresh Applied","description":"fresh=true istendi VE önbellek 6 saatten eski olduğu için canlı çekildi."},"credits":{"$ref":"#/components/schemas/Credits"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","description":"Bu sayfadaki satır sayısı."},"pagination":{"$ref":"#/components/schemas/Pagination"},"total_keywords":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Keywords"},"keywords":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Keywords"}},"additionalProperties":true,"type":"object","required":["domain","cached","fresh_applied","credits","pagination"],"title":"KeywordsPage"},"Me":{"properties":{"name":{"type":"string","title":"Name"},"key_hint":{"type":"string","title":"Key Hint"},"status":{"type":"string","title":"Status","description":"active | revoked | expired | no_credits | limit_reached | sandbox"},"created":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created","description":"ISO 8601 UTC."},"expires_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expires At","description":"YYYY-MM-DD; anahtar bu günün sonuna kadar (Europe/Istanbul) geçerlidir."},"days_left":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Days Left"},"plan":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Plan"},"credits":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Credits"},"unlimited":{"type":"boolean","title":"Unlimited"},"credits_used":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Credits Used"},"daily_limit":{"type":"integer","title":"Daily Limit","default":0},"usage_today":{"type":"integer","title":"Usage Today"},"remaining_today":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Remaining Today"},"usage_total":{"type":"integer","title":"Usage Total"},"last_used":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Used","description":"ISO 8601 UTC."},"history":{"additionalProperties":{"additionalProperties":true,"type":"object"},"type":"object","title":"History"}},"additionalProperties":true,"type":"object","required":["name","key_hint","status","unlimited","credits_used","usage_today","usage_total"],"title":"Me"},"Pagination":{"properties":{"page":{"type":"integer","title":"Page","description":"Dönen sayfa (1'den başlar)."},"page_size":{"type":"integer","title":"Page Size","description":"Sayfa başına satır."},"total":{"type":"integer","title":"Total","description":"Toplam satır sayısı (kaynağın bildirdiği)."},"total_pages":{"type":"integer","title":"Total Pages","description":"Toplam sayfa sayısı."},"has_more":{"type":"boolean","title":"Has More","description":"Sonraki sayfa var mı."},"paging":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paging","description":"\"first_page_only\": kaynak yalnızca ilk sayfayı verir (rakipler); total yine gerçek toplamdır."}},"additionalProperties":true,"type":"object","required":["page","page_size","total","total_pages","has_more"],"title":"Pagination"},"Plans":{"properties":{"currency":{"type":"string","title":"Currency"},"packages":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Packages"},"costs":{"additionalProperties":{"anyOf":[{"type":"integer"},{"type":"number"}]},"type":"object","title":"Costs"}},"additionalProperties":true,"type":"object","required":["currency"],"title":"Plans"},"Quote":{"properties":{"id":{"type":"string","const":"custom","title":"Id"},"name":{"type":"string","title":"Name"},"credits":{"type":"integer","title":"Credits"},"price":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Price"},"rate":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Rate"},"per_credit":{"anyOf":[{"type":"integer"},{"type":"number"}],"title":"Per Credit"},"days":{"type":"integer","title":"Days"}},"additionalProperties":true,"type":"object","required":["id","name","credits","price","rate","per_credit","days"],"title":"Quote"},"RefdomainsPage":{"properties":{"domain":{"type":"string","title":"Domain"},"db":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Db","description":"Ülke veritabanı; null = global."},"fetched_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Fetched At","description":"Verinin kaynaktan çekildiği an, ISO 8601 UTC (2026-11-15T08:15:08Z)."},"cached":{"type":"boolean","title":"Cached","description":"Yanıt önbellekten mi geldi."},"cached_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cached At","description":"Önbelleğe yazıldığı an, ISO 8601 UTC."},"fresh_applied":{"type":"boolean","title":"Fresh Applied","description":"fresh=true istendi VE önbellek 6 saatten eski olduğu için canlı çekildi."},"credits":{"$ref":"#/components/schemas/Credits"},"count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Count","description":"Bu sayfadaki satır sayısı."},"pagination":{"$ref":"#/components/schemas/Pagination"},"total_refdomains":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Refdomains"},"refdomains":{"items":{"additionalProperties":true,"type":"object"},"type":"array","title":"Refdomains"}},"additionalProperties":true,"type":"object","required":["domain","cached","fresh_applied","credits","pagination"],"title":"RefdomainsPage"}},"securitySchemes":{"ApiKey":{"type":"apiKey","description":"sm_ ile başlayan API anahtarınız. Denemek için herkese açık sandbox anahtarı: `sm_test_kostoway` (ücretsiz, yalnızca semrush.com ve getkosto.com, önbellekten, IP başına dakikada 10 istek).","in":"header","name":"X-API-Key"}}},"tags":[{"name":"Alan adı","description":"Tek alan adı için veri uçları (krediyle)."},{"name":"Toplu","description":"Arka planda çalışan toplu alan adı özeti."},{"name":"Hesap","description":"Anahtar durumu ve kredi bakiyesi (ücretsiz)."},{"name":"Fiyat","description":"Paketler, uç nokta maliyetleri ve özel fiyat teklifi."},{"name":"Sistem","description":"Servis sağlığı ve sürüm geçmişi."}],"servers":[{"url":"https://kostoway.getkosto.com","description":"Kostoway API"}]}