Skip to main content
curl -X GET "https://api.omophub.com/v1/concepts/trending?period=week&vocabulary_ids=SNOMED,ICD10CM&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "period": "week",
    "concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "vocabulary_id": "SNOMED",
        "search_count": 1547,
        "growth_rate": 23.5,
        "trend_score": 7.8
      },
      {
        "concept_id": 320128,
        "concept_name": "Essential hypertension",
        "vocabulary_id": "SNOMED",
        "search_count": 1234,
        "growth_rate": 18.2,
        "trend_score": 6.9
      },
      {
        "concept_id": 4329847,
        "concept_name": "Myocardial infarction",
        "vocabulary_id": "SNOMED",
        "search_count": 987,
        "growth_rate": 15.7,
        "trend_score": 5.4
      }
    ],
    "total_concepts": 156,
    "limit": 20
  },
  "meta": {
    "request_id": "req_trending_abc123",
    "timestamp": "2024-01-15T10:30:00Z",
    "vocab_release": "2025.2"
  }
}

​
Overview

This endpoint provides insights into trending concepts by analyzing search frequency and usage patterns. It identifies concepts that are seeing increased activity over different time periods.

​
Query Parameters

​
period
string
default:"week"
Time period for trend analysis
Options: day, week, month
​
vocabulary_ids
string
Filter trends to specific vocabularies (comma-separated)
Examples: SNOMED, SNOMED,ICD10CM, RXNORM,LOINC
​
page_size
integer
default:"20"
Maximum number of trending concepts to return (1-1000)
​
vocab_release
string
Specific vocabulary release version (defaults to latest)

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
​
meta
object
curl -X GET "https://api.omophub.com/v1/concepts/trending?period=week&vocabulary_ids=SNOMED,ICD10CM&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "success": true,
  "data": {
    "period": "week",
    "concepts": [
      {
        "concept_id": 201826,
        "concept_name": "Type 2 diabetes mellitus",
        "vocabulary_id": "SNOMED",
        "search_count": 1547,
        "growth_rate": 23.5,
        "trend_score": 7.8
      },
      {
        "concept_id": 320128,
        "concept_name": "Essential hypertension",
        "vocabulary_id": "SNOMED",
        "search_count": 1234,
        "growth_rate": 18.2,
        "trend_score": 6.9
      },
      {
        "concept_id": 4329847,
        "concept_name": "Myocardial infarction",
        "vocabulary_id": "SNOMED",
        "search_count": 987,
        "growth_rate": 15.7,
        "trend_score": 5.4
      }
    ],
    "total_concepts": 156,
    "limit": 20
  },
  "meta": {
    "request_id": "req_trending_abc123",
    "timestamp": "2024-01-15T10:30:00Z",
    "vocab_release": "2025.2"
  }
}

​
Usage Examples

Get trending concepts from the past week: 
curl -X GET "https://api.omophub.com/v1/concepts/trending?period=week&page_size=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
Focus on trends within specific vocabularies: 
curl -X GET "https://api.omophub.com/v1/concepts/trending?vocabulary_ids=SNOMED&period=month" \
  -H "Authorization: Bearer YOUR_API_KEY"
Get the most recent daily trends: 
curl -X GET "https://api.omophub.com/v1/concepts/trending?period=day&page_size=100" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Trend Score Calculation

The trend_score is a composite metric calculated from:
  • Search volume (60% weight): Number of searches for the concept in the current period
  • Growth rate (40% weight): Percentage change compared to the previous period of equal length
Higher scores indicate concepts with both high search volume and significant growth.