Overview
This endpoint provides insights into trending concepts by analyzing usage patterns, search frequency, clinical adoption, and temporal relevance. It helps identify emerging medical concepts, popular terminology, and shifts in clinical focus.Query Parameters
Time period for trend analysis
Options:
Options:
1d
, 7d
, 30d
, 90d
, 1y
, custom
Start date for custom time period (ISO 8601 format)
Required when:
Required when:
time_period=custom
End date for custom time period (ISO 8601 format)
Required when:
Required when:
time_period=custom
Type of trending analysis
Options:
Options:
usage
, search_frequency
, clinical_adoption
, emerging
, declining
, seasonal
Filter trends to specific vocabularies
String format (CSV):
Array format (repeated params):
Pass multiple values as a comma-separated string or as repeated query parameters; do not use a request body for GET.
String format (CSV):
SNOMED
, ICD10CM,LOINC
, RXNORM
Array format (repeated params):
?vocabulary_ids=ICD10CM&vocabulary_ids=LOINC&vocabulary_ids=RXNORM
Pass multiple values as a comma-separated string or as repeated query parameters; do not use a request body for GET.
Filter trends to specific domains (comma-separated)
Examples:
Examples:
Condition,Procedure
, Drug,Device
Filter trends to specific concept classes (comma-separated)
Focus on specific medical specialties (comma-separated)
Examples:
Examples:
cardiology,oncology
, emergency_medicine
Minimum trend score to include (higher = more trending)
Include detailed usage statistics
Accepted values: true/false (case-insensitive), 1/0, yes/no. Default: false when omitted.
Accepted values: true/false (case-insensitive), 1/0, yes/no. Default: false when omitted.
Include related trending concepts
Accepted values: true/false (case-insensitive), 1/0, yes/no. Default: false when omitted.
Accepted values: true/false (case-insensitive), 1/0, yes/no. Default: false when omitted.
Include trending context and reasons
Accepted values: true/false (case-insensitive), 1/0, yes/no. Default: false when omitted.
Accepted values: true/false (case-insensitive), 1/0, yes/no. Default: false when omitted.
Sort order for results
Options:
Tie-breaker: When primary sort values are equal, secondary sort is by concept_id ascending. Invalid values: Return 400 Bad Request with allowed values listed.
Options:
trend_score
: Composite numeric score (0-10) based on usage, growth, and relevanceusage_count
: Integer count of API requests and searchesgrowth_rate
: Percentage change over analysis periodclinical_relevance
: Mapped from clinical impact levels (low=1, medium=3, high=5, critical=7)
Tie-breaker: When primary sort values are equal, secondary sort is by concept_id ascending. Invalid values: Return 400 Bad Request with allowed values listed.
Sort direction:
asc
or desc
. Default behavior applies descending sort when omitted.Page number for pagination
Number of trending concepts per page (max 100)
Validation: If page_size > 100, the value is clamped to 100. Example:
Validation: If page_size > 100, the value is clamped to 100. Example:
?page_size=150
returns 100 results.Specific vocabulary release version (defaults to latest)
Response
Indicates if the request was successful
Usage Examples
Current Trending Concepts
Get currently trending concepts across all vocabularies:Emerging Concepts
Find newly emerging concepts in specific domains:Specialty-Focused Trends
Get trending concepts for specific medical specialties:Seasonal Analysis
Analyze seasonal trending patterns:Vocabulary-Specific Trends
Focus on trends within specific vocabularies:Custom Time Period Analysis
Analyze trends for a specific date range:Trend Types
Usage
- Based on overall concept usage across the platform
- Includes API requests, searches, and clinical documentation
- Best indicator of general concept popularity
Search Frequency
- Based on search query patterns
- Reflects user interest and information seeking
- Useful for understanding user needs
Clinical Adoption
- Based on usage in clinical settings
- Weighted by healthcare provider usage
- Indicates real-world clinical relevance
Emerging
- Concepts showing rapid growth from low baseline
- Identifies newly relevant medical concepts
- Important for staying current with medical advances
Declining
- Concepts showing significant usage decrease
- May indicate deprecated or obsolete concepts
- Useful for identifying outdated terminology
Seasonal
- Concepts with regular seasonal patterns
- Important for understanding cyclical medical trends
- Helps with resource planning and preparedness
Trend Categories
Emerging (New and Rising)
- Criteria: High growth rate from low baseline
- Characteristics: Recent medical developments, new procedures, emerging diseases
- Examples: New COVID variants, innovative treatments, novel diagnostic methods
Growing (Steadily Increasing)
- Criteria: Consistent upward trend over time
- Characteristics: Increasing clinical adoption, growing awareness
- Examples: Advanced procedures gaining acceptance, expanding disease recognition
Stable Popular (Consistently High)
- Criteria: High usage with stable patterns
- Characteristics: Established medical concepts with ongoing relevance
- Examples: Common conditions, standard procedures, essential medications
Seasonal (Cyclical Patterns)
- Criteria: Regular patterns tied to seasons or events
- Characteristics: Weather-related conditions, infectious diseases, preventive care
- Examples: Influenza, allergies, seasonal vaccinations
Factors Influencing Trends
Clinical Factors
- Disease outbreaks and epidemics
- New treatment protocols and guidelines
- Advances in medical technology
- Changes in diagnostic criteria
Regulatory Factors
- New coding requirements
- Regulatory approvals
- Quality measure updates
- Reimbursement changes
Seasonal Factors
- Weather-related conditions
- Seasonal infectious diseases
- Preventive care cycles
- Academic medical calendars
Technology Factors
- New diagnostic tools
- Treatment innovations
- Digital health adoption
- Medical device advances
Related Endpoints
- Search Concepts - Search for specific concepts
- Get Concept - Detailed concept information
- Suggest Concepts - Concept suggestions
- Get Usage Analytics - Platform usage analytics