Skip to content
VentureIndex
PreviewAPI version 2026-10-01

VentureIndex API

Read companies, profiles and rankings as JSON. The API returns exactly what the website shows to a signed-out visitor: the same privacy projection, the same provenance labels and the same rounding.

Authentication
None during preview
Rate limit
60 requests / minute / IP
Format
JSON, CORS enabled

Basics

Base URL: https://ventureindex.io/api/v1. Every response is wrapped as { "apiVersion": "2026-10-01", "data": … }, and errors as { "apiVersion": …, "error": { "code", "message" } } with a matching HTTP status.

Responses are cacheable for 60 seconds (Cache-Control: public, max-age=60, s-maxage=300). Exceeding the rate limit returns 429 with a Retry-After header.

Privacy

Founders choose, per metric group, whether a value is public, shown as a range, visible only to approved buyers, or private. The API enforces the same rules server-side: a hidden metric is null, a range metric comes back as mrrRange with mrrUsd: null, and filters or sorts never match on values a company keeps private. See the privacy model.

Companies

GET/api/v1/companies

Search and filter companies. Accepts the same parameters as the Explore page, so any Explore URL maps directly onto the API.

curl "https://ventureindex.io/api/v1/companies?cat=saas&mrr_min=10000&growth_min=10&sort=growth"
ParameterMeaning
qFull-text search over name, tagline and description
catCategory slugs, comma-separated (e.g. ai,saas)
countryISO 3166 alpha-2 codes, comma-separated
techTechnology slugs, comma-separated
mrr_min, mrr_maxMRR in USD
arr_min, arr_maxARR in USD
rev_min, rev_maxRevenue in the last 30 days, USD
growth_min, growth_max30-day revenue growth in percent (10 = 10%)
momentum_min, score_minMinimum Momentum / VentureIndex Score (0–100)
team_min, team_maxTeam size
age_min, age_maxCompany age in months
traffic_minMinimum visits in the last 30 days
profitable, sale1 to require profitable / open to acquisition
model, audience, funding, verifiedEnumerations, comma-separated (same values as Explore)
sortscore, momentum, mrr, revenue, growth, traffic, efficiency, newest, verified
page1-based page number, 50 companies per page

Returns { page, pageCount, total, companies: [...] }.

GET/api/v1/companies/{slug}

The full public profile: identity, metrics with provenance and freshness, monthly series that are public, score breakdown, verification and timeline.

curl "https://ventureindex.io/api/v1/companies/{slug}"

Rankings

GET/api/v1/rankings/{slug}

Any ranking on the site, including category, country, revenue-cohort and combined slugs (for example fastest-growing-bootstrapped-saas). Each entry has position, previousPosition, the ranked value and the company.

curl "https://ventureindex.io/api/v1/rankings/trending"

Predefined slugs: top, fastest-growing, trending, highest-mrr, highest-revenue, most-profitable, most-efficient, top-bootstrapped, top-solo-founders, newly-verified, biggest-movers.

Company fields

mrrUsdExact MRR in USD, or null when the company shows a range or keeps it private
mrrRange[low, high] when the company publishes a range instead (high is null for open-ended)
revenue30dUsd, revenueRangeRevenue over the last 30 days, same rules
growth30d, growth3m, growthYoyRevenue growth as a decimal (0.12 = +12%), null when private
viScore, viConfidenceVentureIndex Score (0–100, rounded) and its confidence
momentumScoreMomentum Score (0–100, rounded)
revenueProvenance, revenueSourceverified, connected, company_reported, estimated or public_source, and the provider
verifiedKindsWhat has been verified: revenue, domain, ownership…
isDemotrue for fictional demo companies (demo deployments only list them)

Coming next

Scoped API keys with higher limits and usage reporting, webhooks for ranking and milestone changes, and bulk datasets. Until then the preview is anonymous and rate-limited per IP.