Eternal Search API v1

Verified grants, events, leads, research jobs, investors, and CRM workflows.

Base URL: https://eternalsearch.net/api/v1

OpenAPI 3.1 spec (machine-readable, start here for agents/tools): /api/v1/openapi (also at /openapi.json)

Docs as JSON: /api/v1/docs?format=json

AI-agent site map: /llms.txt

MCP server (add as a connector in Claude / ChatGPT / Cursor, no auth): https://eternalsearch.net/api/mcp

Top-tier docs (Deep Intelligence + Ideas Graph): /api/v1/docs/intelligence

Authentication

Authorization: Bearer es_your_api_key_here

Public endpoints work without a key. Full and top-tier endpoints require a valid bearer token.

External Access

/api/v1 and /api/public send CORS headers and answer browser preflight requests. Configure allowed origins with API_ALLOWED_ORIGINS as * or a comma-separated allowlist.

Response Shapes

Core Endpoints

PathAccessNotes
GET /grantspublicVerified grants with label filters and pagination.
GET /eventspublicVerified events with pagination.
GET /searchpublicUnified event + grant search; full/top keys also receive leads.
GET /statspublicDatabase summary statistics.
GET /ratings/companiespublicRated longevity companies. Full/top keys get ALL published companies + status flags.
GET /ratings/companies/{publicId}publicCompany detail: scores, theories, publications. Full/top keys also get the full evidence dossier.
GET /ratings/preservationpublicRated preservation companies (cryonics, brain preservation, biobanking…). Full/top keys get every scored company.
GET /ratings/preservation/{publicId}publicPreservation detail. Full/top keys get all dimensions + full evidence dossier.
GET /ratings/fundspublicRated funds with review counts and dimension means.
GET /ratings/projectspublicRated projects across all sections.
GET /ratings/projects/{publicId}publicProject detail with full per-dim scores, rationale, evidence (full-transparency exception).
GET /theoriespublicScientific theories with Popperian scores and connection counts.
GET /theories/clusterspublicTheory clusters — the theory-to-theory backbone.
GET /theories/{id}publicTheory detail: owner, scores, clusters, related theories, endorsements, alignment, projects, reasoning tree.
GET /heroespublicRated longevity heroes with overall + dim scores.
GET /heroes/{publicId}publicHero detail with bio, scores, investments, donations, beliefs.
GET /organizationsfullFunders and partner organizations.
GET /leadsfullLead list with team-safe filtering.
GET /investorsfullInvestor array with entities and linked leads.
GET /contactsfullAggregated contacts across leads.
GET, POST /researchfullList jobs or create parallel grants/events jobs.
GET /crmfullCRM discovery index and permission summary.
GET /ideastopCanonical-ideas tree + matched companies/people/investors/projects/publications + connections.
GET /intelligence/*topDeep-intelligence investor/event endpoints.

Example

curl "https://eternalsearch.net/api/v1/search?q=longevity" \
  -H "Authorization: Bearer es_your_key"

Research Job Example

{
  "grants_job": { "id": "uuid", "status": "pending", "job_type": "grants" },
  "events_job": { "id": "uuid", "status": "pending", "job_type": "events" }
}