---
title: "Transcript Exact Match"
method: POST
path: "/api/v1/search/text-to-transcript/exact-match"
tags: ["search > search"]
---

# Transcript Exact Match

`POST /api/v1/search/text-to-transcript/exact-match`

Performs an exact text match search on video transcripts using a natural language text query (e.g., 'thank you for your time' or 'my name is John') within a specified dataset (dataset_id). This searches for exact occurrences of the provided text within video transcript data, not semantic or approximate matching. Returns videos grouped by their exact transcript matches, where each match includes the composite slice (shot or scene) containing the match, the matched transcript text, timestamps, frame numbers, and a coverage score indicating how much of the composite's transcript is covered by the query (1.0 means the query matches the entire transcript).

## Headers

- `Authorization` string, required

## Request body

- SearchTranscriptMatchRequest — Transcript Match Request
  - `dataset_id` string, uuid, required — The unique identifier for the dataset
  - `offset` integer — Starting index to return
  - `limit` integer — Max number of items to return
  - `metadata_filters` SearchMetadataFilters
    - `filters` SearchMetadataFiltersFiltersItems[], required
      - union
        - SearchBooleanEqualsClause
          - `key` string, required
          - `operator` '==', required
          - `value` boolean, required
        - SearchEqualsClause
          - `key` string, required
          - `operator` '==', required
          - `value` string, required
        - SearchNotEqualsClause
          - `key` string, required
          - `operator` '!=', required
          - `value` string, required
        - SearchDateTimeRangeInclusiveClause
          - `key` string, required
          - `start_utc_epoch` number, double, nullable
          - `end_utc_epoch` number, double, nullable
          - `operator` 'DateTimeRangeInclusive', required
  - `moderation_score_type` 'probability' | 'level' — Score type returned by the moderation service. - PROBABILITY: Scores in range 0-1 (uses BGE Reranker model) - LEVEL: Scores in range 0-5 (uses OpenAI model)
  - `text_query` string, required — The text query to search for
  - `composite_type` string, nullable — The composite type to query on.

## Response `200`

Successful Response

- SearchTranscriptTextMatchResponse — Native video model search response for exact transcript text match
  - `data` SearchVideoTranscriptMatch[], required — List of individual transcript matches with their corresponding keyframes
    - `coactive_image_id` string, uuid, required — The coactive image id of the keyframe closest to the transcript match
    - `video` SearchVideo, required — A video asset response
      - `created_user_id` string, required — The user that created the resource
      - `created_dt` string, date-time, required — The created datetime of the resource
      - `updated_user_id` string, required — The user that last updated the resource
      - `updated_dt` string, date-time, required — The datetime the resource was last updated
      - `path` string, nullable — The original path of the video
      - `coactive_video_id` string, uuid, required — The coactive video id
      - `metadata` object, nullable — The user provided metadata for the video
    - `audio_segment` SearchAudioSegment, required — Metadata about a video audio segment
      - `start_time_ms` integer, required — The start time in milliseconds of the beginning of the audio clip
      - `end_time_ms` integer, required — The end time in milliseconds of the end of the audio clip
      - `speech_to_text_transcription` string, required — The text transcription of the audio clip
    - `coverage_score` number, double, nullable — Coverage score for this transcript match. i.e How much of composite transcript is covered by the query text
    - `timestamp` integer, nullable — The timestamp in milliseconds of the keyframe in the video
    - `moderation_score` number, double, nullable — The moderation score of the video

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/coactive/apis/api-reference.md) · [All operations](https://skmtc.dev/coactive/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coactive/api-reference/revisions/1223758be9ba/schema)