Data API Documentation

RESTful API for accessing anonymized VC reputation data. All endpoints return JSON.

Authentication

All Data API endpoints require a special API key with data_license scope. Include your key in the Authorization header.

bash

curl -H "Authorization: Bearer vcg_data_YOUR_API_KEY" \
  https://vcpeer.com/api/data/v1/health-scores

Getting an API Key

Request access and choose your plan
After approval, you'll receive an API key via email
Your key will have the appropriate data_license_* scope
Manage your key in Settings

Endpoints

GET/api/data/v1/health-scores

Bulk VC peer scores with aggregated review data

Query Parameters

sectorstring (optional)Filter by sector (e.g., 'SaaS', 'Fintech')

stagestring (optional)Filter by stage focus (e.g., 'Seed', 'Series A')

geographystring (optional)Filter by location (Pro+ only)

limitnumber (optional)Results per page (default: 50, max: 500)

offsetnumber (optional)Pagination offset

Example Request

bash

curl -H "Authorization: Bearer vcg_data_YOUR_KEY" \
  "https://vcpeer.com/api/data/v1/health-scores?sector=SaaS&limit=20"

Example Response

json

{
  "data": [
    {
      "vcId": "abc-123",
      "name": "Example Ventures",
      "healthScore": 87,
      "avgOverallRating": 4.3,
      "avgResponsiveness": 4.1,
      "avgTermsFairness": 3.9,
      "avgSupport": 4.5,
      "totalReviews": 42,
      "stageFocus": ["Seed", "Series A"],
      "sectorFocus": ["SaaS", "AI/ML"],
      "investorType": "vc",
      "reviewVolume30d": 3,
      "ghostingRate": 12.5
    }
  ],
  "pagination": {
    "total": 523,
    "limit": 50,
    "offset": 0,
    "hasMore": true
  },
  "meta": {
    "scope": "data_license_pro",
    "generatedAt": "2026-03-25T12:00:00Z"
  }
}

GET/api/data/v1/market-report

Aggregate market overview with trends and top performers

Example Request

bash

curl -H "Authorization: Bearer vcg_data_YOUR_KEY" \
  "https://vcpeer.com/api/data/v1/market-report"

Example Response

json

{
  "data": {
    "totalVcs": 523,
    "totalReviews": 8421,
    "avgHealthScore": 67,
    "medianHealthScore": 65,
    "avgOverallRating": 3.72,
    "bySector": [...],
    "byStage": [...],
    "reviewVolumeTrend": [
      { "period": "2025-Q1", "count": 412 },
      { "period": "2025-Q2", "count": 487 }
    ],
    "topPerformers": [
      { "name": "Top VC", "healthScore": 95, "totalReviews": 89 }
    ]
  }
}

GET/api/data/v1/sector-analysis

Per-sector breakdown of VC health and review data

Query Parameters

sectorstring (optional)Filter to a specific sector

Example Request

bash

curl -H "Authorization: Bearer vcg_data_YOUR_KEY" \
  "https://vcpeer.com/api/data/v1/sector-analysis?sector=Fintech"

Example Response

json

{
  "data": [
    {
      "sector": "SaaS",
      "vcCount": 142,
      "avgHealthScore": 71,
      "avgRating": 3.9,
      "totalReviews": 2341
    }
  ],
  "meta": {
    "totalSectors": 23
  }
}

GET/api/data/v1/benchmarks

Industry benchmarks with percentiles by sector, stage, and investor type

Example Request

bash

curl -H "Authorization: Bearer vcg_data_YOUR_KEY" \
  "https://vcpeer.com/api/data/v1/benchmarks"

Example Response

json

{
  "data": {
    "overall": {
      "avgHealthScore": 67,
      "avgRating": 3.72,
      "avgGhostingRate": 18.3,
      "medianReviewCount": 12,
      "avgResponseRate": 34
    },
    "bySector": [
      {
        "sector": "SaaS",
        "avgHealthScore": 71,
        "avgRating": 3.9,
        "p25HealthScore": 58,
        "p75HealthScore": 82,
        "vcCount": 142
      }
    ],
    "byStage": [...],
    "byInvestorType": [...]
  }
}

Field Descriptions

Field	Type	Description
`healthScore`	integer	Proprietary reputation score from 0-100. Factors in rating, review volume, ghosting rate, and more.
`avgOverallRating`	float	Average rating across all approved reviews (1.0-5.0).
`avgResponsiveness`	float \| null	Average responsiveness sub-rating from founders (1.0-5.0).
`avgTermsFairness`	float \| null	Average terms fairness sub-rating (1.0-5.0).
`avgSupport`	float \| null	Average founder support sub-rating (1.0-5.0).
`totalReviews`	integer	Total number of approved reviews.
`ghostingRate`	float \| null	Percentage of interactions where the VC never responded (0-100).
`reviewVolume30d`	integer	Number of new approved reviews in the last 30 days.
`stageFocus`	string[]	Investment stages the VC focuses on (e.g., Seed, Series A).
`sectorFocus`	string[]	Industry sectors the VC focuses on (e.g., SaaS, Fintech).
`investorType`	string	Type: vc, angel_group, family_office, cvc, accelerator, micro_vc, solo_gp, syndicate.

Rate Limits

Scope	Daily Limit	Max Results/Request
`data_license_basic`	500 requests	100 records
`data_license_pro`	2,000 requests	500 records
`data_license_enterprise`	10,000 requests	5,000 records

Rate limits reset at midnight UTC. When you exceed your limit, the API returns 429 Too Many Requests. The response includes a Retry-After header.

Error Codes

Code	Meaning
`401`	Missing or invalid API key
`403`	API key does not have data_license scope
`429`	Daily rate limit exceeded
`500`	Internal server error