IocLists 1.0.0

IocLists 📝

🛑 An async and lightweight C# library for interacting with the IOCLists.com API.

Usage

Provides an easy interface for interacting with the IOC Lists API.

To get started, add the library into your solution with either the NuGet Package Manager or the dotnet CLI.

dotnet add package IocLists

For the primary classes to become available, import the used namespace.

using IocLists;

An API key is required to interact with the API. Create your own key at: https://ioclists.com/r/settings

Need more examples? Under the Example directory you can find a working demo project that implements this library.

Features

• Built for .NET 6 and .NET 7
• Fully async
• Deep coverage of the API
• Extensive XML documentation
• No external dependencies (uses integrated HTTP and JSON)
• Custom exceptions (IocListsException) for advanced catching
• Example project to demonstrate all capabilities of the library
• Create and download IOC lists, add entries and search for existing indicators submitted by the community

Code Samples

Initializing a new API client

IocListsClient client = new("d7882f568163547fd5657586ee058f3a7945551745ce36c4bf706741e7907042");

Creating a new list

await client.CreateList("akac", "testing-list", "This is a list created using the C# IOC Lists library.");

Appending a new entry to a list

await client.Add("akac", "testing-list", "https://example[.]com -- Testing Indicator");

Get 20 recent entries in a list

Entry[] recent = await client.GetRecent("mirrors", "phishtank");

Download all unique entries in a list

string[] unique = await client.GetUnique("mirrors", "phishtank");

Search for indicators across the entire platform

Entry[] matches = await client.Search("62.216.168.7");

Available Methods

• Task Add(string username, string listName, string entry)
• Task CreateList(CreateListParameters parameters)
• Task CreateList(string username, string listName, string description, int hoursToExpire = 8766, FeedType feedType = FeedType.Security, bool isPrivate = false, bool isActive = true, bool isMirror = false, string mirrorOriginalUrl = null)
• Task<Entry[]> GetRecent(string username, string listName)
• Task<Entry[]> Search(string query)
• Task<string[]> GetUnique(string username, string listName)

Resources

• Website: https://ioclists.com
• Team: https://www.detectdd.com
• API: https://api.ioclists.com/
• Documentation: https://ioclists.com/doc

This is a community-ran library. Not affiliated with detectdd.