API Reference

Submit an Analysis Job

POST /api/v1/jobs/

Submits a new audio file for asynchronous analysis. You'll get a job_id immediately.

Form Data Parameters

• file required file
  The audio file to be analyzed. Supported formats: .mp3, .wav, .m4a, etc.
• webhook_url string
  The URL to send the analysis result to. Highly recommended.

Check Job Status

GET /api/v1/jobs/{job_id}

Retrieves the current status and result of a specific job.

Path Parameters

• job_id required string
  The unique ID of the job you want to check.

The Report Object

The Report object is the final JSON output of a successful analysis.

                
{
    "call_summary": {
        "title": "A concise, one-sentence title for the call.",
        "key_topics": ["List", "of", "main", "topics"],
        "next_steps": ["List", "of", "actionable", "next", "steps"]
    },
    "performance_metrics": {
        "clarity_score": "8",
        "engagement_score": "5",
        "talk_to_listen_ratio": "100/0"
    },
    "areas_for_improvement": [
        {
            "point": "A specific, constructive point of feedback.",
            "quote": "The exact quote from the transcript."
        }
    ]
}