Zum Hauptinhalt springen

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).

Body:

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

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

📈 Visualizations​

Get Timeline​

GET /api/timeline

Returns review volume over time for charting.

Get Vacancy Intelligence​

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

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