Skip to main content

Corporate Intelligence API

Overview​

Endpoints for company analysis, trust scores, and review aggregation.

Base URL​

https://api.vartovii.com (Production)

📊 Company Overview​

Get Corporate Overview​

GET /api/corporate/overview

Returns high-level platform metrics for the Corporate Dashboard.

Response:

{
  "total_reviews": 15420,
  "total_companies": 120,
  "trust_score": 78,
  "system_status": "operational"
}

🔍 Company Analysis​

Run AI Analysis (Async)​

POST /api/ai/run-analysis

Triggers a background job for comprehensive analysis (Sentiment + ABSA).

Auth required: X-Internal-Key or X-Admin-Token.

Body:

{
  "company_name": "Volkswagen AG",
  "limit": 100
}

Operational note: ABSA execution is triggered in-process by the backend service (no localhost HTTP loopback dependency between replicas).

Get Trust Score​

GET /api/employer/{company_name}/trust-score

Returns the unified Employer Trust Score (0-100) aggregating Kununu, Google, and Glassdoor.

Parameters:

  • company_name: Company name/slug
  • country: Country code (default: "de")
  • refresh: Boolean to force recalculation

Response:

{
  "trust_score": 82,
  "confidence_level": "high",
  "score_breakdown": {
    "rating_quality": 85,
    "sentiment": 78,
    "volume": 90
  }
}

🔎 Search & Discovery​

GET /api/search/smart

Intelligent search that auto-triggers scraping if data is missing.

Parameters:

  • q: Search query
  • auto_scrape: true/false

Operational note: in cloud mode, newly created scraping jobs are dispatched to workers immediately after job creation. Response payloads may include both company_name (display label) and company_slug (canonical route key).

📈 Visualizations​

Get Timeline​

GET /api/timeline

Returns review volume over time for charting.

Query params:

  • company (optional): company slug or name.

Filtering behavior:

  • The endpoint resolves company slug/name to canonical company_name.
  • Timeline filtering uses exact match (LOWER(company_name) = LOWER(%s)), not broad fuzzy matching.
  • If company cannot be resolved, response is deterministic empty payload: {"timeline": []}.

Get Vacancy Intelligence​

GET /api/corporate/vacancy-intelligence/{company_slug}

Returns hiring velocity, turnover metrics, and ghost job detection.