# urlscan.io

> Scan a web page in a real browser with urlscan.io and get a verdict, the servers it talks to and a screenshot, read finished scans, and search millions of public scans by domain, IP address or title.

App · 5 actions. Web page: https://docs.lodol.com/docs/integrations/urlscan

## Actions

### Get scan DOM

Get the page's HTML as it stood after the scan's browser ran its scripts. Long pages are cut at the maximum you set.

**Inputs**

- Scan ID (`scan_id`, text, required): The scan's id, from Scan URL or Search scans. A urlscan.io report address is accepted too.
- Maximum characters (`max_characters`, number): Cut the DOM after this many characters. From 1 to 2000000. Default: `200000`.

**Outputs**

- `dom` (text): The page's DOM
- `length` (number): The DOM's full length in characters
- `scan_id` (text): The scan's id
- `truncated` (true/false): True when the DOM was cut at the maximum

**Example output**

```json
{
  "dom": "<head><title>Example Domain</title></head><body>...</body>",
  "length": 1951,
  "scan_id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "truncated": false
}
```

### Get scan result

Get a finished scan: its verdict, the page and server details, statistics, and the IPs, domains and URLs it contacted. A scan that is still running is an error: try again in a few seconds.

**Inputs**

- Scan ID (`scan_id`, text, required): The scan's id, from Scan URL or Search scans. A urlscan.io report address is accepted too.

**Outputs**

- `countries` (list): Countries the page contacted
- `dom_url` (text): The page's DOM after it ran, as text
- `domains` (list): Domains the page contacted
- `hashes` (list): SHA-256 hashes of the files it loaded
- `ips` (list): IP addresses the page contacted
- `page` (object): The page the browser ended up on
- `report_url` (text): The scan's report page on urlscan.io
- `scan_id` (text): The scan's id
- `scanned_at` (text): When it was scanned (ISO 8601)
- `screenshot_url` (text): The screenshot (PNG image) of the page
- `servers` (list): Server software seen
- `stats` (object): How much the page loaded
- `tags` (list): The tags the scan was given
- `url` (text): The URL that was scanned
- `urls` (list): URLs the page requested
- `verdict` (object): What urlscan.io and its sources make of the page
- `visibility` (text): unlisted, private or public

**Example output**

```json
{
  "countries": [],
  "dom_url": "https://urlscan.io/dom/0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b/",
  "domains": [
    "example.com"
  ],
  "hashes": [],
  "ips": [
    "104.20.23.154"
  ],
  "page": {
    "apex_domain": "example.com",
    "asn": "AS13335",
    "asn_name": "CLOUDFLARENET - Cloudflare, Inc., US",
    "city": "",
    "country": "US",
    "domain": "example.com",
    "domain_age_days": 4353,
    "ip": "104.20.23.154",
    "mime_type": "text/html",
    "server": "cloudflare",
    "status": "200",
    "title": "Example Domain",
    "tls_issuer": "Cloudflare TLS Issuing ECC CA 3",
    "tls_valid_days": 90,
    "url": "https://example.com/"
  },
  "report_url": "https://urlscan.io/result/0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b/",
  "scan_id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "scanned_at": "2026-11-12T06:38:44.262Z",
  "screenshot_url": "https://urlscan.io/screenshots/0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b.png",
  "servers": [
    "cloudflare"
  ],
  "stats": {
    "malicious_requests": 0,
    "requests": 2,
    "secure_percentage": 100,
    "unique_countries": 1,
    "unique_ips": 1
  },
  "tags": [
    "lodol-test"
  ],
  "url": "https://example.com/",
  "urls": [
    "https://example.com/"
  ],
  "verdict": {
    "brands": [],
    "categories": [],
    "community_votes_malicious": 0,
    "community_votes_total": 0,
    "engines_malicious": 0,
    "engines_total": 0,
    "malicious": false,
    "score": 0,
    "urlscan_score": 0
  },
  "visibility": "unlisted"
}
```

### Get usage limits

See how many scans, searches and lookups the API key may still make today, this hour and this minute.

**Inputs**: None.

**Outputs**

- `limits` (list): One row per kind of call
- `scope` (text): Whose limits these are: user or team

**Example output**

```json
{
  "limits": [
    {
      "action": "unlisted",
      "day_limit": 1000,
      "day_remaining": 999,
      "day_used": 1,
      "hour_limit": 100,
      "hour_remaining": 99,
      "hour_used": 1,
      "minute_limit": 60,
      "minute_remaining": 59,
      "minute_used": 1
    }
  ],
  "scope": "user"
}
```

### Scan URL

Load a web page in a real browser at urlscan.io and get what it found: a verdict, the page and server details, the IPs, domains and URLs it contacted, and links to the screenshot. It takes about 15 seconds, and the step waits for it unless you turn that off. Scans cannot be deleted later, so only scan pages you are happy to have recorded.

**Inputs**

