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"
import requests

theme = requests.get(
    "https://api.gildea.ai/v1/themes/value_chain/Foundation Models",
    headers={"X-API-Key": "gld_your_key"},
).json()
const resp = await fetch(
  "https://api.gildea.ai/v1/themes/value_chain/Foundation%20Models",
  { headers: { "X-API-Key": "gld_your_key" } }
);
const theme = await resp.json();
{
  "axis": "value_chain",
  "label": "Foundation Models",
  "signal_count": 245,
  "trend": {
    "share_of_voice": 0.22,
    "streak": 3,
    "current_week": 28,
    "prior_week": 24
  },
  "direction": "Rising",
  "confidence": "Significant",
  "stability": "Steady",
  "notability": "High",
  "notability_reasoning": "Theme with confirmed upward trend and consistent coverage; notable upward shift reliably gaining 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
    }
  ]
}
{
  "error": {
    "code": "not_found",
    "message": "Theme 'value_chain/nonexistent' not found",
    "status": 404
  }
}
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.
notability
string
High, Medium, Low, or Negligible. How much this theme warrants attention right now.
notability_reasoning
string
Explanation of the notability assignment.
Co-occurring themes from both axes.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/themes/value_chain/Foundation%20Models"
import requests

theme = requests.get(
    "https://api.gildea.ai/v1/themes/value_chain/Foundation Models",
    headers={"X-API-Key": "gld_your_key"},
).json()
const resp = await fetch(
  "https://api.gildea.ai/v1/themes/value_chain/Foundation%20Models",
  { headers: { "X-API-Key": "gld_your_key" } }
);
const theme = await resp.json();
{
  "axis": "value_chain",
  "label": "Foundation Models",
  "signal_count": 245,
  "trend": {
    "share_of_voice": 0.22,
    "streak": 3,
    "current_week": 28,
    "prior_week": 24
  },
  "direction": "Rising",
  "confidence": "Significant",
  "stability": "Steady",
  "notability": "High",
  "notability_reasoning": "Theme with confirmed upward trend and consistent coverage; notable upward shift reliably gaining 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
    }
  ]
}
{
  "error": {
    "code": "not_found",
    "message": "Theme 'value_chain/nonexistent' not found",
    "status": 404
  }
}

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'.

label
string
required
Example:

"Foundation Models"

signal_count
integer
required

Total signals tagged with this theme.

trend
ThemeTrend · object
required

Legible trend counts. Raw estimators (Theil-Sen, chi-square, Cramér's V, CoV) are not exposed — the interpretation fields summarize them.

direction
enum<string> | null

Interpretation: trend direction.

Available options:
Rising,
Stable,
Declining,
New
confidence
enum<string> | null

Interpretation: statistical confidence.

Available options:
Significant,
Insignificant
stability
enum<string> | null

Interpretation: signal stability.

Available options:
Volatile,
Steady
notability
enum<string> | null

Interpretation: foreground vs background.

Available options:
High,
Medium,
Low,
Negligible
notability_reasoning
string | null