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