Families

Media

Retrieve videos, testimonials, podcasts, and the people featured in them.

Use Media collections for personal experiences in education: stories, interviews, and conversations that complement the objective Knowledge Base.

These collections power content formats such as:

Video interviews
Personal stories and testimonials
Podcast shows and episodes
Profiles of professionals in education

Media collections often combine narrative content with taxonomy relations (filters) such as roles, sectors, audiences, and topics. This allows media content to appear alongside informational content throughout the platform.

Filters

Taxonomy collections used for tagging and filtering core content collections.

The following collections make up the Media family.

Retrieve videos

GET /items/videos

The videos collection stores video-based content such as interviews, explainers, or experience stories.

Each video includes basic metadata such as a title, slug, and duration, as well as optional transcript data and chapter information.

Videos may also be linked to profiles representing the people appearing in the video.

Videos with a publication_date in the future are discoverable through the API but cannot yet be viewed.

Video assets are hosted and distributed with Cloudinary. Refer to the article on Cloudinary integration for more info on asset management and optimization.

Cloudinary

Using Cloudinary for asset delivery and transformation.

Retrieve testimonials

GET /items/testimonials

The testimonials collection contains personal stories and experiences from people working in or transitioning into education.

Testimonials are structured similarly to articles and use the content editor to build rich pages composed of modular content blocks.

Content Documents

Learn how to work with our rich JSON documents and the relational nodes.

The main content is stored in the editor_nodes relation, which contains the structured blocks that form the page.

Testimonials with a future publication_date are visible through the API but its content cannot yet be read.

Retrieve podcast shows

GET /items/podcast_shows

The podcast_shows collection represents a podcast series. Each show contains metadata about the podcast as a whole and references the episodes that belong to it.

Podcast shows are directly related to:

episodes
seasons
hosts

Retrieve podcast episodes

GET /items/podcast_episodes

The podcast_episodes collection stores individual podcast episodes belonging to a show. Each episode is associated with both a show and a season.

Episodes may also include transcripts and speaker mappings.

Episodes with a publication_date in the future are visible in listings but cannot yet be played.

Audio assets are hosted and distributed with Cloudinary. Refer to the article on Cloudinary integration for more info on asset management and optimization.

Cloudinary

Using Cloudinary for asset delivery and transformation.

Retrieve seasons

GET /items/seasons

The seasons collection groups podcast episodes into season-based releases.

Retrieve podcast hosts

GET /items/podcast_hosts

The podcast_hosts collection contains information about the hosts presenting podcast episodes.

Hosts can be connected to:

podcast_shows
podcast_episodes

Retrieve featured profiles

GET /items/profiles

The profiles collection represents people featured in media content, such as teachers, guests, or interview subjects.

Profiles provide a reusable way to connect individuals across different types of media content.

Profiles are commonly linked to:

videos
podcast_episodes
testimonials

Navigator

Retrieve programmes, institutions, locations, and regional education desks.

Routes

Build the route questionnaire and return pathways that match a visitor’s answers.