Name: 🧬Biological Age & Longevity Pathway API
Brand: nicheapi-llc-1
SKU: api-nicheapi-llc-1-longevity
Availability: InStock
Author: API Market

True Scary Stories

# Biological Age & Longevity Pathway API

## Overview
The Biological Age & Longevity Pathway API is a clinical-grade biological age estimation and longevity intervention engine designed for integration into clinic portals, health platforms, insurance workflows, and research pipelines. It ingests multi-modal patient data — standard blood panels, specialized aging biomarkers, continuous glucose monitor (CGM) traces, wearable-derived HRV and sleep architecture metrics, and optional polygenic risk scores — and returns a unified biological aging assessment. The API computes multiple validated biological age clocks, decomposes aging into six clinically actionable pathway scores, and ranks 47 evidence-based longevity interventions by predicted impact. A data completeness score accompanies every analysis, identifying specific missing tests that would improve estimate precision. Batch processing supports up to 50 profiles per request, and cohort comparison is available at enterprise tier.

## Features

*   **Multiple Biological Age Clocks**: Computes three validated clock estimates per profile — a GrimAge-like mortality and physiological age estimate, a DunedinPACE-like pace-of-aging score, and a Composite BioAge that fuses both with organ-specific signals. Each estimate includes chronological age, biological age, delta, aging rate, a 95% confidence interval, and a population percentile ranking.
*   **Six Aging Pathway Scores**: Decomposes biological aging into Inflammaging, Metabolic Dysfunction, Cellular Senescence, Cardiovascular Aging, Neurodegenerative Risk, and Hormonal Decline. Each pathway returns a severity score (0–100), a green/yellow/red flag, and the specific biomarkers driving the result.
*   **47 Ranked Longevity Interventions**: Covers supplements, pharmaceuticals, diet strategies, exercise protocols, sleep optimization, stress management, and environmental modifications. Each intervention includes a priority score, target pathways, predicted biological age reduction in years, evidence level (I–III), dosing guidance, and contraindication warnings.
*   **Data Completeness Scoring**: Every analysis returns a completeness score (0–100%) and a list of specific missing tests that would most improve estimate precision.
*   **Multi-Modal Biomarker Ingestion**: Accepts standard blood panels, specialized aging markers (DNA methylation surrogates, advanced lipid fractions, hormonal axes), CGM metrics (MAGE, TIR, CV), wearable metrics (HRV, sleep architecture, resting heart rate), and genetic variants.
*   **91-Biomarker Reference Catalog**: Full reference library with categories, units, normal ranges, and optimal ranges, accessible via a dedicated GET endpoint.
*   **Cohort Comparison**: Available at enterprise tier — compare a subject's biological age and pathway scores against age- and sex-matched population norms or custom reference populations such as elite agers or same-PRS percentile cohorts.
*   **Batch Processing**: Analyze up to 50 profiles in a single request, with per-batch average bioage delta reporting — suited for cohort studies and workforce wellness programs.
*   **Built-In Test Profiles**: Six sample profiles — Optimal Ager, Metabolic Syndrome, Elite Athlete, Cardiovascular Risk, Inflammaging/Frailty, and Diabetic — available via the test endpoint for development and schema validation.

## Use Cases

The Biological Age & Longevity Pathway API is suited for a range of clinical, commercial, and research workflows:

*   **Longevity Clinics & Functional Medicine Practices**: Embed biological age assessment directly into an existing EMR or patient portal and receive structured, ranked intervention lists without context-switching or manual interpretation.
*   **Health & Wellness Apps**: Deliver deep longevity assessments and pathway scores as a premium feature, without building proprietary aging clocks from scratch.
*   **Insurance Underwriting & Risk Stratification**: Use biological age delta and pathway severity as actuarial signals to flag accelerated agers for detailed risk assessment or targeted wellness program enrollment.
*   **Employee Wellness Programs**: Deploy at scale across workforces, identify high-risk individuals by aging rate, and track population-level biological age delta over time as a measurable program outcome.
*   **Academic & Commercial Research**: Use structured biological age outputs and pathway decomposition as endpoints for observational studies, clinical trial analysis, or longevity intervention discovery. Batch processing supports up to 50 profiles per request.


## API Documentation

### Base URL
All API requests for the Biological Age & Longevity Pathway API should be made to the following base URL:
https://prod.api.market/api/v1/nicheapi-llc-1/longevity/v1/longevity`

