Get Concept Terms Count - OMOPHub.com API

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"
  }
}

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"
  }
}

Overview

This endpoint provides detailed counts of all linguistic terms associated with a concept, including synonyms, abbreviations, translations, and contextual variants. It helps assess the linguistic richness and multilingual coverage of medical concepts.

Path Parameters

conceptId

integer

required

The unique concept identifier

Query Parameters

include_breakdown

boolean

default:"false"

Include detailed breakdown by term type and language

include_examples

boolean

default:"false"

Include example terms for each category

language_filter

string

Filter counts to specific languages (comma-separated BCP 47 language tags)
Examples: en, es,fr,de, en-US,en-GB

term_types

string

Filter to specific term types (comma-separated)
Options: preferred, synonym, fully_specified_name, definition, abbreviation, brand_name, trade_name
Note: Acronyms are counted under the abbreviation type

include_historical

boolean

default:"false"

Include counts from historical/deprecated terms

context_filter

string

Filter by usage context (comma-separated)
Options: clinical, research, billing, patient_facing, administrative

case_sensitivity

string

default:"insensitive"

How to handle case variations in counting
Options: sensitive, insensitive, normalized
Normalization process (for normalized option): Applies Unicode NFKC normalization, lowercase folding, diacritics removal, punctuation/whitespace stripping, and accent-insensitive comparisons using ICU library algorithms. Normalization is applied before tokenization to ensure consistent term matching.

include_variants

boolean

default:"true"

Include spelling and morphological variants

vocab_release

string

Specific vocabulary release version (defaults to latest)

Response

success

boolean

Indicates if the request was successful

data

object

Show Terms Count Data

concept_id

integer

The concept identifier

concept_name

string

Primary concept name

concept_code

string

Concept code

vocabulary_id

string

Source vocabulary identifier

domain_id

string

Domain classification

overall_counts

object

Show Overall Term Counts

total_terms

integer

Total number of all terms

unique_terms

integer

Number of unique terms (after deduplication)

languages_covered

integer

Number of languages with terms

preferred_terms

integer

Number of preferred terms

synonyms

integer

Number of synonyms

abbreviations

integer

Number of abbreviations and acronyms

translations

integer

Number of translated terms across non-primary languages (counts unique terms, not total translations)

variants

integer

Number of spelling and morphological variants

term_type_breakdown

array

Breakdown by term type (if include_breakdown=true)

Show Term Type Count

term_type

string

Type of term

term_type_name

string

Human-readable term type name

count

integer

Number of terms of this type

percentage

number

Percentage of total terms

languages

array

Languages where this term type appears

example_terms

array

Example terms (if include_examples=true)

language_breakdown

array

Breakdown by language (if include_breakdown=true)

Show Language Count

language_code

string

ISO 639-1 language code

language_name

string

Human-readable language name

term_count

integer

Number of terms in this language

percentage

number

Percentage of total terms

is_primary_language

boolean

Whether this is the concept’s primary language

term_types_available

array

Term types available in this language

completeness_score

number

Language completeness score (0-100)

example_terms

array

Example terms in this language (if include_examples=true)

context_breakdown

array

Breakdown by usage context (if include_breakdown=true). Percentages may exceed 100% due to terms belonging to multiple contexts.

Show Context Count

context

string

Usage context identifier

context_name

string

Human-readable context name

term_count

integer

Number of terms for this context

percentage

number

Percentage of total terms

primary_term_types

array

Most common term types in this context

example_terms

array

Example terms for this context (if include_examples=true)

linguistic_analysis

object

Show Linguistic Analysis

average_term_length

number

Average character length of terms

term_length_distribution

object

Distribution of terms by length categories

common_prefixes

array

Most common term prefixes

common_suffixes

array

Most common term suffixes

capitalization_patterns

object

Analysis of capitalization usage

punctuation_usage

object

Analysis of punctuation in terms

numeric_content

object

Analysis of numeric content in terms

historical_comparison

object

Comparison with historical versions (if include_historical=true)

Show Historical Comparison

previous_total

integer

Total terms in previous version

change_count

integer

Net change in term count

terms_added

integer

Number of terms added

terms_removed

integer

Number of terms removed

terms_modified

integer

Number of terms modified

trend

string

Overall trend (Increasing, Decreasing, Stable)

quality_metrics

object

Show Quality Metrics

completeness_score

number

Overall term completeness score (0-100)

diversity_score

number

Linguistic diversity score (0-100)

coverage_assessment

string

Assessment of term coverage (Excellent, Good, Fair, Poor)

missing_term_types

array

Term types that are missing or underrepresented

multilingual_coverage

number

Multilingual coverage score (0-100)

potential_duplicates

integer

Number of potential duplicate terms identified

counting_parameters

object

Parameters used for counting

data_freshness

string

How recent the term data is

meta

object

Show Metadata

request_id

string

Unique identifier for the request

timestamp

string

Request timestamp

vocab_release

string

Vocabulary release version used

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"
  }
}

Usage Examples

Basic Term Count

Get basic term count for a concept:

curl -X GET "https://api.omophub.com/v1/concepts/201826/terms/count" \
  -H "Authorization: Bearer YOUR_API_KEY"

Detailed Breakdown with Examples

Get comprehensive term analysis:

