Urlscan 1.1.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package Urlscan --version 1.1.1                
NuGet\Install-Package Urlscan -Version 1.1.1                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Urlscan" Version="1.1.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Urlscan --version 1.1.1                
#r "nuget: Urlscan, 1.1.1"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install Urlscan as a Cake Addin
#addin nuget:?package=Urlscan&version=1.1.1

// Install Urlscan as a Cake Tool
#tool nuget:?package=Urlscan&version=1.1.1                

Urlscan

alternate text is missing from this package README image

🔎 A C# library for interacting with the Urlscan API.

Usage

This library can be downloaded as the package Urlscan. The main classes are UrlscanClient and LiveClient.

https://www.nuget.org/packages/Urlscan

Obtaining API keys

API keys can be created in the user section Settings & API

Security identifier SID cookies can be obtained from the cookie storage. Make sure to only copy the value, without the name!

Features

  • Fully async
  • Full coverage of the free API endpoints, including user-only routes
  • Scan suspicious URLs and verdict on them
  • Download screenshots and page DOMs
  • See finsished public scans in real time using LiveClient
  • Automatic ratelimit handling
  • Detailed documentation

Available methods

  • Task<Stats> GetStats()
  • Task<User> GetUserInfo()
  • Task<Submission> Scan(string url, string[] tags = null, string userAgent = null, string referer = null, bool overrideSafety = false, Visibility visibility = Visibility.Public, ScanCountry country = ScanCountry.Auto)
  • Task<Submission> Scan(ScanPayload payload)
  • Task<Result> Poll(Submission subm, int delay = 5000, int interval = 2000)
  • Task<Result> Poll(string uuid, int delay = 5000, int interval = 2000)
  • Task<Result> GetResult(string uuid)
  • Task<SearchResult[]> Search(string query, int amount = 100)
  • Task<byte[]> DownloadScreenshot(Result res)
  • Task<byte[]> DownloadScreenshot(string uuid)
  • Task<Stream> DownloadScreenshotStream(string uuid)
  • Task<string> DownloadDOM(Result res)
  • Task<string> DownloadDOM(string uuid)
  • Task<byte[]> Liveshot(string url, int width = 1280, int height = 1024)
  • Task<Stream> LiveshotStream(string url, int width = 1280, int height = 1024)
  • Task AddVerdict(Result result, VerdictScope scope, VerdictType type, string comment, string[] brands, ThreatType[] threats)
  • Task AddVerdict(VerdictPayload payload)
  • Task AddVerdict(string uuid, VerdictScope scope, string scopeValue, VerdictType type, string comment, string[] brands, ThreatType[] threats)

Available events

  • EventHandler<LiveScan> UrlScanned

https://urlscan.io https://twitter.com/urlscanio

Example

Under the Example folder you can find a demo application that works with the library.

Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net6.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.4.0 330 11/25/2023
1.3.7 426 12/18/2022
1.3.6 346 11/20/2022
1.3.5 370 11/17/2022
1.3.4 379 10/28/2022
1.3.3 417 10/25/2022
1.2.3 421 10/22/2022
1.2.2 416 10/22/2022
1.1.2 449 7/31/2022
1.1.1 453 7/18/2022
1.0.1 487 6/23/2022
1.0.0 437 6/22/2022