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
| Action | What it does |
|---|---|
| Get scan DOM | Get the page's HTML as it stood after the scan's browser ran its scripts. |
| Get scan result | Get a finished scan: its verdict, the page and server details, statistics, and the IPs, domains and URLs it contacted. |
| Get usage limits | See how many scans, searches and lookups the API key may still make today, this hour and this minute. |
| 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. |
| 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. |
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_idtextRequired - The scan's id, from Scan URL or Search scans. A urlscan.io report address is accepted too.
- Maximum characters
max_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 ID
scan_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
- URL
urltextRequired - The page to scan.
- Visibility
visibilitytext - 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
countrytext - Load the page from a server in this country. Leave empty to let urlscan.io choose.
- Tags
tagslist - 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_agenttext - Make the browser identify itself with this text.
- Referer
referertext - The address the browser says it came from.
- Wait for the result
wait_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 query
querytextRequired - A urlscan.io search query.
- Maximum results
limitnumber - How many scans to get, up to 100.From 1 to 100. Default:
25. - Continue after
search_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
}