### Authentication
Authentication is handled via an API key obtained from RapidAPI. Include your key in the `x-api-market-key` header of every request:

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key from RapidAPI.


### Endpoints

#### 1. Analyze a Profile

Submit a subject's demographics and biomarker data for full biological age estimation, six aging pathway scores, ranked intervention recommendations, and data completeness assessment.

**Method**: `POST`
**Endpoint**: `/longevity/analyze`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `subject_id` | body | Caller-supplied identifier for the subject | `string` | No |
| `chronological_age` | body | Subject's age in years | `integer` | Yes |
| `sex` | body | Subject's biological sex (`"male"` or `"female"`) | `string` | Yes |
| `biomarkers` | body | Object containing blood panel and specialized aging biomarker values (see Biomarker Reference) | `object` | No |
| `cgm_metrics` | body | Continuous glucose monitor metrics: `mean_glucose`, `time_in_range`, `glucose_cv`, `mage` | `object` | No |
| `wearable_metrics` | body | Wearable-derived metrics: `hrv_rmssd_avg`, `sleep_duration_avg`, `deep_sleep_pct`, `rem_sleep_pct`, `resting_hr_avg` | `object` | No |
| `genetic_variants` | body | Optional polygenic risk scores and key variant genotypes (e.g., `apoe`, `foxo3`, `mthfr`) | `object` | No |
| `options.include_interventions` | body | If `true`, returns ranked intervention recommendations in the response | `boolean` | No |
| `options.cohort_comparison` | body | If `true`, includes comparison against age- and sex-matched population norms (enterprise tier) | `boolean` | No |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/longevity/v1/longevity/analyze" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "subject_id": "patient-001",
    "chronological_age": 52,
    "sex": "male",
    "biomarkers": {
      "hs_crp": 1.8,
      "hba1c": 5.4,
      "fasting_insulin": 8.2,
      "hdl": 52,
      "ldl": 128,
      "apob": 85,
      "apoa1": 145,
      "dhea_s": 180,
      "free_testosterone": 8.5,
      "il6": 2.1,
      "tnf_alpha": 3.8
    },
    "cgm_metrics": {
      "mean_glucose": 98,
      "time_in_range": 92,
      "glucose_cv": 18.5,
      "mage": 28
    },
    "wearable_metrics": {
      "hrv_rmssd_avg": 42,
      "sleep_duration_avg": 6.8,
      "deep_sleep_pct": 18,
      "resting_hr_avg": 62
    },
    "options": {
      "include_interventions": true,
      "cohort_comparison": false
    }
  }'
