Skip to main content

Analytics API

Overview​

Internal API endpoints used by the Vartovii Dashboard to display charts, stats, and market insights. Base path: /api/

📊 Dashboard Stats​

Get Global Stats​

GET /api/stats

Returns high-level platform metrics.

Parameters:

  • company: (Optional) Filter by company.
  • region: (Optional) Filter by region (de, at, ch).

Get Company List​

GET /api/companies

Returns a list of all companies with available data.

📈 Analysis & Visualization​

Sentiment Distribution​

GET /api/sentiment-distribution

Returns breakdown of Positive/Neutral/Negative reviews.

Rating Distribution​

GET /api/rating-distribution

Returns breakdown of star ratings (1-5).

Review Topics (Aspects)​

GET /api/aspects

Returns top discussed topics (e.g., "Management", "Salary") with sentiment analysis.

Reviews List​

GET /api/reviews

Fetches raw reviews with pagination and filtering.

Parameters:

  • company: Company name.
  • source: Filter by source (kununu, google, glassdoor, reddit).
  • limit: Max results (default 100).

💼 Market Pulse​

Vacancy Intelligence​

GET /api/vacancies

Returns job vacancy data and turnover metrics.

Market Pulse Report​

GET /api/market-pulse

Comprehensive market analysis combining vacancies, hiring velocity, and sentiment trends.

🧠 AI Triggers​

Trigger Company Analysis​

POST /api/analyze/{company_slug}

Manually triggers the Deep AI Analysis process for a specific company. Note: This is a heavy operation taking 30-60 seconds.