Investor Plus

REST API

Programmatic access to the same valuation data and engine that powers the calculator. Useful for funds, secondary marketplaces, and platforms integrating private-company comps.

Authentication

Every request must include an Authorization header with your Bearer token. API access is included in the Investor Plus plan. After subscribing, email hello@privatepulse.online with your billing email to receive your personal API token.

Authorization: Bearer pp_demo_xxxxxxxxxxxxxxxxxxxx
GET

List companies

GET/api/v1/companies

Returns the full company dataset, including funding history, peer comparables, secondary indications, headcount, and methodology inputs.

curl https://privatepulse.online/api/v1/companies \
  -H "Authorization: Bearer pp_demo_xxxxxxxxxxxxxxxxxxxx"

Response: 200 OK with { meta, data: Company[] }.

GET

Get a single company

GET/api/v1/companies/{slug}

Slugs match those on the company hub pages. Example slugs: openai, anthropic, spacex, stripe.

curl https://privatepulse.online/api/v1/companies/openai \
  -H "Authorization: Bearer pp_demo_xxxxxxxxxxxxxxxxxxxx"
POST

Run a valuation

POST/api/v1/valuation

Runs the same 4-method valuation engine the calculator uses. Returns the full ValuationResult including scenarios, exercise recommendation, and tax estimate.

Request body:

{
  "company": "openai",
  "shares": 5000,
  "equityType": "ISO",
  "strikePrice": 45,
  "vestingStartDate": "2022-03-01",
  "vestingSchedule": "4yr-1cliff"
}

Example call:

curl -X POST https://privatepulse.online/api/v1/valuation \
  -H "Authorization: Bearer pp_demo_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "company": "openai", "shares": 5000, "equityType": "ISO",
        "strikePrice": 45, "vestingStartDate": "2022-03-01",
        "vestingSchedule": "4yr-1cliff" }'
GET

Bulk CSV export

GET/api/export/companies

Download the full dataset as a CSV with one row per company and 20 columns of metadata. Requires an active Investor Pro or Investor Plus subscription (detected via your browser session). Free users receive a 3-company sample.

curl -O https://privatepulse.online/api/export/companies

Webhooks (coming soon)

Push notifications when:

  • A new primary round is added for a company on your watchlist
  • Secondary prices move >10% from the previous data refresh
  • The overall valuation confidence drops below 40%

We'll deliver a POST request to your configured URL with an HMAC signature in theX-PrivatePulse-Signatureheader. Available on Investor Plus.

Rate limits

1,000 requests per hour per token. Bulk export endpoint counts as 10 requests. Response headers include current usage.

Get an API token →