Skip to main content

API Documentation

The Build Vault provides REST API endpoints for accessing podcast data programmatically.

Available Endpoints

GET /api/insights

Retrieve all insights or filter by category

/api/insights?category=frameworks_and_exercises&page=1&limit=20

Supports pagination: page (default 1), limit (default 20, max 50)

GET /api/podcast_episodes

Get all podcast episodes

/api/podcast_episodes

GET /api/speakers

List all speakers and guests

/api/speakers

GET /api/stats

Get system statistics

/api/stats

GET /api/products

Retrieve all products (insights with category=products)

/api/products?page=1&limit=20

Supports pagination: page (default 1), limit (default 20, max 50)

GET /api/transcripts

Get transcripts for a specific episode (requires episode_id)

/api/transcripts?episode_id=xxx&page=1&limit=10

Note: Rate limited to max 10 transcripts per request. Requires episode_id parameter.

POST /api/ask

AI chat interface

/api/ask

Categories

frameworks_and_exercises

Mental models and strategies

business_ideas

Entrepreneurial concepts

points_of_view

Opinions and perspectives

stories_and_anecdotes

Real-world examples

quotes

Memorable statements

products

Tools and solutions