Navigate
Open a new tab and navigate it to a URL, or reuse a tab when a tab ID is provided.
pinchtab nav https://pinchtab.comcurl -X POST http://localhost:9867/navigate \ -H "Content-Type: application/json" \ -d '{"url":"https://pinchtab.com"}'
Response
8f9c7d4e1234567890abcdef12345678CLI Flags
| Flag | Description |
|---|---|
--tab | Reuse existing tab |
--new-tab | Force new tab |
--block-images | Block image loading |
--block-ads | Block ads |
--snap | Output snapshot after navigation |
--snap-diff | Output snapshot diff after navigation |
--print-tab-id | Print only tab ID (auto when piped) |
--json | Full JSON response |
Examples
pinchtab nav https://example.com # Navigate, print tab IDpinchtab nav https://example.com --snap # Navigate and snapshotTAB=$(pinchtab nav https://example.com) # Capture tab ID for reusepinchtab nav https://other.com --tab "$TAB" # Reuse tabpinchtab nav https://example.com --block-images # Skip images
pinchtab nav https://example.com # Navigate, print tab IDpinchtab nav https://example.com --snap # Navigate and snapshotTAB=$(pinchtab nav https://example.com) # Capture tab ID for reusepinchtab nav https://other.com --tab "$TAB" # Reuse tabpinchtab nav https://example.com --block-images # Skip images
API Body Fields
| Field | Description |
|---|---|
url | Target URL (required) |
tabId | Reuse existing tab |
newTab | Force new tab |
blockImages | Block image loading |
blockAds | Block ads |
timeout | Navigation timeout |
waitFor | Wait condition |
waitSelector | Wait for selector |