Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

Phish.AI API wrapper

Project description

https://img.shields.io/badge/License-MIT-blue.svg https://img.shields.io/badge/python-2.7%2B%203.5%2B-blue.svg

Summary

Official python API for Phish.AI public and private API to detect zero-day phishing websites

How it Works (TLDR)

Essentially we have a very big computer vision database of known websites and their legitimate domains. The API surf to a given website takes a screenshots of the website and then compare it with our database and if we detect that it is similar to a known website but hosted we classify it as malicious and classify the targeted brand (which website this site tries to mimic).

The Engine is in beta and doesn’t protect all brands yet. we make the database bigger every day, if you believe your brand is not in our database and you want us to crawl it, just drop me a line at yp@phish.ai

Privacy Policy

The full privacy policy is at: https://www.phish.ai/phish-ai-privacy-policy/. By using the Public API you agree to our Privacy Policy and allow us to share your submission with the security community. If you want a Private API Key please contact us at info@phish.ai.

Useful resources

Installation

$ pip install phish-ai-api

Usage

from __future__ import print_function
from phish_ai_api import API

ph = API(api_key='None or private api key you can request at info@phish.ai')
res = ph.scan_url('https://google.com')
print(res)
print(ph.get_report(res['scan_id']))

Output

{"scan_id": "pQz7bGMwxgzGboNyX8cy"}
{"domain": "google.com",
 "ip_address": "74.125.124.113",
 "iso_code": "US",
 "status": "completed",
 "target": "Google",
 "time": "2018-04-15T07:27:37.860Z",
 "title": "google",
 "tld": "com",
 "url": "http://google.com",
 "user_agent": "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) HeadlessChrome/67.0.3391.0 Safari/537.36",
 "user_email": "api",
 "verdict": "clean"}

Issues & Contributing

Found a Bug/Have a feature request feel free to open an Issue and we will look into it. Cheers.

Project details


Release history Release notifications

This version

1.7

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for phish-ai-api, version 1.7
Filename, size File type Python version Upload date Hashes
Filename, size phish_ai_api-1.7-py2.py3-none-any.whl (2.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size phish-ai-api-1.7.tar.gz (2.8 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page