API Dokümantasyonu

Marka ve sorgu verilerinize kendi sistemlerinizden erişin. Şu an salt-okunur (read-only) uçlar mevcuttur.

Kimlik Doğrulama

Bir API anahtarını Ayarlar sayfasından oluşturun (hesap başına en fazla 5 aktif anahtar). Her isteğe Authorization başlığında ekleyin:

Authorization: Bearer trk_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Anahtar yalnızca oluşturulduğu anda gösterilir, sonrasında saklanmaz — kaybederseniz yeni bir anahtar oluşturup eskisini iptal edin.

Hız Sınırı

Tüm API istekleri, hesabınızın IP adresi başına dakikada 100 istekle sınırlıdır. Limit aşıldığında 429 durum kodu döner.

GET /api/v1/brands

Hesabınızdaki aktif markaları listeler.

curl https://tracora.ai/api/v1/brands \
  -H "Authorization: Bearer trk_xxxx"

Örnek yanıt:

{
  "data": [
    {
      "id": "uuid",
      "name": "Marka Adı",
      "keywords": ["anahtar1", "anahtar2"],
      "competitors": ["Rakip A"],
      "created_at": "2026-01-01T00:00:00Z"
    }
  ]
}

GET /api/v1/queries

Çalıştırılmış sorguları ve sonuçlarını listeler, en yeniden eskiye sıralı.

Sorgu parametreleri (hepsi opsiyonel):

brandId — belirli bir markaya göre filtrele
engine — chatgpt, claude, perplexity, gemini, grok, deepseek, copilot
limit — varsayılan 20, en fazla 100

curl "https://tracora.ai/api/v1/queries?brandId=uuid&limit=50" \
  -H "Authorization: Bearer trk_xxxx"

Örnek yanıt:

{
  "data": [
    {
      "id": "uuid",
      "ai_engine": "perplexity",
      "prompt": "En iyi X markası hangisi?",
      "status": "completed",
      "created_at": "2026-01-01T00:00:00Z",
      "brands": { "id": "uuid", "name": "Marka Adı" },
      "results": {
        "ai_response": "...",
        "brand_mentioned": true,
        "mention_count": 2,
        "sentiment": "positive",
        "competitor_mentions": [
          { "name": "Rakip A", "mentioned": false, "mentionCount": 0 }
        ],
        "citations": ["https://example.com/..."]
      }
    }
  ]
}

MCP Sunucusu

Claude Desktop, Claude Code veya Cursor gibi MCP (Model Context Protocol) destekli asistanlara markalarınızı ve sorgu verilerinizi bağlayan resmi bir MCP sunucusu sağlıyoruz — list_brands ve list_queries araçlarını sunar, yukarıdaki API uçlarının ince bir sarmalayıcısıdır.

Maliyet ve kota

MCP araçları sadece zaten çalıştırılmış sorgu sonuçlarını okur — yeni bir AI sorgusu tetiklemez, planınızın günlük sorgu kotasını tüketmez. Tek geçerli sınır, yukarıdaki API genelindeki dakikada 100 istek hız sınırıdır.

git clone https://github.com/canerdem1234/tracora-mcp.git
cd tracora-mcp
npm install && npm run build

Kurulum ve MCP istemci yapılandırması için tracora-mcp deposunun README'ine bakın.

Hata Yanıtları

Tüm hatalar şu formatta döner:

{ "error": "Geçersiz veya eksik API anahtarı." }

401 — API anahtarı eksik, geçersiz veya iptal edilmiş
429 — hız sınırı aşıldı
500 — sunucu hatası

Ayarlar Destek Ana Sayfa