--- title: "Get a search response by ID" method: GET path: "/search/{search_id}" tags: ["Search"] --- # Get a search response by ID `GET /search/{search_id}` ## Request - Base URL: `https://api.cloudglue.dev/v1` - URL: `https://api.cloudglue.dev/v1/search/{search_id}` - Auth: HTTP bearer Get a search response by search_id. ## Path parameters - `search_id` string, uuid, required ## Response `200` A search response - SearchResponse - `id` string, uuid, required: ID of the search response - `object` 'search', required: Object type, always 'search' - `query` string: The search query that was executed (for text search) or the source image URL/base64 indicator (for face search) - `scope` 'file' | 'segment' | 'face' | 'moment', required: The search scope that was used - `group_by_key` 'file': The key used for grouping results. Only present when group_by_key was specified in the request and results are grouped. - `group_count` integer: Number of groups in the results. Only present when group_by_key is specified. - `search_modalities` string[]: Specifies the type(s) of search to execute. When multiple modalities are specified, a hybrid search is executed that combines results from each modality. Available modalities: - `general_content`: baseline for matching the content of the search item (file/segment) based on visual or spoken content similarity to provided short natural language query string - `speech_lexical`: performs keyword based search (e.g. query of `president` matching `president` or `presidential` strings) and exact match (e.g. specifically find mentions of `"Barack Obama"` or `"Donald Trump"`) against speech content present in search item - `ocr_lexical`: performs keyword based search and exact match against screen text content present in search item - `tag_semantic`: performs basic word semantic similarity search against tag values associated with search items (e.g. `query=animal` expected to match tags with value containing `dog` or `cat`) - `tag_lexical`: performs keyword based search and exact match against tag values associated with search items - `doc_lexical`: performs keyword based search and exact match against file-level documents (generated summaries, metadata-collection docs, and entity-collection docs). Only applicable when search `scope=file`. Only applicable when search `scope=file` or `scope=segment`. - `results` union[], required: Array of search results ranked by relevance score - union - FileSearchResult - `type` 'file', required: Result type, always 'file' - `file_id` string, uuid, required: ID of the file - `collection_id` string, uuid, required: ID of the collection containing this file - `id` string, uuid, required: ID of the search document - `score` number, required: Relevance score (higher is more relevant) - `filename` string, nullable: Original filename of the video - `summary` string, nullable: Generated summary of the video - `generated_title` string, nullable: Generated title of the video - `thumbnail_url` string, uri: URL of the thumbnail for the file if available. - `tag` SearchTagResponse: The associated tag for the search result if it exists. Only provided for search requests with tag_semantic or tag_lexical search modalities. - `id` string, uuid: The ID of the tag - `value` string: The value of the tag - `label` string: The label of the tag - SegmentSearchResult - `type` 'segment', required: Result type, always 'segment' - `file_id` string, uuid, required: ID of the file - `collection_id` string, uuid, required: ID of the collection containing this file - `segment_id` string, uuid, required: ID of the segment - `id` string, uuid, required: ID of the search document - `score` number, required: Relevance score (higher is more relevant) - `start_time` number, required: Start time of the segment in seconds - `end_time` number, required: End time of the segment in seconds - `title` string, nullable: Title associated with the segment - `filename` string, nullable: Original filename of the video - `visual_description` object[]: Visual descriptions for the segment - `text` string: Description of visual content in the segment - `start_time` number: Start time of the visual content in seconds - `end_time` number: End time of the visual content in seconds - `scene_text` object[]: Text detected on screen in the segment - `text` string: Text detected on screen - `start_time` number: Start time of the text in seconds - `end_time` number: End time of the text in seconds - `speech` object[]: Speech transcription for the segment - `speaker` string: Identified speaker - `text` string: Transcribed speech text - `start_time` number: Start time of speech in seconds - `end_time` number: End time of speech in seconds - `thumbnail_url` string, uri: URL of the thumbnail for the segment if available - `tag` SearchTagResponse: The associated tag for the search result if it exists. Only provided for search requests with tag_semantic or tag_lexical search modalities. - `id` string, uuid: The ID of the tag - `value` string: The value of the tag - `label` string: The label of the tag - `metadata` object: User-provided metadata about the segment, if provided. - `keyframes` object[]: Keyframes for the segment - `time_in_seconds` number: Time of the keyframe in seconds - `thumbnail_url` string, uri: URL of the thumbnail for the keyframe - FaceSearchResult - `type` 'face', required: Result type, always 'face' - `file_id` string, uuid, required: ID of the file containing the matched face - `collection_id` string, uuid, required: ID of the collection containing this file - `face_id` string, uuid, required: ID of the detected face - `frame_id` string, uuid, required: ID of the frame where the face was detected - `score` number, required: Similarity score (higher is more similar) - `timestamp` number, required: Timestamp of the frame in seconds - `face_bounding_box` object - `height` number, required: Height of the bounding box (normalized 0-1) - `width` number, required: Width of the bounding box (normalized 0-1) - `top` number, required: Top position of the bounding box (normalized 0-1) - `left` number, required: Left position of the bounding box (normalized 0-1) - `thumbnail_url` string: URL of the frame thumbnail - MomentSearchResult: A moment search hit (scope='moment'): the full moment record plus provenance and a query-relevance search_score. - `moment_id` string, uuid, required - `start_time` number, required: Seconds from source start. - `end_time` number, required - `anchors` object: Declared anchors only; an anchor that was not found is absent, never null. - `title` string, required - `reason` string, required - `speakers` string[] - `criterion_score` CriterionScore: The rubric's judgment on its own declared scale. - `key` string, required - `value` number, required - `min` number, required - `max` number, required - `rank_score` number, required: Normalized ordering within the run; what the default sort uses. - `properties` object: Validates against the criterion's moment_schema. - `evidence` object - `signals` string[] - `type` 'moment', required - `file_id` string, uuid, required - `collection_id` string, uuid, required - `job_id` string, uuid, required: The find-moments run that produced this moment - `criterion_name` string, required - `search_score` number, required: Query relevance for this search only — unrelated to the moment's criterion_score and rank_score - `filename` string, nullable, required - SegmentGroupResult - `type` 'segment_group', required: Result type, always 'segment_group' - `matched_items` SegmentSearchResult[], required: Array of segment search results that belong to this file - `type` 'segment', required: Result type, always 'segment' - `file_id` string, uuid, required: ID of the file - `collection_id` string, uuid, required: ID of the collection containing this file - `segment_id` string, uuid, required: ID of the segment - `id` string, uuid, required: ID of the search document - `score` number, required: Relevance score (higher is more relevant) - `start_time` number, required: Start time of the segment in seconds - `end_time` number, required: End time of the segment in seconds - `title` string, nullable: Title associated with the segment - `filename` string, nullable: Original filename of the video - `visual_description` object[]: Visual descriptions for the segment - `text` string: Description of visual content in the segment - `start_time` number: Start time of the visual content in seconds - `end_time` number: End time of the visual content in seconds - `scene_text` object[]: Text detected on screen in the segment - `text` string: Text detected on screen - `start_time` number: Start time of the text in seconds - `end_time` number: End time of the text in seconds - `speech` object[]: Speech transcription for the segment - `speaker` string: Identified speaker - `text` string: Transcribed speech text - `start_time` number: Start time of speech in seconds - `end_time` number: End time of speech in seconds - `thumbnail_url` string, uri: URL of the thumbnail for the segment if available - `tag` SearchTagResponse: The associated tag for the search result if it exists. Only provided for search requests with tag_semantic or tag_lexical search modalities. - `id` string, uuid: The ID of the tag - `value` string: The value of the tag - `label` string: The label of the tag - `metadata` object: User-provided metadata about the segment, if provided. - `keyframes` object[]: Keyframes for the segment - `time_in_seconds` number: Time of the keyframe in seconds - `thumbnail_url` string, uri: URL of the thumbnail for the keyframe - `file_id` string, uuid, required: ID of the file that this group represents - `item_count` integer, required: Number of matched items in this group - `best_score` number, required: The highest score among all items in this group - FaceGroupResult - `type` 'face_group', required: Result type, always 'face_group' - `matched_items` FaceSearchResult[], required: Array of face search results that belong to this file - `type` 'face', required: Result type, always 'face' - `file_id` string, uuid, required: ID of the file containing the matched face - `collection_id` string, uuid, required: ID of the collection containing this file - `face_id` string, uuid, required: ID of the detected face - `frame_id` string, uuid, required: ID of the frame where the face was detected - `score` number, required: Similarity score (higher is more similar) - `timestamp` number, required: Timestamp of the frame in seconds - `face_bounding_box` object - `height` number, required: Height of the bounding box (normalized 0-1) - `width` number, required: Width of the bounding box (normalized 0-1) - `top` number, required: Top position of the bounding box (normalized 0-1) - `left` number, required: Left position of the bounding box (normalized 0-1) - `thumbnail_url` string: URL of the frame thumbnail - `file_id` string, uuid, required: ID of the file that this group represents - `item_count` integer, required: Number of matched items in this group - `best_score` number, required: The highest score among all items in this group - `total` integer, required: Total number of results returned. When group_by_key is specified, this represents the total number of items across all groups (not the number of groups). - `limit` integer, required: The limit that was applied to the search ## Other responses - `404`: Search response not found - `500`: An unexpected error occurred on the server ## Changes - **2026-10-30** `23d3f240819f`: 2 info - added the optional property `code` to the response with the `404` status - added the optional property `code` to the response with the `500` status - **2026-08-22** `d2a5205fc779`: 1 breaking, 1 warning - added `#/components/schemas/MomentSearchResult` to the `results/items/` response property `oneOf` list for the response status `200` - added the new `moment` enum value to the `scope` response property for the response status `200` - **2026-07-22** `c02e52ec2e28`: 1 warning - added the new `doc_lexical` enum value to the `search_modalities/items/` response property for the response status `200` - **2025-12-18** `4a6898f33a3d`: 2 warning, 5 info - added the new `tag_lexical` enum value to the `search_modalities/items/` response property for the response status `200` - added the new `tag_semantic` enum value to the `search_modalities/items/` response property for the response status `200` - added the optional property `results/items/oneOf[#/components/schemas/FileSearchResult]/tag` to the response with the `200` status - added the optional property `results/items/oneOf[#/components/schemas/SegmentGroupResult]/matched_items/items/metadata` to the response with the `200` status - …3 more - **2025-12-12** `89641a9d6eb2`: 1 info - endpoint added [Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/search/:search_id/get.md) --- [API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [All operations](https://skmtc.dev/cloudglue/apis/cloudglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudglue/apis/cloudglue-api/revisions/23d3f240819f?raw)