---
title: "Search biomarkers"
method: GET
path: "/api/v1/biomarkers/search"
tags: ["Biomarkers"]
---

# Search biomarkers

`GET /api/v1/biomarkers/search`

## Request

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

Full-text search across biomarker names, summaries, and significance

## Query parameters

- `q` string, required
- `category` string
- `gender` 'male' | 'female'
- `limit` integer

## Response `200`

Successfully searched biomarkers

- object
  - `success` boolean, required: Indicates if the request was successful
  - `data` object: Response data (only present if success is true)
    - `results` object[]
      - `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
      - `relevanceScore` number, float: Search relevance score
    - `query` string
    - `totalResults` integer
    - `searchTime` integer: Search execution time in ms
  - `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

- `400`: Bad request
- `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)