urlscan.io

App · 5 actions

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.

Actions

ActionWhat it does
Get scan DOMGet the page's HTML as it stood after the scan's browser ran its scripts.
Get scan resultGet a finished scan: its verdict, the page and server details, statistics, and the IPs, domains and URLs it contacted.
Get usage limitsSee how many scans, searches and lookups the API key may still make today, this hour and this minute.
Scan URLLoad 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.
Search scansSearch 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.

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 IDscan_idtextRequired
The scan's id, from Scan URL or Search scans. A urlscan.io report address is accepted too.
Maximum charactersmax_charactersnumber
Cut the DOM after this many characters.From 1 to 2000000. Default: 200000.

Outputs

domtext
The page's DOM
lengthnumber
The DOM's full length in characters
scan_idtext
The scan's id
truncatedtrue/false
True when the DOM was cut at the maximum
Example output
{
  "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 IDscan_idtextRequired
The scan's id, from Scan URL or Search scans. A urlscan.io report address is accepted too.

Outputs

countrieslist
Countries the page contacted
dom_urltext
The page's DOM after it ran, as text
domainslist
Domains the page contacted
hasheslist
SHA-256 hashes of the files it loaded
ipslist
IP addresses the page contacted
pageobject
The page the browser ended up on
report_urltext
The scan's report page on urlscan.io
scan_idtext
The scan's id
scanned_attext
When it was scanned (ISO 8601)
screenshot_urltext
The screenshot (PNG image) of the page
serverslist
Server software seen
statsobject
How much the page loaded
tagslist
The tags the scan was given
urltext
The URL that was scanned
urlslist
URLs the page requested
verdictobject
What urlscan.io and its sources make of the page
visibilitytext
unlisted, private or public
Example output
{
  "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

limitslist
One row per kind of call
scopetext
Whose limits these are: user or team
Example output
{
  "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

URLurltextRequired
The page to scan.
Visibilityvisibilitytext
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 countrycountrytext
Load the page from a server in this country. Leave empty to let urlscan.io choose.
Tagstagslist
Words to label the scan with so you can find it again, up to 10 of at most 29 characters.
Browser user agentcustom_user_agenttext
Make the browser identify itself with this text.
Refererreferertext
The address the browser says it came from.
Wait for the resultwait_for_resulttrue/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

countrieslist
Countries the page contacted
dom_urltext
The page's DOM after it ran, as text
domainslist
Domains the page contacted
finishedtrue/false
True when the result is included. False when you chose not to wait: then only the id, URL and links are filled in
hasheslist
SHA-256 hashes of the files it loaded
ipslist
IP addresses the page contacted
pageobject
The page the browser ended up on
report_urltext
The scan's report page on urlscan.io
scan_idtext
The scan's id
scanned_attext
When it was scanned (ISO 8601)
screenshot_urltext
The screenshot (PNG image) of the page
serverslist
Server software seen
statsobject
How much the page loaded
tagslist
The tags the scan was given
urltext
The URL that was scanned
urlslist
URLs the page requested
verdictobject
What urlscan.io and its sources make of the page
visibilitytext
unlisted, private or public
Example output
{
  "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 queryquerytextRequired
A urlscan.io search query.
Maximum resultslimitnumber
How many scans to get, up to 100.From 1 to 100. Default: 25.
Continue aftersearch_aftertext
To get the next page, give the 'next_cursor' the previous Search scans step returned.

Outputs

countnumber
How many scans are on this page
has_moretrue/false
True when there are older matches
next_cursortext
Give this as 'Continue after' to get the next page. Empty on the last page
querytext
The query used
resultslist
The matching scans, newest first
totalnumber
How many scans match (urlscan.io counts up to 10,000)
Example output
{
  "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
}

On this page