# EnsemblAI — full API surface

REST base: https://api.ensemblai.com  ·  Auth: Authorization: Bearer ek_live_...
Keys are issued to Pro-plan accounts at https://www.ensemblai.com/settings/api-keys
Machine schema: https://api.ensemblai.com/openapi.json
MCP server (same data, tool-shaped): https://mcp.ensemblai.com/mcp — see
https://www.ensemblai.com/docs/agents

Endpoints (generated from the live OpenAPI schema):

GET    /  — API root
GET    /v1/analytics/geography  — Geography breakdown
GET    /v1/analytics/growth  — Growth analytics
GET    /v1/analytics/time-series  — Analytics time series
GET    /v1/analytics/version-adoption  — Version adoption analysis
GET    /v1/companies  — List companies
GET    /v1/companies/{company_name}/packages  — Company packages
GET    /v1/companies/{company_name}/stats  — Company statistics
POST   /v1/customer/alerts  — Create alert rule
GET    /v1/customer/alerts  — List alert rules
DELETE /v1/customer/alerts/{rule_id}  — Delete alert rule
POST   /v1/customer/api-keys  — Issue new API key
GET    /v1/customer/api-keys  — List own API keys
DELETE /v1/customer/api-keys/{api_key_id}  — Revoke API key
GET    /v1/customer/audit  — List audit log entries
POST   /v1/customer/audit-deps  — Audit dependency health + vulnerabilities
GET    /v1/customer/audit-deps/{vuln_id}  — Get OSV vulnerability detail
GET    /v1/customer/notifications  — List notifications
GET    /v1/ecosystem  — Ecosystem map by canonical domain
GET    /v1/ecosystem/clusters  — Louvain ecosystem clusters
POST   /v1/ensembles  — Create ensemble
GET    /v1/ensembles  — List ensembles
DELETE /v1/ensembles/{ensemble_id}  — Delete ensemble
GET    /v1/ensembles/{ensemble_id}  — Get ensemble
PUT    /v1/ensembles/{ensemble_id}  — Update ensemble
GET    /v1/ensembles/{ensemble_id}/analytics  — Ensemble analytics
POST   /v1/exports/packages  — Export packages
GET    /v1/filters/values  — Get filter values with counts
GET    /v1/health  — Health check
GET    /v1/leaderboards/downloads  — Download leaderboard
GET    /v1/me  — Current key + tier introspection
GET    /v1/organizations  — List GitHub organizations
GET    /v1/organizations/{github_org}/packages  — Get organization packages
GET    /v1/packages  — Search packages
GET    /v1/packages/{package_name}  — Get package details
GET    /v1/packages/{package_name}/cohort  — Per-version monthly downloads (cohort heatmap)
GET    /v1/packages/{package_name}/dependencies  — Get package dependencies
GET    /v1/packages/{package_name}/depgraph  — First/second-degree dependency graph
GET    /v1/packages/{package_name}/health  — Package health scores
GET    /v1/packages/{package_name}/metrics  — Package metrics
GET    /v1/packages/{package_name}/versions  — List package versions
GET    /v1/packages/{package_name}/versions/{version}/metrics  — Version metrics time series
POST   /v1/packages/batch  — Batch package lookup
GET    /v1/packages/suggest  — Typeahead package suggestions
GET    /v1/reference/categories  — List technology categories
GET    /v1/reference/countries  — List countries
GET    /v1/reference/domains  — List industry domains
GET    /v1/reference/languages  — List primary languages
GET    /v1/reference/licenses  — List licenses
GET    /v1/reference/owners  — List corporate owners
POST   /v1/saved-searches  — Create saved search
GET    /v1/saved-searches  — List saved searches
DELETE /v1/saved-searches/{search_id}  — Delete saved search
GET    /v1/saved-searches/{search_id}  — Get saved search
PUT    /v1/saved-searches/{search_id}  — Update saved search
GET    /v1/saved-searches/{search_id}/execute  — Execute saved search
GET    /v1/status  — System status
POST   /v1/watchlist  — Add to watchlist
GET    /v1/watchlist  — Get watchlist
DELETE /v1/watchlist/{package_name}  — Remove from watchlist