Version 1.3.6

- Improved storage of Constants
- Updated README.md
- Updated XML documentation fields and formatting
- Added a new option to Search()
- Implemented proper zero similar results handling
- Other minor changes

Author: akacdev

README.md

@@ -119,7 +119,7 @@ await client.AddVerdict(new VerdictParameters()
 - Task\<Result> **GetResult**(string uuid)
 - Task\<Result> **Poll**(string uuid, int delay = 5000, int interval = 2000)
 - Task\<Result> **Poll**(Submission submission, int delay = 5000, int interval = 2000)
-- Task\<SearchResult[]> **Search**(string query, int amount = 100)
+- Task\<SearchItem[]> **Search**(string query, int amount = 100, string targetScan = null)
 - Task\<SimilarScan[]> **GetSimilarScans**(string uuid)
 - Task\<Stats> **GetStats**()
 - Task\<Stream> **DownloadScreenshotStream**(string uuid)

Urlscan/Constants.cs

@@ -6,20 +6,22 @@ namespace Urlscan
 {
     internal class Constants
     {
-        /// <summary>
-        /// The API version to use when communicating.
-        /// </summary>
         public const int Version = 1;
-
+        public static readonly Uri BaseUri = new("https://urlscan.io/");
         public static readonly Version HttpVersion = new(2, 0);
-        public static readonly TimeSpan Timeout = TimeSpan.FromSeconds(30);
 
         public const string UserAgent = "Urlscan C# Client - actually-akac/Urlscan";
+        public const string LiveUserAgent = "Urlscan C# Live Client - actually-akac/Urlscan";
+
+        public const string AcceptedEncoding = "gzip, deflate, br";
         public const string JsonContentType = "application/json";
         public const string HtmlContentType = "text/html";
+
         public const int ErrorStatusCode = 500;
+        public const int MaxPollingRetries = 20;
 
         public const string SuccessSubmissionMessage = "Submission successful";
+        public const string ZeroSimilarHitsMessage = "0 structurally similar hits on different domains, IPs and ASNs";
 
         public static readonly JsonSerializerOptions JsonOptions = new()
         {

Urlscan/Extensions.cs

@@ -1,5 +1,8 @@
 using System;
+using System.IO;
 using System.Linq;
+using System.Net.Http;
+using System.Threading.Tasks;
 
 namespace Urlscan
 {

Urlscan/Live.cs

@@ -22,8 +22,7 @@ public class LiveClient
 
         private readonly HttpClient Client = new(HttpHandler)
         {
-            BaseAddress = UrlscanClient.BaseUri,
-            Timeout = Constants.Timeout,
+            BaseAddress = Constants.BaseUri,
             DefaultRequestVersion = Constants.HttpVersion
         };
 
@@ -60,9 +59,9 @@ public LiveClient(int interval = 30000, int size = 100)
             Size = size;
             Seen = new(Size);
 
-            Client.DefaultRequestHeaders.AcceptEncoding.ParseAdd("gzip, deflate, br");
-            Client.DefaultRequestHeaders.UserAgent.ParseAdd("Urlscan C# Live Client - actually-akac/Urlscan");
-            Client.DefaultRequestHeaders.Accept.ParseAdd("application/json");
+            Client.DefaultRequestHeaders.AcceptEncoding.ParseAdd(Constants.AcceptedEncoding);
+            Client.DefaultRequestHeaders.UserAgent.ParseAdd(Constants.LiveUserAgent);
+            Client.DefaultRequestHeaders.Accept.ParseAdd(Constants.JsonContentType);
 
             Timer = new()
             {

Urlscan/README_NuGet.md Urlscan/NuGet.mdUrlscan/README_NuGet.md renamed to Urlscan/NuGet.md

@@ -2,7 +2,7 @@
 
 ![](https://raw.githubusercontent.com/actually-akac/Urlscan/master/Urlscan/icon.png)
 
-🔎 An async and lightweight C# library for interacting with the Urlscan API.
+### 🔎 An async and lightweight C# library for interacting with the Urlscan API.
 
 ## Usage
 Provides an easy interface for interacting with the Urlscan API.
@@ -115,7 +115,7 @@ await client.AddVerdict(new VerdictParameters()
 - Task\<Result> **GetResult**(string uuid)
 - Task\<Result> **Poll**(string uuid, int delay = 5000, int interval = 2000)
 - Task\<Result> **Poll**(Submission submission, int delay = 5000, int interval = 2000)
-- Task\<SearchResult[]> **Search**(string query, int amount = 100)
+- Task\<SearchItem[]> **Search**(string query, int amount = 100, string targetScan = null)
 - Task\<SimilarScan[]> **GetSimilarScans**(string uuid)
 - Task\<Stats> **GetStats**()
 - Task\<Stream> **DownloadScreenshotStream**(string uuid)