Skip to main content
curl -X GET "https://api.omophub.com/v1/search/trending?time_period=7d&trend_type=search_volume&include_statistics=true&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
{
  "success": true,
  "data": {
    "data": [
      {
        "query": "covid-19 symptoms",
        "concept_id": "840539006",
        "concept_name": "Disease caused by severe acute respiratory syndrome coronavirus 2",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "trend_score": 95.8,
        "search_volume": 15420,
        "growth_rate": 234.7,
        "trend_direction": "rising",
        "statistics": {
          "peak_volume": 2180,
          "average_volume": 1850.0,
          "consistency_score": 0.82,
          "seasonal_factor": 1.15,
          "first_seen": "2024-12-15T08:00:00Z",
          "velocity": 12.3
        },
        "related_concepts": [
          {
            "concept_id": "49727002",
            "concept_name": "Cough",
            "correlation_score": 0.78,
            "co_occurrence_rate": 0.45
          },
          {
            "concept_id": "386661006",
            "concept_name": "Fever",
            "correlation_score": 0.72,
            "co_occurrence_rate": 0.41
          }
        ]
      },
      {
        "query": "diabetes management",
        "concept_id": "73211009",
        "concept_name": "Diabetes mellitus",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "trend_score": 87.3,
        "search_volume": 8920,
        "growth_rate": 45.2,
        "trend_direction": "rising",
        "statistics": {
          "peak_volume": 1420,
          "average_volume": 1274.3,
          "consistency_score": 0.91,
          "seasonal_factor": 1.03,
          "first_seen": "2024-12-10T14:30:00Z",
          "velocity": 8.7
        }
      },
      {
        "query": "hypertension treatment",
        "concept_id": "38341003",
        "concept_name": "Hypertensive disorder, systemic arterial",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "trend_score": 79.1,
        "search_volume": 6750,
        "growth_rate": 28.9,
        "trend_direction": "stable"
      }
    ],
    "meta": {
      "pagination": {
        "page": 1,
        "page_size": 10,
        "total_items": 156,
        "total_pages": 16,
        "has_next": true,
        "has_previous": false
      },
      "analysis_period": {
        "start_date": "2024-12-15T00:00:00Z",
        "end_date": "2024-12-22T00:00:00Z",
        "period_type": "7d"
      },
      "data_freshness": "2024-12-22T12:00:00Z",
      "request_id": "req_search_trending_7d_analytics_001",
      "timestamp": "2024-12-22T10:30:00Z",
      "vocab_release": "2025.2"
    }
  }
}
This endpoint provides insights into trending medical concepts and popular search queries, helping users discover relevant terminology based on community usage patterns and temporal trends.

Query Parameters

vocabulary_ids
string
Comma-separated list of vocabulary IDs to filter trending searches
Example: SNOMED,ICD10CM,LOINC
domain_ids
string
Comma-separated list of domain IDs to focus trending analysis
Example: Condition,Drug,Procedure
time_period
string
default:"7d"
Time period for trending analysis
Options: 1d, 7d, 30d, 90d
trend_type
string
default:"search_volume"
Type of trending metric to analyze
Options: search_volume, new_concepts, rising_queries, seasonal_patterns
include_statistics
boolean
default:"false"
Include detailed trending statistics and growth metrics
Include related trending concepts and co-occurrence patterns
page_size
integer
default:"20"
Number of trending items to return (max 100)
page
integer
default:"1"
Page number for pagination (1-based)

Response

data
array
Array of trending search items with analytics data
meta
object
Response metadata and pagination information
curl -X GET "https://api.omophub.com/v1/search/trending?time_period=7d&trend_type=search_volume&include_statistics=true&page_size=10" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
{
  "success": true,
  "data": {
    "data": [
      {
        "query": "covid-19 symptoms",
        "concept_id": "840539006",
        "concept_name": "Disease caused by severe acute respiratory syndrome coronavirus 2",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "trend_score": 95.8,
        "search_volume": 15420,
        "growth_rate": 234.7,
        "trend_direction": "rising",
        "statistics": {
          "peak_volume": 2180,
          "average_volume": 1850.0,
          "consistency_score": 0.82,
          "seasonal_factor": 1.15,
          "first_seen": "2024-12-15T08:00:00Z",
          "velocity": 12.3
        },
        "related_concepts": [
          {
            "concept_id": "49727002",
            "concept_name": "Cough",
            "correlation_score": 0.78,
            "co_occurrence_rate": 0.45
          },
          {
            "concept_id": "386661006",
            "concept_name": "Fever",
            "correlation_score": 0.72,
            "co_occurrence_rate": 0.41
          }
        ]
      },
      {
        "query": "diabetes management",
        "concept_id": "73211009",
        "concept_name": "Diabetes mellitus",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "trend_score": 87.3,
        "search_volume": 8920,
        "growth_rate": 45.2,
        "trend_direction": "rising",
        "statistics": {
          "peak_volume": 1420,
          "average_volume": 1274.3,
          "consistency_score": 0.91,
          "seasonal_factor": 1.03,
          "first_seen": "2024-12-10T14:30:00Z",
          "velocity": 8.7
        }
      },
      {
        "query": "hypertension treatment",
        "concept_id": "38341003",
        "concept_name": "Hypertensive disorder, systemic arterial",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "trend_score": 79.1,
        "search_volume": 6750,
        "growth_rate": 28.9,
        "trend_direction": "stable"
      }
    ],
    "meta": {
      "pagination": {
        "page": 1,
        "page_size": 10,
        "total_items": 156,
        "total_pages": 16,
        "has_next": true,
        "has_previous": false
      },
      "analysis_period": {
        "start_date": "2024-12-15T00:00:00Z",
        "end_date": "2024-12-22T00:00:00Z",
        "period_type": "7d"
      },
      "data_freshness": "2024-12-22T12:00:00Z",
      "request_id": "req_search_trending_7d_analytics_001",
      "timestamp": "2024-12-22T10:30:00Z",
      "vocab_release": "2025.2"
    }
  }
}

Usage Examples

Get the most popular trending searches in the past week:
const trending = await fetch('/v1/search/trending?time_period=7d&page_size=20');
Find trending searches within specific medical domains:
const conditionTrends = await fetch('/v1/search/trending?domain_ids=Condition,Drug&time_period=30d');

Rising Query Detection

Identify rapidly growing search queries:
const risingQueries = await fetch('/v1/search/trending?trend_type=rising_queries&include_statistics=true');

Vocabulary-Specific Analysis

Analyze trends within specific vocabularies:
const snomedTrends = await fetch('/v1/search/trending?vocabulary_ids=SNOMED&time_period=90d&include_related=true');

Seasonal Pattern Analysis

Detect seasonal trending patterns:
const seasonalTrends = await fetch('/v1/search/trending?trend_type=seasonal_patterns&time_period=90d');

Notes

  • Trending data is updated every 4 hours with the latest search analytics
  • Trend scores are normalized across all vocabularies and time periods
  • Geographic data may not be available for all trending items due to privacy considerations
  • Rising queries are identified using proprietary algorithms that account for baseline search volume
  • Seasonal patterns require at least 90 days of historical data for accurate detection
  • Some trending data may be filtered to exclude potentially sensitive health information
I