Files
Anthropic-Cybersecurity-Skills/skills/analyzing-malicious-url-with-urlscan/references/api-reference.md
T
mukul975 27c6414ca5 Add folder anatomy (scripts/agent.py + references/api-reference.md) for 648 cybersecurity skills
Complete skill folder anatomy across all cybersecurity skills:
- scripts/agent.py: 80-150 line Python agents using real libraries (impacket,
  boto3, azure-mgmt-*, kubernetes, pefile, yara, scapy, shodan, stix2, etc.)
- references/api-reference.md: real API documentation with method signatures
- LICENSE: MIT license for all skill folders
2026-03-10 21:02:12 +01:00

1.5 KiB

API Reference: urlscan.io URL Analysis

Base URL

https://urlscan.io/api/v1

Authentication

API-Key: YOUR_API_KEY

Submit Scan

POST /scan/
{"url": "https://example.com", "visibility": "private"}
Field Values Description
url URL string URL to scan
visibility public/unlisted/private Scan visibility

Response: {"uuid": "...", "result": "https://urlscan.io/result/UUID/", "api": "..."}

Get Result

GET /result/{uuid}/

Returns 404 while scanning, 200 when complete.

GET /search/?q=domain:example.com&size=100

Query fields: domain:, ip:, server:, country:, filename:, hash:

Result Structure

Field Description
page.url Final URL after redirects
page.domain Domain name
page.ip Resolved IP
page.country Server country
page.status HTTP status code
page.title Page title
page.server Server header
page.tlsIssuer TLS certificate issuer
verdicts.overall.malicious Boolean malicious verdict
verdicts.overall.score Risk score (0-100)
lists.ips List of contacted IPs
lists.certificates TLS certificates observed
stats.resourceStats Resource type statistics

Screenshot

GET /screenshots/{uuid}.png

DOM Snapshot

GET /dom/{uuid}/

Rate Limits

  • Free: 100 scans/day, 1000 searches/day
  • Paid: Higher limits per plan