HTTP API

Authenticate public search with the X-API-Key header (API plan: monthly quota on programmatic search requests, not a meter for raw speech or LLM tokens). Create keys from the dashboard under API Keys. Base URL in this environment: https://askraymondv2-production.up.railway.app

Search podcasts

GET https://askraymondv2-production.up.railway.app/api/v1/public/search/podcasts?q=machine+learning&limit=20
X-API-Key: sk_ask_...

Search episodes

Full-text search is scoped to podcasts you subscribe to in the app.

GET https://askraymondv2-production.up.railway.app/api/v1/public/search/episodes?q=agents&limit=20
X-API-Key: sk_ask_...

Browser session API

The Next.js app calls authenticated routes with your Supabase JWT (Bearer token), for example /api/v1/episodes/{id}, /api/v1/search/episodes, and billing endpoints. Use the in-app Network tab while logged in to inspect requests.

OpenAPI

Interactive schema for the Python service: https://askraymondv2-production.up.railway.app/docs