Skip to content
Docs

API: Ask a Question

Ask a question to the AI based on podcast knowledge. The AI will search relevant podcast content and generate an answer with source citations.

Endpoint

POSThttps://app.podwise.ai/api/open/v1/ask

Request Body

type RequestBody = {
  // The question to ask
  question: string;
};

Response

type Response = {
  success: true;
  result: {
    // Can be used to retrieve this answer later via the Get Ask History Detail endpoint
    hash: string;
    // The AI-generated answer with [citation:N] references
    answer: string;
    relatedQuestions: string[];
    sources: {
      title: string;
      podName: string;
      // Relevant transcript excerpt
      text: string;
      // In seconds
      startTime: number;
      // In seconds
      endTime: number;
      speaker: string;
      epId: string;
      epSeq: number;
      audioLink: string;
      linkType: string;
      // In seconds
      duration: number;
      transcribed: boolean;
    }[];
  };
};