Voicendex
Menü
Ana SayfaKarşılaştırAkışAraçlarAI AnalistMetodoloji

Açık veri

Voicendex Public API

Yayınlı, kaynaklı claim’ler ve taksonomi — kanıtsız veri dönülmez. Sürüm 2.1.0.

v2.0.0 kırıcı değişiklik (9 Ağu 2026): skor ve veri doluluğu yüzdesi dönen alanlar kaldırıldı; /api/v1/products/{slug}/scores artık 410 döner. Bir firmayı tek sayıya indirmiyoruz — kaynaklı claim’leri okuyup kendi kararınızı verin. Gerekçe: Metodoloji. Kaldırılan yüzeyler her yanıtın meta.deprecations alanında listelenir.

← AraçlarLabMetodolojiOpenAPI JSON

Atıf zorunluluğu

Bu API’den üretilen her kamuya açık rapor, makale veya ürün arayüzünde şu atıf görünür olmalıdır:

“Data provided by Voicendex”

Her JSON yanıtında meta.attribution ve X-CX-Attribution header’ı vardır. Yöntemin tamamı Metodoloji sayfasındadır.

Kimlik doğrulama & kota

  • Anonim: 60 istek/dakika / IP — anahtar gerekmez.
  • API key: header X-Api-Key: cxk_… veya Authorization: Bearer cxk_…. Varsayılan 300/dk (admin ayarlar).
  • Daha yüksek kota için API anahtarı Voicendex ekibinden talep edilir. Platform ve API ücretsizdir.

Uç noktalar

  • GET /api/v1/products

    Aktif ürün listesi + özet sayaçlar

  • GET /api/v1/products/{slug}

    Ürün, yayınlı claim’ler, lab özeti (DX rubrik + kaynaklar)

  • GET /api/v1/taxonomy

    Aktif taksonomi ağacı

  • GET /api/v1/openapi

    OpenAPI 3 spec

  • GET /api/v1/mcp

    İnce MCP araç kataloğu (keşif)

  • POST /api/v1/vendor-metrics

    Firma kendi çağrı hacmini bildirir (yazma; firmaya bağlı anahtar gerekir)

Çağrı hacmi bildirimi (yazma — v2.1.0)

Firmalar kendi çağrı hacimlerini POST /api/v1/vendor-metrics ile bildirebilir. Bunun için anahtarın bir firmaya bağlı ve metrics:write yetkili olması gerekir — okuma anahtarı bu uçta 403 alır. Anahtarı admin üretir.

curl -sS -X POST "https://www.voicendex.com/api/v1/vendor-metrics" \
  -H "X-Api-Key: cxk_…" -H "Content-Type: application/json" \
  -d '{
    "product_slug": "ornek-voice",
    "metrics": [
      { "day": "2026-08-08", "calls_total": 12400, "calls_answered": 11980,
        "avg_duration_sec": 143 }
    ]
  }'
  • Aynı (ürün, gün, periyot) tekrar gönderilirse üzerine yazar — tekrar gönderim trafiği ikiye katlamaz.
  • Tek satır ya da metrics: [...] dizisi (en fazla 366 satır) — geçmişi toplu doldurabilirsiniz.
  • period: "month" ile aylık toplam da gönderilebilir (tarih ayın 1'i). Günlük seri varsa günlük olan gösterilir; ikisi toplanmaz.
  • Yanıt saklanan satırları döndürür — entegrasyonu “200 OK”a değil gövdeye bakarak doğrulayın.
  • Yalnız agrega sayaç kabul edilir. Numara, çağrı kaydı, konuşma metni yok (KVKK).

Bu sayılar claim değildir. Profilde “firma beyanı” etiketiyle görünürler; Kanıt Kartı'na, kriter doluluğuna ve karşılaştırmaya girmezler. Taksonomideki günlük/eşzamanlı çağrı kriterleri kaynak + birebir alıntı zorunlu olan normal yoldan devam eder. peak_concurrent bir kapasite beyanıdır (ölçüm değil) ve kamu profilinde gösterilmez.

Örnek

curl -sS "https://www.voicendex.com/api/v1/products/vapi-voice" \
  -H "X-Api-Key: cxk_…" | jq '.data.claims[] | {criterion_key, value, source_url}'

Ürün slug’ları için GET /api/v1/products.

Kapsam dışı

  • GraphQL uç noktası yoktur; API REST’tir.
  • İnceleme aşamasındaki veya yayından kaldırılmış kayıtlar hiçbir uç noktadan dönmez — API yalnız yayınlı veriyi okur.
  • Vitrin, Kör Tadım ve topluluk puanı karşılaştırma verisine karışmaz.
  • Firma sistemlerini kendiliğinden yoklayan bir toplayıcı yoktur: yayınlanan veri, firmanın kendi gönderdiği ve kaynağıyla doğrulanan veridir.