Analytics API

Comprehensive analytics and aggregations across companies, people, investors, and funding data.

Get Analytics

GET/api/v1/analytics

Retrieve analytics data with flexible metrics, time filtering, and grouping options.

Query Parameters

Parameter	Type	Description	Options
metric	string	Type of analytics to retrieve	overview, companies, people, investors, funding, trends
timeframe	string	Time period for data	all, year, quarter, month
group_by	string	Group results by dimension	industry, location, year, status, round
filter_by	string	Filter dimension	industry, status, location
filter_value	string	Filter value	ai, active, san francisco

Overview Analytics

Get high-level platform statistics across all entities.

Example Request

cURL

curl -X GET "https://mentibus.xyz/api/v1/analytics?metric=overview" \
  -H "Authorization: Bearer mk_your_api_key_here"

Example Response

200 OK

{
  "success": true,
  "data": {
    "overview": {
      "total_companies": 15847,
      "total_people": 89234,
      "total_vc_firms": 3421,
      "total_investments": 12456,
      "total_investment_amount": "245000000000.00"
    },
    "metadata": {
      "metric": "overview",
      "timeframe": "all",
      "generated_at": "2024-01-15T10:30:00Z"
    }
  },
  "message": "Analytics data for overview metric"
}

Company Analytics

Analyze company data with grouping and filtering options.

Example: Companies by Industry

cURL

curl -X GET "https://mentibus.xyz/api/v1/analytics?metric=companies&group_by=industry" \
  -H "Authorization: Bearer mk_your_api_key_here"

Example Response

200 OK

{
  "success": true,
  "data": {
    "companies_by_industry": [
      {
        "industry": "Artificial Intelligence",
        "count": 2847,
        "avg_employees": 45.2,
        "avg_funding": "12500000.00"
      },
      {
        "industry": "Fintech",
        "count": 1923,
        "avg_employees": 67.8,
        "avg_funding": "18700000.00"
      },
      {
        "industry": "Healthcare",
        "count": 1456,
        "avg_employees": 89.3,
        "avg_funding": "25400000.00"
      }
    ]
  }
}

Funding Analytics

Analyze investment and funding patterns across different dimensions.

Example: Funding by Round Type

cURL

curl -X GET "https://mentibus.xyz/api/v1/analytics?metric=funding&group_by=round&timeframe=year" \
  -H "Authorization: Bearer mk_your_api_key_here"

Example Response

200 OK

{
  "success": true,
  "data": {
    "funding_by_round": [
      {
        "round_type": "Series A",
        "count": 1247,
        "total_amount": "15600000000.00",
        "avg_amount": "12500000.00",
        "max_amount": "100000000.00"
      },
      {
        "round_type": "Seed",
        "count": 2834,
        "total_amount": "8500000000.00",
        "avg_amount": "3000000.00",
        "max_amount": "25000000.00"
      },
      {
        "round_type": "Series B",
        "count": 567,
        "total_amount": "22400000000.00",
        "avg_amount": "39500000.00",
        "max_amount": "250000000.00"
      }
    ]
  }
}

Trends Analytics

Track growth trends and activity patterns over the last 12 months.

Example Request

cURL

curl -X GET "https://mentibus.xyz/api/v1/analytics?metric=trends" \
  -H "Authorization: Bearer mk_your_api_key_here"

Example Response

200 OK

{
  "success": true,
  "data": {
    "trends": {
      "company_creation": [
        {
          "month": "2024-01",
          "companies_created": 234
        },
        {
          "month": "2024-02",
          "companies_created": 287
        }
      ],
      "funding_activity": [
        {
          "month": "2024-01",
          "rounds_count": 45,
          "total_amount": "850000000.00"
        },
        {
          "month": "2024-02",
          "rounds_count": 52,
          "total_amount": "1200000000.00"
        }
      ]
    }
  }
}

Available Metrics

overview

Platform-wide statistics

Total counts across all entities

companies

Company analytics

Group by: industry, year, location

people

People analytics

Group by: location, type

investors

VC firm analytics

Group by: location, year

funding

Investment analytics

Group by: round, year

trends

12-month trends

Monthly activity patterns