Skip to main content
POST
/
v1
/
transcripts
/
search
curl -X POST https://api.mavioapp.com/v1/transcripts/search \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "launch timeline",
    "from": "2026-04-01T00:00:00Z",
    "limit": 5
  }'

{
  "data": [
    {
      "meeting_id": "mtg_8f3k2j1m4n5p",
      "meeting_title": "Weekly Product Sync",
      "transcript_id": "trs_9a2b3c4d5e6f",
      "segment": {
        "id": "seg_002",
        "speaker": {
          "id": "prt_d4e5f6",
          "name": "James Rodriguez"
        },
        "text": "On the <mark>launch timeline</mark>, we're still tracking for April 20th. The only risk is the payment integration.",
        "start": 13.1,
        "end": 22.6
      },
      "context": {
        "before": [
          {
            "id": "seg_001",
            "speaker": { "id": "prt_a1b2c3", "name": "Sarah Chen" },
            "text": "Let's get started with our weekly product sync. I want to cover three things today: the launch timeline, the open bugs from QA, and next sprint planning.",
            "start": 2.4,
            "end": 12.8
          }
        ],
        "after": [
          {
            "id": "seg_003",
            "speaker": { "id": "prt_g7h8i9", "name": "Priya Patel" },
            "text": "I actually got the Stripe credentials this morning. I'll have the integration tested by end of day tomorrow.",
            "start": 23.0,
            "end": 29.4
          }
        ]
      },
      "relevance_score": 0.94
    }
  ],
  "pagination": {
    "total": 12,
    "limit": 5,
    "offset": 0,
    "has_more": true
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt

Use this file to discover all available pages before exploring further.

Search across all of your transcripts using natural language queries. Returns matching segments with surrounding context so you can quickly find the relevant part of a conversation. This endpoint has an additional rate limit of 30 requests per minute. See rate limits.

​
Request body

​
query
string
required
The search query. Supports natural language (e.g., “budget discussion for Q2”) and exact phrase matching with quotes (e.g., "launch date").
​
meeting_id
string
Restrict search to a specific meeting transcript.
​
speaker
string
Filter results to segments from a specific speaker. Accepts a participant ID (e.g., prt_a1b2c3) or a speaker name (partial match supported).
​
from
string
Only search meetings that started on or after this date. ISO 8601 format.
​
to
string
Only search meetings that started on or before this date. ISO 8601 format.
​
language
string
Filter by transcript language (ISO 639-1 code, e.g., en, es, fr).
​
limit
integer
default:"20"
Maximum number of results to return. Between 1 and 100.
​
offset
integer
default:"0"
Number of results to skip for pagination.

​
Response

​
data
array
An array of search results.
​
pagination
object
Pagination metadata.
curl -X POST https://api.mavioapp.com/v1/transcripts/search \
  -H "Authorization: Bearer mvo_live_abc123" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "launch timeline",
    "from": "2026-04-01T00:00:00Z",
    "limit": 5
  }'

{
  "data": [
    {
      "meeting_id": "mtg_8f3k2j1m4n5p",
      "meeting_title": "Weekly Product Sync",
      "transcript_id": "trs_9a2b3c4d5e6f",
      "segment": {
        "id": "seg_002",
        "speaker": {
          "id": "prt_d4e5f6",
          "name": "James Rodriguez"
        },
        "text": "On the <mark>launch timeline</mark>, we're still tracking for April 20th. The only risk is the payment integration.",
        "start": 13.1,
        "end": 22.6
      },
      "context": {
        "before": [
          {
            "id": "seg_001",
            "speaker": { "id": "prt_a1b2c3", "name": "Sarah Chen" },
            "text": "Let's get started with our weekly product sync. I want to cover three things today: the launch timeline, the open bugs from QA, and next sprint planning.",
            "start": 2.4,
            "end": 12.8
          }
        ],
        "after": [
          {
            "id": "seg_003",
            "speaker": { "id": "prt_g7h8i9", "name": "Priya Patel" },
            "text": "I actually got the Stripe credentials this morning. I'll have the integration tested by end of day tomorrow.",
            "start": 23.0,
            "end": 29.4
          }
        ]
      },
      "relevance_score": 0.94
    }
  ],
  "pagination": {
    "total": 12,
    "limit": 5,
    "offset": 0,
    "has_more": true
  }
}