Skip to content

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

docs: clarify browser URL search semantics

AI Agent5a36ffe6bc19
diff --git a/docs/mintlify/docs-mintlify-mig-tmp/api-recipes.mdx b/docs/mintlify/docs-mintlify-mig-tmp/api-recipes.mdx
index e1c3597b3..f5508a47d 100644
--- a/docs/mintlify/docs-mintlify-mig-tmp/api-recipes.mdx
+++ b/docs/mintlify/docs-mintlify-mig-tmp/api-recipes.mdx
@@ -45,7 +45,14 @@ curl -H "Authorization: Bearer $SCREENPIPE_API_KEY" \
"http://localhost:3030/search?browser_url=github.com&limit=20&start_time=24h+ago&end_time=now"
```
-use `app_name` for desktop app names and `browser_url` for web activity captured through browser metadata.
+`browser_url` is matched against captured browser metadata; it is not a URL substring search. To find pages whose captured URL contains a domain or path, use `q` instead:
+
+```bash
+curl -H "Authorization: Bearer $SCREENPIPE_API_KEY" \
+ "http://localhost:3030/search?q=github.com&limit=20&start_time=24h+ago&end_time=now"
+```
+
+use `app_name` for desktop app names and `browser_url` for exact or normalized URL filtering. URLs are also returned as metadata in matching results.
## 4. search a precise time window
@@ -186,7 +193,7 @@ replace both placeholders with reviewed ISO 8601 UTC timestamps. data deletion i
| `content_type` | narrowing to `ocr`, `audio`, `input`, `accessibility`, or `all` |
| `app_name` | filtering to a desktop app |
| `window_name` | filtering to a window title |
-| `browser_url` | filtering to a website or URL pattern |
+| `browser_url` | exact or normalized filtering on captured browser metadata; use `q` for URL substring searches |
| `speaker_name` | finding what one person said |
| `speaker_ids` | using exact speaker IDs after cleanup |
| `start_time` / `end_time` | constraining a meeting, work block, or incident |