Context Retrieval

Search screen and audio content with various filters

Query Screenpipe for content based on various filters.

Use Cases

  • Search for specific text across all applications
  • Find content from a specific application or window
  • Get screenshots from a particular time period
  • Retrieve all visits to a specific website

Examples

Basic search for recent browser activity:

const githubActivity = await pipe.queryScreenpipe({
  browserUrl: "github.com",
  contentType: "ocr",
  limit: 20,
  includeFrames: true
});

Search for specific text with date filters:

const searchResults = await pipe.queryScreenpipe({
  q: "authentication",
  browserUrl: "auth0.com",
  appName: "Chrome",
  contentType: "ocr",
  startTime: new Date(Date.now() - 7 * 24 * 60 * 60 * 1000).toISOString(),
  endTime: new Date().toISOString(),
  limit: 50
});
get/search

Query parameters

qstring nullable
limitinteger
offsetinteger
content_type'all' | 'ocr' | 'audio' | 'ui' | 'audio+ui' | 'ocr+ui' | 'audio+ocr'

Type of content to search for. "all" returns all content types.

start_timestring date-time nullable
end_timestring date-time nullable
app_namestring nullable
window_namestring nullable
frame_namestring nullable
include_framesboolean
min_lengthinteger nullable
max_lengthinteger nullable
speaker_idsstring nullable

Comma-separated list of speaker IDs

focusedboolean nullable
browser_urlstring nullable
speaker_namestring nullable

Filter audio transcriptions by speaker name (case-insensitive partial match)

include_cloudboolean

Include cloud-synced data in search results (requires cloud sync to be enabled)

Response

Search results with pagination

Changes