urlscan.io logo

urlscan.io

Submit URL scans, retrieve results, and search previously scanned pages.

3 agent tools Integration catalog
Request access
Connect urlscan.io and choose your agent’s tools.
01 · WHAT THE AGENT CAN DO

Agent tools

Each tool is an action the agent calls by name, scoped to what you authorize and recorded in the run trace.

Submit a URL for scanningurlscan_submit_scan
Submit a URL to urlscan.io for a fresh scan. Returns a scan `uuid` and a `result` API URL to poll with get_result (results take ~10s and 404 until ready). VISIBILITY: defaults to `private` — the only truly private level. `unlisted` is hidden from public search but still visible to vetted security companies; `public` is fully public. NEVER submit URLs containing secrets, session tokens, magic-link credentials, or internal hostnames, and strip PII from URLs before scanning. This is a write action and pauses for human approval by default.
Get a scan resulturlscan_get_result
Fetch the full result of a completed scan by its `uuid` (from submit_scan). Returns verdicts, page/redirect data, resources, and a screenshot URL. A 404 means the scan is still running — wait a few seconds and retry.
Search scanned pagesurlscan_search
Search urlscan.io's dataset of previously scanned pages with a query (e.g. `domain:example.com`, `page.url:...`, `ip:...`, `hash:...`). Returns matching scans. This reads the public dataset — do not use it to bulk-mirror or scrape results. Attribute results to urlscan.io.