Skip to main content
GET
/
v1
/
themes
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/themes?axis=value_chain"
{
  "data": [
    {
      "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."
    },
    {
      "axis": "value_chain",
      "label": "Infrastructure",
      "signal_count": 198,
      "trend": {
        "share_of_voice": 0.18,
        "theil_sen_slope": 0.08,
        "streak": 2,
        "coefficient_of_variation": 0.38,
        "current_week": 22,
        "prior_week": 20,
        "chi2_trend": 8.2,
        "chi2_p_value": 0.004,
        "effect_size": 0.20
      },
      "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."
    }
  ]
}
axis
string
Filter by axis: value_chain or market_force.
data
array
List of theme objects.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/themes?axis=value_chain"
{
  "data": [
    {
      "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."
    },
    {
      "axis": "value_chain",
      "label": "Infrastructure",
      "signal_count": 198,
      "trend": {
        "share_of_voice": 0.18,
        "theil_sen_slope": 0.08,
        "streak": 2,
        "coefficient_of_variation": 0.38,
        "current_week": 22,
        "prior_week": 20,
        "chi2_trend": 8.2,
        "chi2_p_value": 0.004,
        "effect_size": 0.20
      },
      "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."
    }
  ]
}

Authorizations

X-API-Key
string
header
required

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

Query Parameters

axis
string | null

Filter by taxonomy axis: 'value_chain' or 'market_force'.

Response

Successful Response

data
ThemeOverview · object[]
required

List of themes with trend stats.