Web Reputation API

Web Reputation API

Ensure user safety with a large database of domains and e-mail addresses to stop dangerous and malicious content.

Web Reputation API

asdasd


GET/web-reputation/domain?domain=:key

Get Domain Status

This endpoint returns the status of a domain.

Required attributes

  • Name
    domain
    Type
    string[]
    Description

    The domain to check.

    Providing this parameter multiple times will check multiple domains at once. The maximum number of domains that can be checked at once is 5.

Request

GET
/web-reputation/domain?domain=:key
curl https://api.gigadrive.network/web-reputation/domain?domain=google.com&domain=facebook.com&domain=gigadrive.network

Response (HTTP 200)

[
    {
        "domain": "google.com",
        "status": "neutral",
        "withholdingRecommended": false,
        "isMxRecordAvailable": true
    },
    {
        "domain": "gigadrive.network",
        "status": "neutral",
        "withholdingRecommended": false,
        "isMxRecordAvailable": false
    },
    {
        "domain": "facebook.com",
        "status": "neutral",
        "withholdingRecommended": false,
        "isMxRecordAvailable": true
    }
]

GET/web-reputation/email

Get Email Domain Status

This endpoint returns the status of an email address.

Required attributes

  • Name
    email
    Type
    string[]
    Description

    The email address to check.

    Providing this parameter multiple times will check multiple email addresses at once. The maximum number of email addresses that can be checked at once is 5.

Request

GET
/web-reputation/email?email=:key
curl https://api.gigadrive.network/web-reputation/email?email=support@gigadrivegroup.com&email=support@google.com

Response (HTTP 200)

[
    {
        "email": "support@gigadrivegroup.com",
        "role": false,
        "domain": {
            "domain": "gigadrivegroup.com",
            "status": "neutral",
            "withholdingRecommended": false,
            "mxRecordAvailable": true
        },
        "validations": {
            "valid": true,
            "validators": {
                "regex": {
                    "valid": true
                },
                "typo": {
                    "valid": true
                },
                "mx": {
                    "valid": true
                }
            }
        }
    },
    {
        "email": "support@google.com",
        "role": false,
        "domain": {
            "domain": "google.com",
            "status": "neutral",
            "withholdingRecommended": false,
            "mxRecordAvailable": true
        },
        "validations": {
            "valid": true,
            "validators": {
                "regex": {
                    "valid": true
                },
                "typo": {
                    "valid": true
                },
                "mx": {
                    "valid": true
                }
            }
        }
    }
]

Domain Statuses

Domains will be classified into different statuses based on the risk level of the domain. The status of a domain is determined by the risk level of the domain and the risk level of the domain's subdomains.

The following table lists the risk levels and their corresponding status.

Identifier Description
neutral

This is the default status for domains that are not in the database.

adult_content

This status is assigned to domains that are known to host adult content that is not safe for work or for children.

phishing

This status is assigned to domains that are known to host phishing sites. Phishing sites are sites that are designed to trick users into providing sensitive information such as passwords, credit card numbers, and social security numbers.

spam

This status is assigned to domains that are known to host spam sites. Spam sites are sites that are designed to send spam emails. These sites are often used to send spam emails to users who have not opted in to receive emails from the site.

This status is also assigned to domains that are used for sending spam emails to a large number of people.

disposable_email

This status is assigned to domains that are known to host disposable email sites. Disposable email sites are sites that are designed to provide temporary email addresses that are used to sign up for services that require an email address.

These sites are often used to sign up for services that require an email address, but do not require the user to verify their email address. As they are designed to be disposable, they will no longer be valid after a short period of time. As such, it is generally not safe to accept users with email addresses from domains in this category.

relay_email

This status is assigned to domains that are known to host relay email sites. Relay email sites are different from domains in the disposable_email category.

These services are designed to hide the true email address of a user, but still forward emails to the user's real email address. It is generally safe to accept users with email addresses from domains in this category.

piracy

This status is assigned to domains that are known to host piracy sites. Piracy sites are sites that are designed to host pirated content such as movies, music, and software.

malware

This status is assigned to domains that are known to host malware sites. Malware sites are sites that are designed to host malware such as viruses, trojans, and spyware.

tracker

This status is assigned to domains that are known to host tracker sites. Tracker sites are sites that are designed to track users across the web and used to aggregate data about users, usually for advertising or marketing purposes.

squat

This status is assigned to domains that are known to host squat sites. Squat sites are sites that are designed to mimic the look and feel of a legitimate site in order to trick users into providing sensitive information such as passwords, credit card numbers, and social security numbers. This is often also done through "typo squatting", where the domain name is similar to the legitimate domain name, but with a small, usually unnoticeable difference.