Vartovii Public API v1

Willkommen zur Vartovii Intelligence API. Nutzen Sie unsere API, um Trust Scores, Krypto-Forensik und Daten zur Arbeitgeberreputation direkt in Ihre Anwendungen zu integrieren.

Base URL

https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1

Authentication

Aktuell befindet sich die API in der öffentlichen Beta.

• Free Tier: Kein API-Schlüssel erforderlich. Beschränkt auf 10 Anfragen pro Tag pro IP.
• Pro Tier: API-Schlüssel erforderlich (bald verfügbar). Unbegrenzte Anfragen.

Endpoints

1. Check Service Health

Überprüfen Sie die Verfügbarkeit der API und erhalten Sie Endpunktinformationen.

GET /api/v1/health

Antwort:

{
  "status": "healthy",
  "api_version": "v1",
  "rate_limits": {
    "free_tier": "10 requests/day",
    "pro_tier": "Unlimited (coming soon)"
  },
  "endpoints": [
    "/api/v1/trust-score/{company}",
    "/api/v1/crypto/{slug}",
    "/api/v1/search"
  ]
}

---

2. Get Company Trust Score

Rufen Sie aggregierte Reputationsdaten und den Trust Score für jedes Unternehmen ab.

GET /api/v1/trust-score/{company}

Parameter:

• company: Name oder Slug des Unternehmens (z.B. "google", "bmw", "microsoft")

Beispielanfrage:

curl https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/trust-score/bmw

Antwort:

{
  "company": "BMW",
  "trust_score": 37.1,
  "risk_level": "CRITICAL",
  "total_reviews": 5621,
  "avg_rating": 3.97,
  "last_updated": "2026-01-28T20:37:52.865897",
  "api_version": "v1"
}

Risikostufen:

• LOW - Trust Score ≥ 70
• MEDIUM - Trust Score 50-69
• HIGH - Trust Score 40-49
• CRITICAL - Trust Score < 40

---

3. Crypto Project Analysis

Erhalten Sie umfassende Trust Scores und Metriken für Krypto-Projekte.

GET /api/v1/crypto/{slug}

Parameter:

• slug: Token-Symbol oder Slug (z.B. "bitcoin", "ethereum", "solana")

Beispielanfrage:

curl https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/crypto/bitcoin

Antwort:

{
  "name": "Bitcoin",
  "symbol": "BTC",
  "slug": "bitcoin",
  "trust_score": 87.0,
  "risk_level": "LOW",
  "price_usd": 89141.0,
  "market_cap": 1781914953851.0,
  "fdv": 1781916648348.0,
  "commits_last_30d": 500.0,
  "active_devs": 52.0,
  "last_updated": "2026-01-24T21:17:52.270273",
  "api_version": "v1"
}

---

4. Search

Vereinheitlichte Suche über Unternehmen und Krypto-Projekte hinweg.

GET /api/v1/search?q={query}&type={type}

Parameter:

• q (erforderlich): Suchanfrage (mindestens 2 Zeichen)
• type (optional): Nach Typ filtern - all, crypto oder company (Standard: all)

Beispielanfrage:

# Alle Entitäten durchsuchen
curl "https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/search?q=google"

# Nur Krypto-Projekte durchsuchen
curl "https://sentry-app-4p7rbtt5yq-oa.a.run.app/api/v1/search?q=bit&type=crypto"

Antwort:

{
  "query": "google",
  "count": 1,
  "results": [
    {
      "type": "company",
      "name": "Google",
      "trust_score": 76.5,
      "risk_level": "MEDIUM"
    }
  ],
  "api_version": "v1"
}

---

Rate Limiting

Tier	Limit	HTTP Header
Free (Öffentliche Beta)	10 Anfragen / Tag / IP	X-RateLimit-Limit: 10
Pro (Bald verfügbar)	Unbegrenzt	API-Schlüssel erforderlich

Rate-Limit-Header:

• X-RateLimit-Limit - Maximal erlaubte Anfragen
• X-RateLimit-Remaining - Verbleibende Anfragen im aktuellen Fenster
• X-RateLimit-Reset - Zeitpunkt, zu dem das Limit zurückgesetzt wird (Unix-Timestamp)

Fehlerantwort (429):

{
  "error": "Rate limit exceeded",
  "message": "10 per 1 day"
}

---

Fehlercodes

Code	Beschreibung
200	Erfolg
404	Entität nicht gefunden
429	Ratenlimit überschritten
500	Interner Serverfehler

---

Support

Für höhere Ratenlimits oder den Zugang zum Pro Tier kontaktieren Sie uns:

• E-Mail: support@sentryanalytic.com
• Dokumentation: https://vartovii.cloud/docs

---

Zuletzt aktualisiert: 28. Januar 2026