Skip to main content
GET
/
v1
/
themes
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/themes?axis=value_chain"
import requests

resp = requests.get(
    "https://api.gildea.ai/v1/themes",
    headers={"X-API-Key": "gld_your_key"},
    params={"axis": "value_chain"},
)
themes = resp.json()
const resp = await fetch(
  "https://api.gildea.ai/v1/themes?axis=value_chain",
  { headers: { "X-API-Key": "gld_your_key" } }
);
const themes = await resp.json();
{
  "themes": [
    {
      "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."
    },
    {
      "axis": "value_chain",
      "label": "Infrastructure",
      "signal_count": 198,
      "trend": {
        "share_of_voice": 0.18,
        "streak": 2,
        "current_week": 22,
        "prior_week": 20
      },
      "direction": "Rising",
      "confidence": "Significant",
      "stability": "Steady",
      "notability": "High",
      "notability_reasoning": "Theme with confirmed upward trend and consistent coverage; notable upward shift reliably gaining traction."
    }
  ]
}
axis
string
Filter by axis: value_chain or market_force.
themes
array
List of theme objects.
curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/themes?axis=value_chain"
import requests

resp = requests.get(
    "https://api.gildea.ai/v1/themes",
    headers={"X-API-Key": "gld_your_key"},
    params={"axis": "value_chain"},
)
themes = resp.json()
const resp = await fetch(
  "https://api.gildea.ai/v1/themes?axis=value_chain",
  { headers: { "X-API-Key": "gld_your_key" } }
);
const themes = await resp.json();
{
  "themes": [
    {
      "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."
    },
    {
      "axis": "value_chain",
      "label": "Infrastructure",
      "signal_count": 198,
      "trend": {
        "share_of_voice": 0.18,
        "streak": 2,
        "current_week": 22,
        "prior_week": 20
      },
      "direction": "Rising",
      "confidence": "Significant",
      "stability": "Steady",
      "notability": "High",
      "notability_reasoning": "Theme with confirmed upward trend and consistent coverage; notable upward shift reliably gaining 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
enum<string> | null

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

Available options:
value_chain,
market_force

Response

Successful Response

themes
ThemeOverview · object[]
required

Themes with trend stats and interpretation. Not paginated (bounded taxonomy).