İçeriğe geç
FirmalarKarşılaştırAraçlarMetodolojiFirmalar için

Açık veri

Voicendex Public API

Yayınlı claim’ler ve taksonomi. Her satır ya kaynağıyla ya da Firma beyanı etiketiyle döner — ayrımı provenance alanı taşır. Sürüm 2.7.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 — satırları 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 JSONllms.txt

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

    Sürümlü taksonomi ağacı (UUID, slug, relationships; ?version= & ?updated_since=)

    ?version=2 geçmiş sürüme bakar (taslak dönmez). ?updated_since=2026-09-01T00:00:00Z delta. Her düğümde id + slug + title_en (çoğu henüz boş) vardır. Skor alanı yoktur.

  • GET /api/v1/openapi

    OpenAPI 3 spec

  • GET /api/v1/mcp

    MCP araç kataloğu (keşif JSON)

  • POST /api/v1/mcp

    MCP JSON-RPC (initialize, tools/list, tools/call) — yalnız okuma

  • POST /api/v1/vendor-metrics

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

  • GET /api/v1/quadrant

    Kanıt × Memnuniyet ızgarası — iki eksen, birleşik skor yok

MCP (v2.7.0)

POST /api/v1/mcp JSON-RPC 2.0 (streamable HTTP). Araçlar yalnız okur: list_products, get_product, get_taxonomy, compare_products, search_claims. Ürün skoru aracı yoktur — /products/{slug}/scores hâlâ 410. GET /api/v1/mcp keşif kataloğudur.

curl -sS https://www.voicendex.com/api/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"1"}}}'

curl -sS https://www.voicendex.com/api/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get_product","arguments":{"slug":"sestek-voice"}}}'
  • Claude / Cursor connector: URL https://www.voicendex.com/api/v1/mcp, transport streamable HTTP. İsteğe bağlı X-Api-Key.
  • OAuth yok — sonraki iterasyon. Yazma aracı yok.
  • Her araç çıktısında provenance + “eksik claim ≠ özellik yok” notu vardır. Atıf: “Data provided by Voicendex”.

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