API Reference
Повний довідник API для Sentry Analytics.
Базовий URL: https://sentryanalytic.com
Authentication
Більшість кінцевих точок є публічними. Кінцеві точки інструментів агента вимагають API key:
curl -H "X-API-Key: your-api-key" https://sentryanalytic.com/api/agent/...
Кінцеві точки компаній
Пошук компаній
GET /api/company/search?q=QUERY
Параметри:
| Назва | Тип | Обов'язковий | Опис |
|---|---|---|---|
| q | string | Так | Пошуковий запит |
| limit | int | Ні | Максимальна кількість результатів (за замовчуванням: 10) |
Відповідь:
{
"companies": [
{
"company_name": "BMW",
"company_slug": "bmw",
"trust_score": 74,
"review_count": 5621
}
]
}
Отримати деталі компанії
GET /api/company/SLUG
Відповідь:
{
"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"
}
Розумний пошук
GET /api/search/smart?q=QUERY&auto_scrape=true
Параметри:
| Назва | Тип | За замовчуванням | Опис |
|---|---|---|---|
| q | string | обов'язковий | Назва компанії |
| country | string | "de" | Код країни |
| auto_scrape | bool | true | Автоматичний запуск скрапінгу |
Відповідь:
{
"status": "found",
"company_name": "BMW",
"data_status": "fresh",
"review_count": 5621,
"scraping_jobs": []
}
Кінцеві точки AI чату
Чат з AI
POST /api/ai/chat
Запит:
{
"message": "What's the Trust Score for BMW?",
"language": "auto",
"enable_grounding": false,
"enable_rag": true
}
Відповідь:
{
"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"}}
]
}
Перевірка стану
GET /api/ai/chat/health
Відповідь:
{
"status": "healthy",
"model": "gemini-2.5-flash",
"rag_corpus": "active"
}
Кінцеві точки інструментів агента
⚠️ Потрібен API Key: заголовок X-API-Key
Пошук компанії
POST /api/agent/search-company
Запит:
{
"company_name": "BMW",
"country": "de"
}
Отримати Trust Score
POST /api/agent/trust-score
Запит:
{
"company_name": "BMW"
}
Відповідь:
{
"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
}
}
Перелік компаній
POST /api/agent/list-companies
Запит:
{
"country": "de",
"limit": 10,
"sort_by": "trust_score"
}
Порівняння компаній
POST /api/agent/compare-companies
Запит:
{
"company1": "BMW",
"company2": "Audi"
}
Запуск аналізу
POST /api/agent/run-analysis
Запит:
{
"company_name": "Spotify",
"country": "de"
}
Відповідь:
{
"action": "analysis_started",
"company_name": "Spotify",
"company_slug": "spotify-ab1",
"scraping_jobs": ["uuid1", "uuid2", "uuid3", "uuid4"],
"message": "🚀 Аналіз розпочато!"
}
Отримати відгуки компанії
POST /api/agent/get-reviews
Запит:
{
"company_name": "BMW",
"sentiment": "positive",
"limit": 5
}
Кінцеві точки скрапінгу
Магічний пошук
POST /api/scraping/magic-search
Запит:
{
"company_name": "Spotify",
"country": "de",
"months_back": 24
}
Отримати статус завдання
GET /api/scraping/jobs/JOB_ID
Відповідь:
{
"job_id": "uuid",
"status": "running",
"source": "kununu",
"company_name": "Spotify",
"reviews_collected": 156,
"progress_percent": 78
}
Кінцеві точки криптовалют
Пошук криптопроектів
GET /api/v2/crypto/search?q=QUERY
Отримати криптопроект
GET /api/v2/crypto/project/SLUG
Відповідь:
{
"name": "Polkadot",
"symbol": "DOT",
"trust_score": 81,
"risk_level": "LOW",
"price_usd": 7.25,
"market_cap": 9500000000,
"tvl": 1200000000
}
Відповіді про помилки
Усі кінцеві точки повертають помилки в такому форматі:
{
"detail": "Company not found",
"status_code": 404
}
Поширені коди стану:
| Код | Значення |
|---|---|
| 200 | Успіх |
| 400 | Невірний запит |
| 401 | Несанкціоновано (відсутній API key) |
| 404 | Не знайдено |
| 429 | Обмеження за частотою запитів |
| 500 | Помилка сервера |
Документація API також доступна за адресою /docs (Swagger UI).