v1/search/summary

This API provides a security summary for a specified domain, including SPF, DMARC configurations, and network and site information.

Request URL

curl -X GET "https://api.securitysurface.com/v1/search/summary?domain={domain}" \
-H "apikey: your_api_key" \
-H "Content-Type: application/json"

Replace {domain} with the domain you want to query, and your_api_key with your actual API key.

Request Parameters

Parameter Type Location Required Description
domain string query Yes The domain to query, e.g., example.com

Response Data 


                    {
    "status": "ss_success",
    "domain": "example.com",
    "summary": {
        "spf": {
            "raw": "v=spf1 -all\r\n",
            "data": [
                {
                    "qualifier": "- (Fail)",
                    "mechanism": "all\r\n",
                    "argument": "-"
                }
            ]
        },
        "dmarc": {
            "raw": "v=DMARC1;p=reject;sp=reject;adkim=s;aspf=s",
            "data": [
                {
                    "tag": "p=reject",
                    "field": "Defines the policy for handling emails that fail DMARC checks",
                    "value": "Reject the email outright"
                },
                {
                    "tag": "sp=reject",
                    "field": "Defines the policy for handling emails from subdomains that fail DMARC checks",
                    "value": "Reject the email outright"
                },
                {
                    "tag": "adkim=s",
                    "field": "Alignment mode for DKIM validation",
                    "value": "Strict alignment"
                },
                {
                    "tag": "aspf=s",
                    "field": "Alignment mode for SPF validation",
                    "value": "Strict alignment"
                }
            ]
        },
        "network": {
            "domain": "example.com",
            "ipv4": "23.192.228.80",
            "ipv4_autonomous_systems": "AS20940",
            "ipv6": "2600:1406:bc00:53::b81e:94ce",
            "ipv6_autonomous_systems": "AS20940",
            "country_flag": "https:\/\/ipgeolocation.io\/static\/flags\/us_64.png",
            "country_name": "United States of America",
            "state_prov": "California",
            "city": "San Jose",
            "isp": "Akamai Technologies, Inc.",
            "organization": "Akamai International B.V.",
            "asn": "AS20940",
            "ns": [
                "a.iana-servers.net",
                "b.iana-servers.net"
            ],
            "nameserver": "RESERVED-Internet Assigned Numbers Authority",
            "domain_registrar": "whois.iana.org",
            "registrar_url": "http:\/\/res-dom.iana.org"
        },
        "site": {
            "logo": "\/html\/images\/none.png",
            "socialmedia": {},
            "title": "Example Domain",
            "language": "en",
            "description": "",
            "latitude": "37.33865",
            "longitude": "-121.88542"
        }
    }
}