curl -X GET "https://api.omophub.com/v1/concepts/trending?time_period=30d&trend_type=usage&vocabulary_ids=SNOMED,ICD10CM&include_statistics=true&include_context=true" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "trend_analysis": {
      "time_period": "30d",
      "analysis_date": "2024-01-15T10:30:00Z",
      "total_concepts_analyzed": 2547832,
      "trending_concepts_found": 156,
      "average_trend_score": 3.7,
      "trend_categories": {
        "emerging": 23,
        "growing": 67,
        "stable_popular": 45,
        "seasonal": 21
      }
    },
    "trending_concepts": [
      {
        "concept_id": 1240541000000107,
        "concept_name": "COVID-19 Omicron variant BA.5 infection",
        "concept_code": "1240541000000107",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "trend_score": 8.9,
        "trend_category": "emerging",
        "growth_rate": 245.7,
        "ranking": 1,
        "ranking_change": 127,
        "usage_statistics": {
          "current_usage_count": 15847,
          "previous_usage_count": 4589,
          "search_frequency": 2847,
          "api_requests": 12459,
          "unique_users": 1247,
          "geographic_distribution": [
            {"region": "North America", "percentage": 42.3},
            {"region": "Europe", "percentage": 28.9},
            {"region": "Asia Pacific", "percentage": 21.4},
            {"region": "Others", "percentage": 7.4}
          ],
          "specialty_usage": [
            {"specialty": "infectious_disease", "percentage": 34.2},
            {"specialty": "emergency_medicine", "percentage": 28.7},
            {"specialty": "internal_medicine", "percentage": 23.1},
            {"specialty": "pulmonology", "percentage": 14.0}
          ]
        },
        "trending_context": {
          "primary_factors": [
            "Recent COVID-19 variant emergence",
            "Increased clinical documentation",
            "Public health reporting requirements",
            "Research publication surge"
          ],
          "clinical_relevance": "High - new variant requiring specific coding",
          "news_mentions": 1247,
          "seasonal_factor": false,
          "outbreak_related": true,
          "regulatory_impact": true,
          "technology_adoption": false
        },
        "related_trending_concepts": [
          {
            "concept_id": 840539006,
            "concept_name": "Disease caused by severe acute respiratory syndrome coronavirus 2",
            "relationship_type": "Is a",
            "trend_score": 6.4
          },
          {
            "concept_id": 1240521000000100,
            "concept_name": "COVID-19 vaccination",
            "relationship_type": "Clinical context",
            "trend_score": 5.8
          }
        ],
        "temporal_pattern": {
          "peak_days": ["Monday", "Tuesday", "Friday"],
          "peak_hours": [9, 10, 14, 15],
          "seasonal_pattern": null,
          "trend_trajectory": "Stabilizing"
        }
      },
      {
        "concept_id": 429914006,
        "concept_name": "Hybrid cardiac catheterization procedure",
        "concept_code": "429914006",
        "vocabulary_id": "SNOMED",
        "domain_id": "Procedure",
        "concept_class_id": "Procedure",
        "trend_score": 7.2,
        "trend_category": "growing",
        "growth_rate": 156.3,
        "ranking": 2,
        "ranking_change": 15,
        "usage_statistics": {
          "current_usage_count": 8934,
          "previous_usage_count": 3467,
          "search_frequency": 1456,
          "api_requests": 7234,
          "unique_users": 567,
          "geographic_distribution": [
            {"region": "North America", "percentage": 58.2},
            {"region": "Europe", "percentage": 31.4},
            {"region": "Asia Pacific", "percentage": 8.1},
            {"region": "Others", "percentage": 2.3}
          ],
          "specialty_usage": [
            {"specialty": "cardiology", "percentage": 67.8},
            {"specialty": "cardiac_surgery", "percentage": 28.9},
            {"specialty": "interventional_radiology", "percentage": 3.3}
          ]
        },
        "trending_context": {
          "primary_factors": [
            "Advancement in cardiac intervention techniques",
            "Increased adoption in major medical centers",
            "Positive clinical outcomes reporting",
            "Medical device technology improvements"
          ],
          "clinical_relevance": "High - innovative cardiac intervention",
          "news_mentions": 234,
          "seasonal_factor": false,
          "outbreak_related": false,
          "regulatory_impact": false,
          "technology_adoption": true
        },
        "related_trending_concepts": [
          {
            "concept_id": 41976001,
            "concept_name": "Cardiac catheterization",
            "relationship_type": "Is a",
            "trend_score": 4.2
          },
          {
            "concept_id": 232717009,
            "concept_name": "Coronary artery disease",
            "relationship_type": "Treats",
            "trend_score": 3.8
          }
        ],
        "temporal_pattern": {
          "peak_days": ["Tuesday", "Wednesday", "Thursday"],
          "peak_hours": [8, 9, 10, 13, 14],
          "seasonal_pattern": null,
          "trend_trajectory": "Growing"
        }
      },
      {
        "concept_id": 6142004,
        "concept_name": "Influenza",
        "concept_code": "6142004",
        "vocabulary_id": "SNOMED",
        "domain_id": "Condition",
        "concept_class_id": "Clinical Finding",
        "trend_score": 5.4,
        "trend_category": "seasonal",
        "growth_rate": 89.2,
        "ranking": 3,
        "ranking_change": -5,
        "usage_statistics": {
          "current_usage_count": 23456,
          "previous_usage_count": 12389,
          "search_frequency": 3456,
          "api_requests": 18234,
          "unique_users": 2156,
          "geographic_distribution": [
            {"region": "North America", "percentage": 45.6},
            {"region": "Europe", "percentage": 31.2},
            {"region": "Asia Pacific", "percentage": 18.7},
            {"region": "Others", "percentage": 4.5}
          ],
          "specialty_usage": [
            {"specialty": "family_medicine", "percentage": 42.1},
            {"specialty": "internal_medicine", "percentage": 28.7},
            {"specialty": "emergency_medicine", "percentage": 18.9},
            {"specialty": "pediatrics", "percentage": 10.3}
          ]
        },
        "trending_context": {
          "primary_factors": [
            "Seasonal influenza outbreak",
            "Increased clinical visits",
            "Public health surveillance",
            "Vaccination campaign timing"
          ],
          "clinical_relevance": "High - seasonal disease pattern",
          "news_mentions": 567,
          "seasonal_factor": true,
          "outbreak_related": true,
          "regulatory_impact": false,
          "technology_adoption": false
        },
        "related_trending_concepts": [
          {
            "concept_id": 836500008,
            "concept_name": "Influenza vaccination",
            "relationship_type": "Prevented by",
            "trend_score": 4.9
          },
          {
            "concept_id": 195967001,
            "concept_name": "Asthma",
            "relationship_type": "Risk factor for",
            "trend_score": 3.2
          }
        ],
        "temporal_pattern": {
          "peak_days": ["Monday", "Tuesday", "Friday"],
          "peak_hours": [8, 9, 10, 11, 13, 14],
          "seasonal_pattern": "Winter peak (December-February)",
          "trend_trajectory": "Seasonal decline expected"
        }
      }
    ],
    "domain_trends": [
      {
        "domain_id": "Condition",
        "domain_name": "Condition",
        "trending_concepts_count": 67,
        "average_growth_rate": 78.4,
        "top_trending_concept": {
          "concept_id": 1240541000000107,
          "concept_name": "COVID-19 Omicron variant BA.5 infection",
          "trend_score": 8.9
        }
      },
      {
        "domain_id": "Procedure",
        "domain_name": "Procedure",
        "trending_concepts_count": 43,
        "average_growth_rate": 65.2,
        "top_trending_concept": {
          "concept_id": 429914006,
          "concept_name": "Hybrid cardiac catheterization procedure",
          "trend_score": 7.2
        }
      },
      {
        "domain_id": "Drug",
        "domain_name": "Drug",
        "trending_concepts_count": 28,
        "average_growth_rate": 34.7,
        "top_trending_concept": {
          "concept_id": 1234567890,
          "concept_name": "Monoclonal antibody COVID-19 treatment",
          "trend_score": 6.1
        }
      }
    ],
    "vocabulary_trends": [
      {
        "vocabulary_id": "SNOMED",
        "vocabulary_name": "Systematized Nomenclature of Medicine Clinical Terms",
        "trending_concepts_count": 123,
        "trend_momentum": "High"
      },
      {
        "vocabulary_id": "ICD10CM",
        "vocabulary_name": "International Classification of Diseases, Tenth Revision, Clinical Modification",
        "trending_concepts_count": 23,
        "trend_momentum": "Medium"
      },
      {
        "vocabulary_id": "LOINC",
        "vocabulary_name": "Logical Observation Identifiers Names and Codes",
        "trending_concepts_count": 10,
        "trend_momentum": "Low"
      }
    ]
  },
  "meta": {
    "request_id": "req_trending_concepts_123",
    "timestamp": "2024-01-15T10:30:00Z",
    "analysis_parameters": {
      "time_period": "30d",
      "trend_type": "usage",
      "vocabulary_ids": ["SNOMED", "ICD10CM"],
      "trend_threshold": 1.5
    },
    "data_freshness": "Updated 15 minutes ago",
    "pagination": {
      "page": 1,
      "page_size": 20,
      "total_items": 156,
      "total_pages": 8,
      "has_next": true,
      "has_previous": false
    },
    "vocab_release": "2025.2"
  }
}