```

**Example Response (200 OK)**:

```json
{
  "request_id": "long-abc123",
  "subject_id": "patient-001",
  "biological_age": {
    "chronological_age": 52,
    "estimated_bioage": 48.3,
    "delta": -3.7,
    "aging_rate": 0.82,
    "confidence_interval": {"lower": 45.1, "upper": 51.5},
    "percentile_ranking": 27,
    "clocks": {
      "grimage_like": 49.1,
      "dunedinpace_like": 0.79,
      "composite_bioage": 48.3
    }
  },
  "aging_pathways": [
    {"pathway_id": "inflammaging", "name": "Inflammaging", "score": 34, "severity": "yellow", "flagged_biomarkers": ["hs_crp", "il6"]},
    {"pathway_id": "metabolic", "name": "Metabolic Dysfunction", "score": 22, "severity": "green", "flagged_biomarkers": []},
    {"pathway_id": "senescence", "name": "Cellular Senescence", "score": 41, "severity": "yellow", "flagged_biomarkers": ["gdf15", "pai1"]},
    {"pathway_id": "cardiovascular", "name": "Cardiovascular Aging", "score": 28, "severity": "green", "flagged_biomarkers": []},
    {"pathway_id": "neurodegenerative", "name": "Neurodegenerative Risk", "score": 19, "severity": "green", "flagged_biomarkers": []},
    {"pathway_id": "hormonal", "name": "Hormonal Decline", "score": 45, "severity": "yellow", "flagged_biomarkers": ["dhea_s", "free_testosterone"]}
  ],
  "interventions": [
    {
      "intervention_id": "int-nmn",
      "name": "NMN Supplementation (250mg/day)",
      "category": "supplement",
      "priority_score": 88,
      "target_pathways": ["metabolic", "senescence"],
      "predicted_bioage_reduction_years": 2.1,
      "evidence_level": "II",
      "estimated_cost_monthly_usd": 45
    },
    {
      "intervention_id": "int-hiit",
      "name": "HIIT (3x/week, 20 min sessions)",
      "category": "exercise",
      "priority_score": 85,
      "target_pathways": ["cardiovascular", "metabolic", "inflammaging"],
      "predicted_bioage_reduction_years": 3.4,
      "evidence_level": "I",
      "estimated_cost_monthly_usd": 0
    }
  ],
  "recommendations": {
    "dominant_pattern": "Mild inflammaging with early cellular senescence markers and hormonal decline.",
    "focus": "Prioritize HIIT, NMN supplementation, and time-restricted feeding to address the three flagged pathway clusters simultaneously.",
    "data_completeness_score": 68,
    "suggested_tests": [
      "Telomere length measurement (qPCR or Flow-FISH)",
      "p16INK4a expression",
      "Morning cortisol:DHEA-S ratio"
    ]
  }
}
```

#### 2. Batch Analyze Profiles

Analyze 1–50 profiles in a single request. Returns all individual results alongside an average bioage delta across the batch.

**Method**: `POST`
**Endpoint**: `/longevity/analyze/batch`

**Request Body**:

| Name | In | Description | Type | Required |
| :--- | :--- | :--- | :--- | :--- |
| `profiles` | body | Array of profile objects, each following the same structure as the `/analyze` request body. Batch limits vary by plan (see Rate Limits). | `array` | Yes |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/longevity/v1/longevity/analyze/batch" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "profiles": [
      {"subject_id": "patient-001", "chronological_age": 52, "sex": "male", "biomarkers": {"hs_crp": 1.8}},
      {"subject_id": "patient-002", "chronological_age": 44, "sex": "female", "biomarkers": {"hs_crp": 3.2}}
    ]
  }'
```

#### 3. Run Test Scenarios

Run analysis across a specified number of built-in sample profiles. Profiles are randomly selected from six archetypes: Optimal Ager, Metabolic Syndrome, Elite Athlete, Cardiovascular Risk, Inflammaging/Frailty, and Diabetic.

**Method**: `POST`
**Endpoint**: `/longevity/test`

**Request Body**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `count` | body | Number of sample profiles to analyze | `integer` | No | `1` | `6` |

**Example Request**:

```bash
curl -X POST "https://prod.api.market/api/v1/nicheapi-llc-1/longevity/v1/longevity/test" \
  -H "x-api-market-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"count": 3}'
```

#### 4. List Biomarkers

Retrieve the full biomarker reference catalog — 91 biomarkers with categories, units, normal ranges, and optimal ranges.

**Method**: `GET`
**Endpoint**: `/longevity/biomarkers`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter biomarkers by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/longevity/v1/longevity/biomarkers?q=inflammation&limit=10" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 5. List Aging Pathways

Retrieve all 6 aging pathways with descriptions, contributing biomarkers, and linked interventions.

**Method**: `GET`
**Endpoint**: `/longevity/pathways`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/longevity/v1/longevity/pathways" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 6. List Interventions

Retrieve the full intervention library — 47 interventions with evidence levels, dosing guidance, estimated monthly costs, and target pathways.

**Method**: `GET`
**Endpoint**: `/longevity/interventions`

**Parameters**:

| Name | In | Description | Type | Required | Default | Max Value |
| :--- | :--- | :--- | :--- | :--- | :--- | :--- |
| `q` | query | Search query to filter interventions by keyword | `string` | No | | |
| `limit` | query | Maximum number of results | `integer` | No | `50` | `1000` |
| `offset` | query | Number of results to skip for pagination | `integer` | No | `0` | |

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/longevity/v1/longevity/interventions?q=supplement&limit=20" \
  -H "x-api-market-key: YOUR_API_KEY"
```

#### 7. Health Check

Check API availability and retrieve live statistics including biomarker, pathway, and intervention counts.

**Method**: `GET`
**Endpoint**: `/longevity/health`

**Example Request**:

```bash
curl -X GET "https://prod.api.market/api/v1/nicheapi-llc-1/longevity/v1/longevity/health" \
  -H "x-api-market-key: YOUR_API_KEY"
