---
title: "Search screen and audio content"
method: GET
path: "/search"
tags: ["Search"]
---

# Search screen and audio content

`GET /search`

Query captured screen text (accessibility-first with OCR fallback), audio transcriptions, and UI elements with filters for time range, app, window, content type, and more.

## Query parameters

- `q` string, nullable
- `limit` integer
- `offset` integer
- `content_type` 'all' | 'ocr' | 'audio' | 'input' | 'accessibility' | 'memory'
- `start_time` string, date-time, nullable
- `end_time` string, date-time, nullable
- `app_name` string, nullable
- `window_name` string, nullable
- `frame_name` string, nullable
- `include_frames` boolean
- `min_length` integer, nullable
- `max_length` integer, nullable
- `speaker_ids` integer[], nullable
- `focused` boolean, nullable
- `browser_url` string, nullable
- `speaker_name` string, nullable
- `include_cloud` boolean
- `max_content_length` integer, nullable
- `device_name` string, nullable
- `machine_id` string, nullable

## Response `200`

OK

- SearchResponse
  - `data` ContentItem[], required
    - union
      - object
        - `type` 'OCR', required
        - `content` object, required
          - `frame_id` integer, required
          - `text` string, required
          - `timestamp` string, date-time, required
          - `file_path` string, required
          - `offset_index` integer, required
          - `app_name` string, required
          - `window_name` string, required
          - `tags` string[], required
          - `frame` string, nullable, required
          - `frame_name` string, nullable, required
          - `browser_url` string, nullable, required
          - `focused` boolean, nullable, required
          - `device_name` string, required
      - object
        - `type` 'Audio', required
        - `content` object, required
          - `chunk_id` integer, required
          - `transcription` string, required
          - `timestamp` string, date-time, required
          - `file_path` string, required
          - `offset_index` integer, required
          - `tags` string[], required
          - `device_name` string, required
          - `device_type` 'Input' | 'Output', required
          - `speaker` Speaker, required
            - `id` integer, required
            - `name` string, required
            - `metadata` string, required
          - `start_time` number, nullable, required
          - `end_time` number, nullable, required
      - object
        - `type` 'UI', required
        - `content` object, required
          - `id` integer, required
          - `text` string, required
          - `timestamp` string, date-time, required
          - `app_name` string, required
          - `window_name` string, required
          - `initial_traversal_at` string, date-time, nullable, required
          - `file_path` string, required
          - `offset_index` integer, required
          - `frame_name` string, nullable, required
          - `browser_url` string, nullable, required
      - object
        - `type` 'Input', required
        - `content` object, required — User input event content (clicks, keystrokes, clipboard, etc.)
          - `id` integer, required
          - `timestamp` string, date-time, required
          - `event_type` string, required
          - `app_name` string, nullable, required
          - `window_title` string, nullable, required
          - `browser_url` string, nullable, required
          - `text_content` string, nullable, required
          - `x` integer, nullable, required
          - `y` integer, nullable, required
          - `key_code` integer, nullable, required
          - `modifiers` integer, nullable, required
          - `element_role` string, nullable, required
          - `element_name` string, nullable, required
      - object
        - `type` 'Memory', required
        - `content` object, required
          - `id` integer, required
          - `content` string, required
          - `source` string, required
          - `source_context` object, nullable, required
          - `tags` string[], required
          - `importance` number, required
          - `created_at` string, required
          - `updated_at` string, required
  - `pagination` PaginationInfo, required
    - `limit` integer, required
    - `offset` integer, required
    - `total` integer, required
  - `cloud` CloudSearchMetadata — Metadata about cloud search to include in responses.
    - `cloudSearchAvailable` boolean, required
    - `cloudHasRelevantData` boolean, required
    - `cloudQueryHint` string, nullable, required
    - `status` 'available' | 'disabled' | 'not_initialized' | 'error', required

## Changes

> 10 revisions in range; 1 could not be searched.

- **2026-04-09** `0f0f8030c7e2` — 1 info
  - api tag `Search` added
- **2026-04-08** `1a63468a8d30` — 10 breaking, 2 warning, 13 info
  - for the `query` request parameter `include_cloud`, default value `false` was removed
  - for the `query` request parameter `include_frames`, default value `false` was removed
  - for the `query` request parameter `limit`, default value `20` was removed
  - for the `query` request parameter `offset`, default value `0` was removed
  - …21 more
- **2026-02-16** `e143bf8d73bc` — 5 breaking, 6 info
  - for the `query` request parameter `include_frames`, default value `false` was added
  - for the `query` request parameter `limit`, default value `20` was added
  - for the `query` request parameter `offset`, default value `0` was added
  - removed the required property `results` from the response with the `200` status
  - …7 more
- **2026-02-11** `2825740bcf63` — 7 breaking, 3 warning, 4 info
  - removed the enum value `audio+input` from the `query` request parameter `content_type`
  - removed the enum value `input` from the `query` request parameter `content_type`
  - removed the enum value `vision` from the `query` request parameter `content_type`
  - removed the enum value `vision+audio+input` from the `query` request parameter `content_type`
  - …10 more
- **2026-02-11** `61c0a2f34556` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/screenpipe/apis/screenpipe-api/changes/search/get.md)

---

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