Skip to main content
GET
Get theme detail
For what each theme covers and how the trend fields are derived, see Themes.

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

Taxonomy axis: 'value_chain' or 'market_force'.

Example:

"value_chain"

label
string
required

URL-encoded theme label (see GET /v1/themes for the taxonomy). An unknown label returns 404.

Example:

"Foundation Models"

Response

Successful Response

axis
string
required

Taxonomy axis: 'value_chain' or 'market_force'.

Example:

"value_chain"

label
string
required
Example:

"Foundation Models"

signal_count
integer
required

Total signals tagged with this theme.

Example:

245

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
Example:

"Rising"

confidence
enum<string> | null

Interpretation: statistical confidence.

Available options:
Significant,
Insignificant
Example:

"Significant"

stability
enum<string> | null

Interpretation: signal stability.

Available options:
Volatile,
Steady
Example:

"Steady"

notability
enum<string> | null

Interpretation: foreground vs background.

Available options:
High,
Medium,
Low,
Negligible
Example:

"High"

notability_reasoning
string | null
Example:

"Share of voice is climbing and the growth streak is intact this week."

Co-occurring themes ranked by frequency.