curl -X GET "https://api.omophub.com/v1/concepts/201826/terms/count?include_breakdown=true&include_examples=true&language_filter=en,es,fr" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

{
  "success": true,
  "data": {
    "concept_id": 201826,
    "concept_name": "Type 2 diabetes mellitus",
    "concept_code": "44054006",
    "vocabulary_id": "SNOMED",
    "domain_id": "Condition",
    "overall_counts": {
      "total_terms": 47,
      "unique_terms": 43,
      "languages_covered": 8,
      "preferred_terms": 8,
      "synonyms": 24,
      "abbreviations": 9,
      "translations": 19,
      "variants": 6
    },
    "term_type_breakdown": [
      {
        "term_type": "preferred",
        "term_type_name": "Preferred Term",
        "count": 8,
        "percentage": 17.0,
        "languages": ["en", "es", "fr", "de", "it", "pt", "nl", "sv"],
        "example_terms": [
          "Type 2 diabetes mellitus",
          "Diabetes mellitus tipo 2",
          "Diabète sucré de type 2",
          "Diabetes mellitus Typ 2"
        ]
      },
      {
        "term_type": "synonym",
        "term_type_name": "Synonym",
        "count": 24,
        "percentage": 51.1,
        "languages": ["en", "es", "fr", "de", "it"],
        "example_terms": [
          "Adult-onset diabetes",
          "Non-insulin dependent diabetes mellitus",
          "Mature onset diabetes",
          "Type II diabetes",
          "Diabetes mellitus no insulinodependiente"
        ]
      },
      {
        "term_type": "abbreviation",
        "term_type_name": "Abbreviation (includes acronyms)",
        "count": 9,
        "percentage": 19.1,
        "languages": ["en", "es", "fr", "de"],
        "example_terms": [
          "T2DM",
          "NIDDM",
          "DM2",
          "Type 2 DM",
          "DMTII"
        ]
      },
      {
        "term_type": "fully_specified_name",
        "term_type_name": "Fully Specified Name",
        "count": 4,
        "percentage": 8.5,
        "languages": ["en", "es", "fr", "de"],
        "example_terms": [
          "Type 2 diabetes mellitus (disorder)",
          "Diabetes mellitus tipo 2 (trastorno)"
        ]
      },
      {
        "term_type": "definition",
        "term_type_name": "Definition",
        "count": 2,
        "percentage": 4.3,
        "languages": ["en", "fr"],
        "example_terms": [
          "A form of diabetes mellitus characterized by insulin resistance",
          "Forme de diabète caractérisée par une résistance à l'insuline"
        ]
      }
    ],
    "language_breakdown": [
      {
        "language_code": "en",
        "language_name": "English",
        "term_count": 19,
        "percentage": 40.4,
        "is_primary_language": true,
        "term_types_available": ["preferred", "synonym", "abbreviation", "fully_specified_name", "definition"],
        "completeness_score": 95.2,
        "example_terms": [
          "Type 2 diabetes mellitus",
          "Adult-onset diabetes",
          "Non-insulin dependent diabetes mellitus",
          "T2DM",
          "NIDDM"
        ]
      },
      {
        "language_code": "es",
        "language_name": "Spanish",
        "term_count": 8,
        "percentage": 17.0,
        "is_primary_language": false,
        "term_types_available": ["preferred", "synonym", "abbreviation"],
        "completeness_score": 78.3,
        "example_terms": [
          "Diabetes mellitus tipo 2",
          "Diabetes no insulinodependiente",
          "DM2",
          "DMTII"
        ]
      },
      {
        "language_code": "fr",
        "language_name": "French",
        "term_count": 6,
        "percentage": 12.8,
        "is_primary_language": false,
        "term_types_available": ["preferred", "synonym", "abbreviation", "definition"],
        "completeness_score": 72.1,
        "example_terms": [
          "Diabète sucré de type 2",
          "Diabète non insulino-dépendant",
          "DNID"
        ]
      },
      {
        "language_code": "de",
        "language_name": "German",
        "term_count": 5,
        "percentage": 10.6,
        "is_primary_language": false,
        "term_types_available": ["preferred", "synonym", "abbreviation"],
        "completeness_score": 68.9,
        "example_terms": [
          "Diabetes mellitus Typ 2",
          "Nicht-insulinabhängiger Diabetes mellitus",
          "NIDDM"
        ]
      },
      {
        "language_code": "it",
        "language_name": "Italian",
        "term_count": 3,
        "percentage": 6.4,
        "is_primary_language": false,
        "term_types_available": ["preferred", "synonym"],
        "completeness_score": 52.7,
        "example_terms": [
          "Diabete mellito di tipo 2",
          "Diabete non insulino-dipendente"
        ]
      },
      {
        "language_code": "pt",
        "language_name": "Portuguese",
        "term_count": 2,
        "percentage": 4.3,
        "is_primary_language": false,
        "term_types_available": ["preferred"],
        "completeness_score": 34.2,
        "example_terms": [
          "Diabetes mellitus tipo 2"
        ]
      },
      {
        "language_code": "nl",
        "language_name": "Dutch",
        "term_count": 2,
        "percentage": 4.3,
        "is_primary_language": false,
        "term_types_available": ["preferred"],
        "completeness_score": 31.8,
        "example_terms": [
          "Diabetes mellitus type 2"
        ]
      },
      {
        "language_code": "sv",
        "language_name": "Swedish",
        "term_count": 2,
        "percentage": 4.3,
        "is_primary_language": false,
        "term_types_available": ["preferred"],
        "completeness_score": 28.9,
        "example_terms": [
          "Diabetes mellitus typ 2"
        ]
      }
    ],
    "context_breakdown": [
      {
        "context": "clinical",
        "context_name": "Clinical Documentation",
        "term_count": 32,
        "percentage": 68.1,
        "primary_term_types": ["preferred", "synonym", "fully_specified_name"],
        "example_terms": [
          "Type 2 diabetes mellitus",
          "Non-insulin dependent diabetes mellitus",
          "Adult-onset diabetes"
        ]
      },
      {
        "context": "patient_facing",
        "context_name": "Patient Communication",
        "term_count": 15,
        "percentage": 31.9,
        "primary_term_types": ["synonym", "abbreviation"],
        "example_terms": [
          "Type 2 diabetes",
          "Adult diabetes",
          "T2D"
        ]
      },
      {
        "context": "research",
        "context_name": "Research and Academic",
        "term_count": 8,
        "percentage": 17.0,
        "primary_term_types": ["fully_specified_name", "definition"],
        "example_terms": [
          "Type 2 diabetes mellitus (disorder)",
          "Non-insulin-dependent diabetes mellitus"
        ]
      },
      {
        "context": "billing",
        "context_name": "Medical Billing",
        "term_count": 6,
        "percentage": 12.8,
        "primary_term_types": ["preferred", "abbreviation"],
        "example_terms": [
          "Type 2 diabetes mellitus",
          "T2DM",
          "DM2"
        ]
      }
    ],
    "linguistic_analysis": {
      "average_term_length": 28.4,
      "term_length_distribution": {
        "short (1-15 chars)": 6,
        "medium (16-30 chars)": 23,
        "long (31-50 chars)": 15,
        "very_long (50+ chars)": 3
      },
      "common_prefixes": [
        {"prefix": "Type", "count": 12},
        {"prefix": "Non-", "count": 8},
        {"prefix": "Adult", "count": 4},
        {"prefix": "Diabetes", "count": 35}
      ],
      "common_suffixes": [
        {"suffix": "diabetes", "count": 28},
        {"suffix": "mellitus", "count": 24},
        {"suffix": "DM", "count": 8}
      ],
      "capitalization_patterns": {
        "title_case": 18,
        "sentence_case": 12,
        "all_caps": 9,
        "mixed": 8
      },
      "punctuation_usage": {
        "with_punctuation": 4,
        "without_punctuation": 43,
        "common_punctuation": ["-", "(", ")"]
      },
      "numeric_content": {
        "terms_with_numbers": 31,
        "most_common_numbers": ["2", "II"],
        "percentage_with_numbers": 66.0
      }
    },
    "historical_comparison": {
      "previous_total": 42,
      "change_count": 5,
      "terms_added": 6,
      "terms_removed": 1,
      "terms_modified": 3,
      "trend": "Increasing"
    },
    "quality_metrics": {
      "completeness_score": 87.3,
      "diversity_score": 82.1,
      "coverage_assessment": "Good",
      "missing_term_types": [
        "brand_name",
        "trade_name"
      ],
      "multilingual_coverage": 76.4,
      "potential_duplicates": 2
    },
    "counting_parameters": {
      "include_breakdown": true,
      "include_examples": true,
      "language_filter": ["en", "es", "fr", "de", "it", "pt", "nl", "sv"],
      "case_sensitivity": "insensitive"
    },
    "data_freshness": "Updated 2 hours ago"
  },
  "meta": {
    "request_id": "req_concept_terms_count_123",
    "timestamp": "2024-01-15T10:30:00Z",
    "vocab_release": "2025.2"
  }
}