Check Domain Details GET

Checks the supplied domain against our database and returns the details we have.

Request

What you send to the API.

Authentication

🔒 API Key: Required
🔑 API Permission Required: API.READ

Provide your API key in the Authorization header when making requests.

Example

"Authorization": "Bearer 04eff65e-309c-1a2b-cde3-4567f8901gh"

The URL for this endpoint is:

https://api.phisherman.gg/v1/domains/info/<domain>

<domain> is to be replaced with the domain you want to check.

Example: https://api.phisherman.gg/v1/domains/info/gimme-ur-money.scam

Examples

CURL

curl -L -X GET "https://api.phisherman.gg/v1/domains/info/gimme-ur-money.scam" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer <API-KEY>"

JavaScript

const response = await fetch("https://api.phisherman.gg/v1/domains/info/gimme-ur-money.scam", {
	headers: {
		"Content-Type": "application/json",
		Authorization: "Bearer <API-KEY>",
	},
});

const data = response.ok ? await response.json() : "Domain was not found or an error occurred.";

Python

import http.client

conn = http.client.HTTPSConnection("api.phisherman.gg")
payload = ''
headers = {
	'Content-Type': 'application/json',
	'Authorization': 'Bearer <API-KEY>'
}
conn.request("GET", "/v1/domains/info/gimme-ur-money.scam", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))

Response

What you get back from the API.

Example responses

HTTP 200

{
    "internetbadguys.com": {
        "status": "ONLINE",
        "created": "2021-10-31T14:39:24.000Z",
        "updated": "2023-11-20T22:44:26.000Z",
        "lastChecked": "2021-10-31T14:39:29.000Z",
        "verifiedPhish": false,
        "classification": "unknown",
        "firstSeen": "2021-11-26 01:14:42",
        "lastSeen": "2021-12-27 16:40:15",
        "targetedBrand": "Other",
        "phishCaught": 6,
        "registry": "arin",
        "details": {
            "urlScanId": "50c3429b-ee4d-452c-bad9-b4d5faaaffac",
            "websiteScreenshot": "https://urlscan.io/screenshots/50c3429b-ee4d-452c-bad9-b4d5faaaffac.png",
            "ip_address": "146.112.255.155",
            "asn": {
                "asn": "AS36692",
                "asn_name": "OPENDNS",
                "route": "146.112.255.0/24"
            },
            "country": {
                "code": "US",
                "name": "United States"
            }
        }
    }
}

HTTP 200 (Safe Domains)

{
    "discord.com": {
        "classification": "safe",
        "verifiedPhish": false
    }
}

HTTP 400

{
    "message": "Invalid domain.",
    "error": [
        {
            "code": "custom",
            "message": "'discord..com' is not a valid domain.",
            "path": []
        }
    ]
}

HTTP 404

{
    "discord2.com": {
        "classification": "unknown",
        "verifiedPhish": false
    }
}

Response Details

Name	Type	Description
status	string	The status of this website. (mostly for future use)
lastChecked	timestamp	The timestamp (in UTC) when this domain was last checked as being online
verifiedPhish	boolean	Wether this domain is verified as a phishing website
classification	string	The classification for this domain
created	timestamp	The timestamp (in UTC) when this was added to our database
firstSeen	timestamp	The timestamp (in UTC) when this domain was first reported as seen
lastSeen	timestamp	The timestamp (in UTC) when this domain was last reported as seen
targetedBrand	string	What brand or company this phish is aimed at
phishCaught	integer	The number of times this phish has been reported back to Phisherman as being caught
phishTankId	integer	The PhishTank ID for this domain, if applicable
urlScanId	string	The URLScan.io UUID for this domain, if applicable
websiteScreenshot	string	URL to a screenshot of this website, provided by either PhishTank or URLScan.io
ip_address	string	The IP address of this website
asn: asn	string	The ASN (Autonomous System Numbers) for this domain
asn: name	string	The human-readable name for this ASN (Autonomous System Number)
asn: route	string	The CIDR block for this domain
route	string	The CIDR Block for this website
registry	string	The regional internet registry for this domain
country: code	string	The ISO code for the country this domain is hosted in
country: name	string	The country this domain is hosted in

TIP

Please see the Domain Classifications page for information on each classification.