Transcript Exact Match | Coactive AI

curl -X POST https://api.coactive.ai/api/v1/search/text-to-transcript/exact-match \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "dataset_id": "c40276f0-024b-4a3f-b3e6-dcf0d304843e",
  "text_query": "thank you for your time",
  "offset": 0,
  "limit": 100,
  "composite_type": "shot"
}'

{
  "data": [
    {
      "coactive_image_id": "a3f1c2d4-5b6e-4f7a-9c8d-123456789abc",
      "video": {
        "created_user_id": "jane.doe",
        "created_dt": "2023-11-05T10:22:33.123456",
        "updated_user_id": "jane.doe",
        "updated_dt": "2024-04-20T14:45:00.654321",
        "coactive_video_id": "5cf18348-8336-4db7-bb35-db7fbfe8951d",
        "path": "s3://media-videos/season1/episode3.mp4",
        "metadata": {
          "episode": 3,
          "season": 1,
          "show": "The Boys",
          "title": "The Name of the Game"
        }
      },
      "audio_segment": {
        "start_time_ms": 15000,
        "end_time_ms": 18000,
        "speech_to_text_transcription": "Thank you for your time."
      },
      "coverage_score": 1,
      "timestamp": 15000,
      "moderation_score": 0
    }
  ]
}

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).

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).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

dataset_idstringRequiredformat: "uuid"

The unique identifier for the dataset

text_querystringRequired

The text query to search for

offsetintegerOptional0-9223372036854776000Defaults to 0

Starting index to return

limitintegerOptional1-1000Defaults to 100

Max number of items to return

metadata_filtersobject or nullOptional

List of metadata filters to apply to the search

composite_typestring or nullOptionalDefaults to shot

The composite type to query on.

Response

Successful Response

datalist of objects

List of individual transcript matches with their corresponding keyframes

Errors

422

Unprocessable Entity Error