```


## Status Codes
Below is a list of common HTTP status codes you may encounter when interacting with the Biological Age & Longevity Pathway API:

*   **`200 OK`**: The request was successful and the server has returned the requested data.
*   **`400 Bad Request`**: The server could not process the request due to invalid input — such as a missing `chronological_age` or `sex` field, an unrecognized biomarker key, or a batch array exceeding your plan's profile limit. Review your request body before retrying.
*   **`401 Unauthorized`**: Authentication failed. Your `x-api-market-key` header is missing or contains an invalid key. Confirm your key is active and correctly included in the request header.
*   **`403 Forbidden`**: Your API key is valid, but the requested feature — such as cohort comparison or a batch size above your plan's limit — is not available on your current tier. Review your plan's permissions on RapidAPI.
*   **`404 Not Found`**: The requested endpoint does not exist. Verify the URL path against the endpoint reference above.
*   **`429 Too Many Requests`**: You have exceeded your plan's rate limit. Implement client-side rate limiting and exponential backoff. Check the `Retry-After` response header for guidance on when to retry.
*   **`500 Internal Server Error`**: An unexpected server-side error occurred. Retry the request after a short delay.
*   **`503 Service Unavailable`**: The server is temporarily unavailable due to maintenance or elevated load. Retry after a short delay.

## Rate Limits

Rate limits and batch sizes vary by plan:

| Plan | Price | Requests/Month | Batch Limit | Rate Limit |
| :--- | :--- | :--- | :--- | :--- |
| **Free** | $0 | 100 | 1 profile/request | 10 req/min |
| **Pro** | $99/mo | 10,000 | 10 profiles/batch | 60 req/min |
| **Ultra** | $499/mo | 100,000 | 50 profiles/batch | 300 req/min |
| **Mega** | $1,999/mo | 1,000,000 | 200 profiles/batch | 1,000 req/min |

All tiers include full access to all endpoints and clock algorithms. Overage rates apply beyond monthly request limits: $0.005/request (Free), $0.003/request (Pro), $0.001/request (Ultra), and custom negotiated rates (Mega).

If you exceed your plan's rate limit, the API returns a `429 Too Many Requests` status code. Implement exponential backoff in your client and monitor the `Retry-After` header for retry timing guidance.

## Security & Compliance

*   All requests are encrypted via TLS 1.3.
*   No biometric or genetic data is stored beyond the request-response window. Zero-retention mode is available at Ultra tier and above.
*   SOC 2 Type II certified infrastructure.
*   HIPAA BAA available for covered entities at Mega tier.
*   GDPR-compliant data processing.

## FAQ

*   **What is the minimum required input for the analyze endpoint?**
    Only `chronological_age` and `sex` are required. All biomarker, CGM, wearable, and genetic fields are optional. The data completeness score in the response will indicate how much of the ideal panel was covered and which additional tests would most improve estimate precision.

*   **What do the three biological age clocks measure?**
    The GrimAge-like clock estimates mortality risk and physiological age using surrogate markers for DNA methylation sites. The DunedinPACE-like clock measures the rate of biological aging per chronological year. The Composite BioAge fuses both with organ-specific signals into a single ensemble estimate.

*   **What does a negative delta mean?**
    A negative delta (e.g., −3.7) means the subject's estimated biological age is lower than their chronological age — they are aging more slowly than their peers. A positive delta indicates accelerated aging.

*   **What is the data completeness score?**
    Every response includes a completeness score (0–100%) representing how much of the ideal 91-biomarker panel was submitted. The response also lists specific suggested tests that would most improve estimate precision for that subject.

*   **Is cohort comparison available on all plans?**
    Cohort comparison (`options.cohort_comparison: true`) is an enterprise feature available at Mega tier. It compares the subject's scores against age- and sex-matched population norms or custom reference populations.

*   **How many profiles can I batch analyze at once?**
    Batch limits vary by plan: 1 profile per request (Free), 10 (Pro), 50 (Ultra), and 200 (Mega).

*   **Can I test the API without real patient data?**
    Yes. The `/longevity/test` endpoint runs analysis across up to 6 built-in sample profiles with no biomarker input required. Use this to explore the full response schema and validate your parsing logic before connecting a live data source.

*   **How do I authenticate my requests?**
    All requests require an `x-api-market-key` header with your API key obtained from RapidAPI.

## Contact Us

For questions or support, reach the team through the RapidAPI support channel associated with your plan, or via the community Slack available to all subscribers.