- URL (`url`, text, required): The page to scan.
- Visibility (`visibility`, text): Who can find the scan. Public scans are listed on urlscan.io for everyone to search; unlisted ones only show to security vendors; private ones to you alone (the free daily allowance for these is small). One of: `unlisted` (Unlisted: only security vendors can find it (default)), `private` (Private: only you (the daily allowance is small)), `public` (Public: listed on urlscan.io for everyone). Default: `unlisted`.
- Scan from country (`country`, text): Load the page from a server in this country. Leave empty to let urlscan.io choose.
- Tags (`tags`, list): Words to label the scan with so you can find it again, up to 10 of at most 29 characters.
- Browser user agent (`custom_user_agent`, text): Make the browser identify itself with this text.
- Referer (`referer`, text): The address the browser says it came from.
- Wait for the result (`wait_for_result`, true/false): On: the step waits (up to 2 minutes) and returns the finished scan. Off: it returns the scan id at once; read the result later with Get scan result. Default: `true`.

**Outputs**

- `countries` (list): Countries the page contacted
- `dom_url` (text): The page's DOM after it ran, as text
- `domains` (list): Domains the page contacted
- `finished` (true/false): True when the result is included. False when you chose not to wait: then only the id, URL and links are filled in
- `hashes` (list): SHA-256 hashes of the files it loaded
- `ips` (list): IP addresses the page contacted
- `page` (object): The page the browser ended up on
- `report_url` (text): The scan's report page on urlscan.io
- `scan_id` (text): The scan's id
- `scanned_at` (text): When it was scanned (ISO 8601)
- `screenshot_url` (text): The screenshot (PNG image) of the page
- `servers` (list): Server software seen
- `stats` (object): How much the page loaded
- `tags` (list): The tags the scan was given
- `url` (text): The URL that was scanned
- `urls` (list): URLs the page requested
- `verdict` (object): What urlscan.io and its sources make of the page
- `visibility` (text): unlisted, private or public

**Example output**

```json
{
  "countries": [],
  "dom_url": "https://urlscan.io/dom/0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b/",
  "domains": [
    "example.com"
  ],
  "finished": true,
  "hashes": [],
  "ips": [
    "104.20.23.154"
  ],
  "page": {
    "apex_domain": "example.com",
    "asn": "AS13335",
    "asn_name": "CLOUDFLARENET - Cloudflare, Inc., US",
    "city": "",
    "country": "US",
    "domain": "example.com",
    "domain_age_days": 4353,
    "ip": "104.20.23.154",
    "mime_type": "text/html",
    "server": "cloudflare",
    "status": "200",
    "title": "Example Domain",
    "tls_issuer": "Cloudflare TLS Issuing ECC CA 3",
    "tls_valid_days": 90,
    "url": "https://example.com/"
  },
  "report_url": "https://urlscan.io/result/0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b/",
  "scan_id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "scanned_at": "2026-11-12T06:38:44.262Z",
  "screenshot_url": "https://urlscan.io/screenshots/0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b.png",
  "servers": [
    "cloudflare"
  ],
  "stats": {
    "malicious_requests": 0,
    "requests": 2,
    "secure_percentage": 100,
    "unique_countries": 1,
    "unique_ips": 1
  },
  "tags": [
    "lodol-test"
  ],
  "url": "https://example.com/",
  "urls": [
    "https://example.com/"
  ],
  "verdict": {
    "brands": [],
    "categories": [],
    "community_votes_malicious": 0,
    "community_votes_total": 0,
    "engines_malicious": 0,
    "engines_total": 0,
    "malicious": false,
    "score": 0,
    "urlscan_score": 0
  },
  "visibility": "unlisted"
}
```

### Search scans

Search urlscan.io's finished scans, newest first, with its search syntax: for example domain:example.com, ip:1.2.3.4, page.title:"Sign in" or task.tags:phishing. You see public scans and your own.

**Inputs**

- Search query (`query`, text, required): A urlscan.io search query.
- Maximum results (`limit`, number): How many scans to get, up to 100. From 1 to 100. Default: `25`.
- Continue after (`search_after`, text): To get the next page, give the 'next_cursor' the previous Search scans step returned.

**Outputs**

- `count` (number): How many scans are on this page
- `has_more` (true/false): True when there are older matches
- `next_cursor` (text): Give this as 'Continue after' to get the next page. Empty on the last page
- `query` (text): The query used
- `results` (list): The matching scans, newest first
- `total` (number): How many scans match (urlscan.io counts up to 10,000)

**Example output**

```json
{
  "count": 1,
  "has_more": true,
  "next_cursor": "1794465524262,0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
  "query": "domain:example.com",
  "results": [
    {
      "asn": "AS13335",
      "asn_name": "CLOUDFLARENET - Cloudflare, Inc., US",
      "country": "US",
      "domain": "example.com",
      "ip": "104.20.23.154",
      "malicious": false,
      "page_url": "https://example.com/",
      "report_url": "https://urlscan.io/result/0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b/",
      "requests": 2,
      "scan_id": "0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b",
      "scanned_at": "2026-11-12T06:38:44.262Z",
      "screenshot_url": "https://urlscan.io/screenshots/0199a1b2-c3d4-7e5f-8a9b-0c1d2e3f4a5b.png",
      "server": "cloudflare",
      "status": "200",
      "tags": [
        "lodol-test"
      ],
      "title": "Example Domain",
      "url": "https://example.com/",
      "visibility": "unlisted"
    }
  ],
  "total": 120
}
```
