{"id":28549693,"url":"https://github.com/akacdev/phishreport","last_synced_at":"2025-07-04T22:31:36.193Z","repository":{"id":60794239,"uuid":"545641560","full_name":"akacdev/PhishReport","owner":"akacdev","description":"An async C# library for interacting with the Phish.Report, Indicator of Kit and detection beta APIs.","archived":false,"fork":false,"pushed_at":"2023-11-25T18:19:52.000Z","size":91,"stargazers_count":10,"open_issues_count":0,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-10T02:11:55.778Z","etag":null,"topics":["abuse","cybersec","ioc","phish","phish-report","phishing","phishreport","report","reporting","smishing","whaling"],"latest_commit_sha":null,"homepage":"https://www.nuget.org/packages/PhishReport","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/akacdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-04T18:23:25.000Z","updated_at":"2025-02-26T01:56:49.000Z","dependencies_parsed_at":"2024-07-14T13:51:35.665Z","dependency_job_id":null,"html_url":"https://github.com/akacdev/PhishReport","commit_stats":null,"previous_names":["akacdev/phishreport","actually-akac/phishreport"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/akacdev/PhishReport","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akacdev%2FPhishReport","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akacdev%2FPhishReport/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akacdev%2FPhishReport/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akacdev%2FPhishReport/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/akacdev","download_url":"https://codeload.github.com/akacdev/PhishReport/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/akacdev%2FPhishReport/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263627939,"owners_count":23490875,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["abuse","cybersec","ioc","phish","phish-report","phishing","phishreport","report","reporting","smishing","whaling"],"created_at":"2025-06-10T02:11:53.858Z","updated_at":"2025-07-04T22:31:36.182Z","avatar_url":"https://github.com/akacdev.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"﻿# Phish.Report 🎣\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg width=\"256\" height=\"256\" src=\"https://raw.githubusercontent.com/actually-akac/PhishReport/master/PhishReport/icon.png\"\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  An async C# library for interacting with the Phish.Report, Indicator of Kit and detection beta APIs.\n\u003c/div\u003e\n\n**Warning**\n\n\u003e The Phish.Report API is still under development, so in the event that you start experiencing unexpected errors, first check if there's an update available or raise an issue in this repository.\n\n## Usage\nThis library provides an easy interface for interacting with the Phish.Report APIs. You can create and track phishing takedowns and work with the [Indicator of Kit (IOK)](https://phish.report/IOK) platform.\n\nAPI keys are required to use the API. Create one at: https://phish.report/user\n\nTo get started, import the library into your solution with either the `NuGet Package Manager` or the `dotnet` CLI.\n```rust\ndotnet add package PhishReport\n```\n\nFor the primary classes to become available, import the used namespace.\n```csharp\nusing PhishReport;\n```\n\nNeed more examples? Under the `Example` directory you can find a working demo project that implements this library.\n\n## Properties\n- Built for **.NET 8**, **.NET 7** and **.NET 6**\n- Fully **async**\n- Coverage of the current **beta API**\n- Extensive **XML documentation**\n- **No external dependencies** (makes use of built-in `HttpClient` and `JsonSerializer`)\n- **Custom exceptions** (`PhishReportException`) for easy debugging\n- Example project to demonstrate all capabilities of the library\n\n## Features\n- Create phishing takedowns\n- Fetch existing reported cases\n- Evaluate Urlscan results for [Indicator of Kit](https://phish.report/IOK/) matches\n\n## Code Samples\n\n### Initializing a new API client\n```csharp\nPhishReportClient phish = new(\"API KEY\");\n```\n\n### Creating a new phishing takedown\n```csharp\nPhishingTakedown takedown1 = await phish.CreateTakedown(\"https://alpsautorepairv.ml/?gclid=EAIaIQobChMIsfmc__Ds-wIVSOHICh3oGwtsEAAYASAAEgIxmPD_BwE\");\n```\n\n### Retrieving an existing phishing takedown by its ID\n```csharp\nPhishingTakedown takedown2 = await phish.GetTakedown(\"case_4ExZCRk3PAh\");\n```\n\n### Retrieving the latest [Indicator of Kit](https://phish.report/IOK/) matches\n```csharp\nIokMatch[] matches = await phish.GetIokMatches();\n```\n\n### Processing [Indicator of Kit](https://phish.report/IOK/) matches in real time\n```csharp\nphish.IokMatched += (sender, match) =\u003e\n{\n\tConsole.WriteLine($\"{match.IndicatorId} match on {match.Url}, source: https://urlscan.io/result/{match.UrlscanUUID}/\");\n};\n```\n\n## Resources\n- Website: https://phish.report\n- Documentation: https://phish.report/docs\n- Indicator of Kit: https://phish.report/IOK/, https://github.com/phish-report/IOK\n\n*This is a community-ran library. Not affiliated with Phish Report Ltd.*","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakacdev%2Fphishreport","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fakacdev%2Fphishreport","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fakacdev%2Fphishreport/lists"}