Skip to main content
GET
/
v1
/
themes
/
{axis}
/
{label}
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/themes/value_chain/Foundation%20Models"

{
  "axis": "value_chain",
  "label": "Foundation Models",
  "signal_count": 245,
  "trend": {
    "share_of_voice": 0.22,
    "theil_sen_slope": 0.12,
    "streak": 3,
    "coefficient_of_variation": 0.45,
    "current_week": 28,
    "prior_week": 24,
    "chi2_trend": 15.3,
    "chi2_p_value": 0.0001,
    "effect_size": 0.25
  },
  "direction": "Rising",
  "confidence": "Significant",
  "stability": "Steady",
  "priority": "High",
  "priority_reasoning": "Theme with significant and steady upward trend; reliable signal of a narrative gaining sustained traction.",
  "related_themes": [
    {
      "axis": "market_force",
      "label": "Competitive Dynamics",
      "co_occurrence_count": 132
    },
    {
      "axis": "market_force",
      "label": "Capital & Investment",
      "co_occurrence_count": 87
    },
    {
      "axis": "value_chain",
      "label": "Infrastructure",
      "co_occurrence_count": 76
    }
  ]
}
​
axis
string
required
Theme axis: value_chain or market_force.
​
label
string
required
Theme label (e.g., Foundation Models).
​
axis
string
value_chain or market_force.
​
label
string
Theme name.
​
signal_count
integer
Total signals tagged with this theme.
​
trend
object
Trend analytics.
​
direction
string
Rising, Stable, or Declining.
​
confidence
string
Significant or Insignificant.
​
stability
string
Volatile or Steady.
​
priority
string
High, Medium, Low, or Negligible.
​
priority_reasoning
string
Explanation of the priority assignment.
​
related_themes
array
Co-occurring themes from both axes.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/themes/value_chain/Foundation%20Models"

{
  "axis": "value_chain",
  "label": "Foundation Models",
  "signal_count": 245,
  "trend": {
    "share_of_voice": 0.22,
    "theil_sen_slope": 0.12,
    "streak": 3,
    "coefficient_of_variation": 0.45,
    "current_week": 28,
    "prior_week": 24,
    "chi2_trend": 15.3,
    "chi2_p_value": 0.0001,
    "effect_size": 0.25
  },
  "direction": "Rising",
  "confidence": "Significant",
  "stability": "Steady",
  "priority": "High",
  "priority_reasoning": "Theme with significant and steady upward trend; reliable signal of a narrative gaining sustained traction.",
  "related_themes": [
    {
      "axis": "market_force",
      "label": "Competitive Dynamics",
      "co_occurrence_count": 132
    },
    {
      "axis": "market_force",
      "label": "Capital & Investment",
      "co_occurrence_count": 87
    },
    {
      "axis": "value_chain",
      "label": "Infrastructure",
      "co_occurrence_count": 76
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Include in every request as X-API-Key: gld_your_key_here.

Path Parameters

​
axis
string
required
​
label
string
required

Response

Successful Response

​
axis
string
required

Taxonomy axis: 'value_chain' or 'market_force'.

Example:

"value_chain"

​
label
string
required

Theme label.

Example:

"Foundation Models"

​
signal_count
integer
required

Total signals tagged with this theme.

​
trend
ThemeTrendStats · object
required

Trend statistics for this theme.

​
related_themes
RelatedTheme · object[]
required

Themes that frequently co-occur with this theme.

​
direction
string | null

Interpretation: trend direction (Rising/Stable/Declining) based on theil_sen_slope.

​
confidence
string | null

Interpretation: statistical confidence (Significant/Insignificant) based on chi2_p_value.

​
stability
string | null

Interpretation: signal stability (Volatile/Steady) based on coefficient_of_variation.

​
priority
string | null

Derived priority (High/Medium/Low/Negligible) from direction+confidence+stability.

​
priority_reasoning
string | null

Human-readable explanation of the priority assignment.