urlscan.io Blog

We are excited to announce new releases of our official CLI and Python library. These updates bring new features and improvements to help you integrate urlscan.io into your workflows more effectively.

urlscan-cli

We have released a new version of urlscan-cli, our official command-line tool for interacting with the urlscan platform.

What’s New

Support for more Pro API endpoints as sub-commands:

$ urlscan pro
Pro sub-commands

Usage:
  urlscan pro [command]

Available Commands:
  brand            Brand sub-commands
  channel          Channel sub-commands
  datadump         Data dump sub-commands
  file             Download a file
  hostname         Get the historical observations for a specific hostname in the hostname data source
  incident         Incident sub-commands
  livescan         Livescan sub-commands
  saved-search     Saved search sub-commands
  structure-search Get structurally similar results to a specific scan
  subscription     Subscription sub-commands

Flags:
  -h, --help   help for pro

Use "urlscan pro [command] --help" for more information about a command.

For example:

# get hostname history (ref. https://docs.urlscan.io/apis/urlscan-openapi/hostnames/hostnamehistory)
$ urlscan pro hostname <hostname>
# download a file (ref. https://docs.urlscan.io/apis/urlscan-openapi/files)
$ urlscan pro file <file-hash>

Installation

To upgrade to the latest version:

# macOS (Homebrew)
brew upgrade urlscan/tap/urlscan-cli

# Or download the latest release from GitHub
https://github.com/urlscan/urlscan-cli/releases

For more details, please refer to the urlscan-cli documentation.

urlscan-python

We have also released a new version of urlscan-python.

What’s New

The python library now supports all the pro API endpoints. For example:

import datetime
import os

from urlscan import Pro

with Pro(api_key="<your_api_key>") as pro:
    # iterate over hostname history
    it = pro.hostname("<hostname>", limit=100)
    for result in it:
        print(result)

    # download a file
    with open("downloaded_file", "wb") as file:
        pro.download_file("<file-hash>", file=file)

Installation

To upgrade to the latest version:

pip install --upgrade urlscan-python

For more details, please refer to the official documentation.

Feedback and Support

We would love to get your feedback on these updates. For any suggestions about improvements or further functionality as well as general support and bug reporting, please open a GitHub issue in the respective repositories or reach out to our support team at support@urlscan.io.

More on urlscan Pro

If you want to learn about the urlscan Pro platform and how it might be valuable for your organization feel free to reach out to us! We offer free trials with no strings attached. We would be happy to give you a passionate demo of what our platform can do for you. Reach out to us at sales@urlscan.io.