API-Referenz
Vollständige API-Referenz für Sentry Analytics.
Basis-URL: https://sentryanalytic.com
Authentifizierung
Die meisten Endpunkte sind öffentlich. Agent Tool Endpunkte erfordern einen API Key:
curl -H "X-API-Key: your-api-key" https://sentryanalytic.com/api/agent/...
Endpunkte für Unternehmen
Unternehmen suchen
GET /api/company/search?q=QUERY
Parameter:
| Name | Type | Required | Description |
|---|---|---|---|
| q | string | Yes | Suchanfrage |
| limit | int | No | Max. Ergebnisse (Standard: 10) |
Antwort:
{
"companies": [
{
"company_name": "BMW",
"company_slug": "bmw",
"trust_score": 74,
"review_count": 5621
}
]
}
Unternehmensdetails abrufen
GET /api/company/SLUG
Antwort:
{
"company_name": "BMW",
"company_slug": "bmw",
"trust_score": 74,
"risk_level": "MEDIUM",
"avg_rating": 3.97,
"review_count": 5621,
"sentiment": {
"positive": 50,
"negative": 40,
"neutral": 10
},
"data_freshness": "fresh",
"last_updated": "2025-12-27"
}
Smart Search
GET /api/search/smart?q=QUERY&auto_scrape=true
Parameter:
| Name | Type | Default | Description |
|---|---|---|---|
| q | string | required | Firmenname |
| country | string | "de" | Ländercode |
| auto_scrape | bool | true | Automatisches Auslösen des Scrapings |
Antwort:
{
"status": "found",
"company_name": "BMW",
"data_status": "fresh",
"review_count": 5621,
"scraping_jobs": []
}
AI Chat Endpunkte
Mit AI chatten
POST /api/ai/chat
Anfrage:
{
"message": "What's the Trust Score for BMW?",
"language": "auto",
"enable_grounding": false,
"enable_rag": true
}
Antwort:
{
"response": "BMW has a Trust Score of 74/100...",
"status": "ok",
"grounded": false,
"rag_used": true,
"tools_used": true,
"tool_calls": [
{"name": "search_company", "args": {"company_name": "BMW"}}
]
}
Health Check
GET /api/ai/chat/health
Antwort:
{
"status": "healthy",
"model": "gemini-2.5-flash",
"rag_corpus": "active"
}
Agent Tool Endpunkte
⚠️ Erfordert API Key: X-API-Key Header
Unternehmen suchen
POST /api/agent/search-company
Anfrage:
{
"company_name": "BMW",
"country": "de"
}
Trust Score abrufen
POST /api/agent/trust-score
Anfrage:
{
"company_name": "BMW"
}
Antwort:
{
"company_name": "BMW",
"trust_score": 74,
"risk_level": "MEDIUM",
"breakdown": {
"rating_quality": 22.2,
"sentiment": 12.5,
"volume": 20.0,
"consistency": 9.0,
"recency": 10.0
}
}
Unternehmen auflisten
POST /api/agent/list-companies
Anfrage:
{
"country": "de",
"limit": 10,
"sort_by": "trust_score"
}
Unternehmen vergleichen
POST /api/agent/compare-companies
Anfrage:
{
"company1": "BMW",
"company2": "Audi"
}
Analyse durchführen
POST /api/agent/run-analysis
Anfrage:
{
"company_name": "Spotify",
"country": "de"
}
Antwort:
{
"action": "analysis_started",
"company_name": "Spotify",
"company_slug": "spotify-ab1",
"scraping_jobs": ["uuid1", "uuid2", "uuid3", "uuid4"],
"message": "🚀 Analysis started!"
}
Unternehmensbewertungen abrufen
POST /api/agent/get-reviews
Anfrage:
{
"company_name": "BMW",
"sentiment": "positive",
"limit": 5
}
Scraping Endpunkte
Magic Search
POST /api/scraping/magic-search
Anfrage:
{
"company_name": "Spotify",
"country": "de",
"months_back": 24
}
Job Status abrufen
GET /api/scraping/jobs/JOB_ID
Antwort:
{
"job_id": "uuid",
"status": "running",
"source": "kununu",
"company_name": "Spotify",
"reviews_collected": 156,
"progress_percent": 78
}
Krypto-Endpunkte
Krypto-Projekte suchen
GET /api/v2/crypto/search?q=QUERY
Krypto-Projekt abrufen
GET /api/v2/crypto/project/SLUG
Antwort:
{
"name": "Polkadot",
"symbol": "DOT",
"trust_score": 81,
"risk_level": "LOW",
"price_usd": 7.25,
"market_cap": 9500000000,
"tvl": 1200000000
}
Fehlerantworten
Alle Endpunkte geben Fehler in diesem Format zurück:
{
"detail": "Company not found",
"status_code": 404
}
Gängige Status Codes:
| Code | Meaning |
|---|---|
| 200 | Erfolg |
| 400 | Ungültige Anfrage |
| 401 | Nicht autorisiert (API Key fehlt) |
| 404 | Nicht gefunden |
| 429 | Rate-Limit erreicht |
| 500 | Serverfehler |
Die API-Dokumentation ist auch unter /docs (Swagger UI) verfügbar.