- Analyst Insights
- Learning Guides
- News
- Glossary
You render the Learn screen by fetching the Learn API endpoints and composing the results into your UI. See the API Reference → Learn API for full schemas and examples.
Prerequisites
- Backend access to the Learn endpoints
- Bearer token with
read:usersscope x-user-idheader for subscription-aware trimming
What to fetch
Analyst Insights (feed)
Analyst Insights (feed)
Use
GET /analyst-insights?page=1 to fetch the paginated editorial feed. Paid users receive full HTML; non-paid receive trimmed content.Analyst Insight (detail)
Analyst Insight (detail)
Use
GET /analyst-insights/{id} for the full entry when a user opens a story.Learning Guides (catalogue)
Learning Guides (catalogue)
Use
GET /learning-guides to render the carousel with guide metadata. Each guide includes an id field (MongoDB document identifier) that you can use to fetch the full guide content.Learning Guide (by slug or id)
Learning Guide (by slug or id)
Use
GET /learning-guides/slug/{slug} or GET /learning-guides/{id} to fetch chapters for the detail view. The id parameter should be the MongoDB document identifier from the guide’s id field in the catalogue response.News
News
Use
GET /news to fetch the latest stories with Cloudflare-resized images. Each news item includes an id field that you can use to fetch the full article via GET /news/{id}.News Stories
News Stories
Stories are sourced from the
GET /news endpoint and filtered client-side to show items from the past 3 days.Required fields for story display:fullImageURL— Background image when a story is openedpreviewTitleMain— Primary title text (bold)previewTitleSecondary— Secondary title text (regular)createdAt— Creation dateid— Unique identifier
- Tapping “Read more” uses the same news item object from the stories array
- No additional API call is needed; data is reused from the initial response
- The
contentHTMLfield contains the full article HTML content
| Use Case | Field Name | Description |
|---|---|---|
| Story thumbnail | storyImageURL | Circular thumbnail in list |
| Story background | fullImageURL | Full-screen image when opened |
| Story title (bold) | previewTitleMain | Primary title text |
| Story title (regular) | previewTitleSecondary | Secondary title text |
| Story date | createdAt | Creation date |
| Article content | contentHTML | Full article HTML content |
| Article identifier | id | Unique story/article ID |
Glossary
Glossary
Use
GET /glossary to populate the glossary section.Example: minimal client fetch
See also
- API Reference → Learn API →
GET /analyst-insights,GET /learning-guides,GET /news,GET /glossary - Detail endpoints for full entries