---
title: "Get trending biomarkers"
method: GET
path: "/api/v1/biomarkers/trending"
tags: ["Biomarkers"]
---

# Get trending biomarkers

`GET /api/v1/biomarkers/trending`

## Request

- Base URL: `https://www.vitalsvault.com`
- URL: `https://www.vitalsvault.com/api/v1/biomarkers/trending`
- Auth: none declared

Get biomarkers with highest trending scores based on views and searches

## Query parameters

- `limit` integer
- `timeframe` 'day' | 'week' | 'month'

## Response `200`

Successfully retrieved trending biomarkers

- object
  - `success` boolean, required: Indicates if the request was successful
  - `data` object[]: Response data (only present if success is true)
    - `id` string, uuid, required
    - `slug` string, required
    - `name` string, required
    - `categoryId` string, uuid
    - `categorySlug` string, required
    - `applicableGender` 'male' | 'female' | 'both'
    - `summary` string: Brief summary of the biomarker
    - `significance` string: Medical significance of the biomarker
    - `symptoms` string[]
    - `causes` string[]
    - `metaDescription` string: SEO meta description
    - `keyInsights` string[]
    - `loincCode` string
    - `loincName` string
    - `unit` string
    - `hasContent` boolean
    - `junctionMarkerId` string: Junction Health marker ID for lab integration
    - `includedInPackages` string[]
    - `seoVariations` string[]: Alternative search terms
    - `medicalReviewStatus` 'pending' | 'reviewed' | 'approved'
    - `lastMedicalReview` string, date-time
    - `viewCount` integer
    - `searchVolume` integer
    - `trendingScore` number, float
    - `lastUpdated` string, date-time
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `trendingRank` integer: Ranking position
    - `trendingChange` 'up' | 'down' | 'stable': Trend direction
  - `error` object
    - `code` string, required: Error code for programmatic handling
    - `message` string, required: Human-readable error message
    - `details` string: Additional error details
  - `meta` object
    - `queryTime` integer: Query execution time in milliseconds
    - `cached` boolean: Whether the response was served from cache

## Other responses

- `500`: Internal server error

---

[API](https://skmtc.dev/vitalsvault/apis/vitals-vault-educational-api.md) · [All operations](https://skmtc.dev/vitalsvault/apis/vitals-vault-educational-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vitalsvault/apis/vitals-vault-educational-api/revisions/957d19299c33?raw)