curl -X GET "https://api.omophub.com/v1/concepts/201826/terms/count?include_breakdown=true&include_examples=true&include_historical=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Multilingual Analysis

Focus on specific languages:

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

Term Type Analysis

Analyze specific term types:

curl -X GET "https://api.omophub.com/v1/concepts/73211009/terms/count?term_types=synonym,abbreviation&include_breakdown=true&include_examples=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Context-Specific Counting

Focus on specific usage contexts:

curl -X GET "https://api.omophub.com/v1/concepts/440383006/terms/count?context_filter=clinical,patient_facing&include_breakdown=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Historical Trend Analysis

Compare with historical versions:

curl -X GET "https://api.omophub.com/v1/concepts/201826/terms/count?include_historical=true&include_breakdown=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

Term Types

Preferred Terms

Description: Official or primary terms for the concept
Usage: Clinical documentation, official references
Characteristics: One per language, standardized format

Synonyms

Description: Alternative terms with equivalent meaning
Usage: Search enhancement, user flexibility
Characteristics: Multiple variants, clinical and lay terms

Abbreviations/Acronyms

Description: Shortened forms of concept names
Usage: Efficient documentation, common usage
Characteristics: Letters, numbers, specialized notation

Fully Specified Names

Description: Unambiguous terms with semantic tags
Usage: Disambiguation, formal classification
Characteristics: Includes semantic qualifiers in parentheses

Definitions

Description: Explanatory text defining the concept
Usage: Education, clarification, reference
Characteristics: Comprehensive descriptions

Brand/Trade Names

Description: Commercial names for products
Usage: Pharmaceutical and device identification
Characteristics: Proprietary terminology

Language Coverage

Primary Language

English: Most comprehensive coverage
Characteristics: All term types available
Completeness: Typically 90-100%

Major International Languages

Spanish, French, German: Good coverage
Term Types: Preferred, synonyms, abbreviations
Completeness: Typically 60-85%

Regional Languages

Italian, Portuguese, Dutch, Swedish: Moderate coverage
Term Types: Primarily preferred terms
Completeness: Typically 30-65%

Specialized Languages

Medical Latin, Greek roots: Limited but specific
Usage: Etymology, formal classification
Completeness: Variable by vocabulary

Quality Metrics

Completeness Score (0-100)

90-100: Excellent term coverage across types and languages
75-89: Good coverage with minor gaps
60-74: Fair coverage, some term types missing
Below 60: Limited coverage, significant gaps

Diversity Score (0-100)

Measures: Variety of term types and linguistic patterns
High Score: Rich synonym sets, multiple abbreviations
Low Score: Limited variation, primarily preferred terms

Multilingual Coverage (0-100)

Measures: Distribution across languages
High Score: Terms available in many languages
Low Score: Limited to primary language

Use Cases

Clinical Documentation

Need: Preferred terms and clinical synonyms
Focus: Accuracy, standardization
Languages: Primary language emphasis

Patient Communication

Need: Lay terms, simplified language
Focus: Understandability, cultural sensitivity
Languages: Patient population languages

Search and Retrieval

Need: Comprehensive synonym coverage
Focus: Findability, variant recognition
Languages: Multilingual support

Billing and Coding

Need: Official terms, standard abbreviations
Focus: Compliance, consistency
Languages: Regulatory language requirements

Research and Analytics

Need: Fully specified names, definitions
Focus: Precision, disambiguation
Languages: Scientific terminology

Get Concept - Complete concept information including terms
Search Concepts - Search using various terms
Suggest Concepts - Term-based concept suggestions
Get Concept Relationships - Related concept terms

⌘I

API Reference

Concepts

Concept Hierarchy

Search

Search (Coming Soon)

Relationships

Domains & Classifications

Mappings

Vocabularies

​Overview

​Path Parameters

​Query Parameters

​Response

​Usage Examples

​Basic Term Count

​Detailed Breakdown with Examples

​Multilingual Analysis

​Term Type Analysis

​Context-Specific Counting

​Historical Trend Analysis

​Term Types

​Preferred Terms

​Synonyms

​Abbreviations/Acronyms

​Fully Specified Names

​Definitions

​Brand/Trade Names

​Language Coverage

​Primary Language

​Major International Languages

​Regional Languages

​Specialized Languages

​Quality Metrics

​Completeness Score (0-100)

​Diversity Score (0-100)

​Multilingual Coverage (0-100)

​Use Cases

​Clinical Documentation

​Patient Communication

​Search and Retrieval

​Billing and Coding

​Research and Analytics

​Related Endpoints

Overview

Path Parameters

Query Parameters

Response

Usage Examples

Basic Term Count

Detailed Breakdown with Examples

Multilingual Analysis

Term Type Analysis

Context-Specific Counting

Historical Trend Analysis

Term Types

Preferred Terms

Synonyms

Abbreviations/Acronyms

Fully Specified Names

Definitions

Brand/Trade Names

Language Coverage

Primary Language

Major International Languages

Regional Languages

Specialized Languages

Quality Metrics

Completeness Score (0-100)

Diversity Score (0-100)

Multilingual Coverage (0-100)

Use Cases

Clinical Documentation

Patient Communication

Search and Retrieval

Billing and Coding

Research and Analytics

Related Endpoints