---
title: "Get a list of search responses"
method: GET
path: "/search"
tags: ["Search"]
---

# Get a list of search responses

`GET /search`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/search`
- Auth: HTTP bearer

Get a list of search responses. Order by `created_at` in descending order by default.

## Query parameters

- `limit` integer
- `offset` integer
- `created_before` string, date
- `created_after` string, date

## Response `200`

A search

- SearchResponseList
  - `object` 'list', required: Object type, always 'list'
  - `data` object[], required
    - `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`.
    - `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
  - `total` integer, required: Total number of search responses matching the query
  - `limit` integer, required: Number of items returned in this response
  - `offset` integer, required: Offset from the start of the list

## Other responses

- `404`: Search 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 warning
  - added the new `moment` enum value to the `data/items/scope` response property for the response status `200`
- **2026-07-22** `c02e52ec2e28`: 1 warning
  - added the new `doc_lexical` enum value to the `data/items/search_modalities/items/` response property for the response status `200`
- **2026-03-11** `1d5d6115c0d0`: 2 breaking
  - for the `query` request parameter `limit`, default value `50` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
- **2026-01-02** `9d805815496c`: 2 info
  - added the new optional `query` request parameter `created_after`
  - added the new optional `query` request parameter `created_before`

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/search/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)