IPv4 information

Prev Next
GET /explore/ipv4/ipv4info/{ipv4}

Get IPv4 information.

Query Parameters:

  • ipv4 (string) (required) –

    • IPv4 address

  • explain =<0|1> (int) (optional) –

    • show details of data used to calculate the different scores in the response

      • 0 (default) - do not show details

      • 1 - show underlying data used to calculate scores

  • scan_data =<0|1> (int) (optional) –

    • show details of data collected from IPv4 scanning

      • 0 (default) - do not show details

      • 1 - show collected data

  • sparse = (string) (optional) –

    • return only specific information elements for this IPv4 address

    • asn - return AS Number for IPv4 address

    • asname - return AS Name for IPv4 address

    • sp_risk_score - return Silent Push Risk Score for IPv4 address

Request headers:

  • X-API-KEY - api-key

Example Request

https://api.silentpush.com/api/v1/merge-api/explore/ipv4/ipv4info/1.1.1.1

Example Response

{
"status_code": 200,
"error": null,
"response": {
    "ip2asn": [
            {
                "asn": 13335,
                "asn_allocation_age": 4099,
                "asn_allocation_date": 20100714,
                "asn_rank": 0,
                "asn_rank_score": 0,
                "asn_reputation": 0,
                "asn_reputation_score": 0,
                "asn_takedown_reputation": 0,
                "asn_takedown_reputation_score": 0,
                "asname": "CLOUDFLARENET, US",
                "benign_info": {
                    "actor": "",
                    "known_benign": false,
                    "tags": []
                },
                "date": 20211003,
                "density": 48531,
                "ip": "1.1.1.1",
                "ip_is_dsl_dynamic": false,
                "ip_is_dsl_dynamic_score": 0,
                "ip_is_tor_exit_node": false,
                "ip_location": {
                    "continent_code": "OC",
                    "continent_name": "Oceania",
                    "country_code": "AU",
                    "country_is_in_european_union": false,
                    "country_name": "Australia"
                },
                "ip_ptr": "one.one.one.one",
                "listing_score": 0,
                "malscore": 0,
                "sinkhole_info": {
                    "known_sinkhole_ip": false,
                    "tags": []
                },
                "sp_risk_score": 0,
                "subnet": "1.1.1.0/24",
                "subnet_allocation_age": 3706,
                "subnet_allocation_date": 20110811,
                "subnet_reputation": 0,
                "subnet_reputation_score": 0
            }
        ]
    }
}

Details for Scores

https://api.silentpush.com/api/v1/merge-api/explore/ipv4/ipv4info/96.43.250.251?explain=1
{
    "status_code": 200,
    "error": null,
    "response": {
        "ip2asn": [
            {
                "asn": 13614,
                "asn_allocation_age": 8117,
                "asn_allocation_date": 19990714,
                "asn_rank": 0,
                "asn_rank_score": 0,
                "asn_reputation": 13,
                "asn_reputation_explain": {
                    "ips_in_asn": 61696,
                    "ips_num_active": 2154,
                    "ips_num_listed": 1
                },
                "asn_reputation_score": 13,
                "asn_takedown_reputation": 0,
                "asn_takedown_reputation_explain": {},
                "asn_takedown_reputation_score": 0,
                "asname": "ALLWEST, US",
                "benign_info": {
                    "actor": "",
                    "known_benign": false,
                    "tags": []
                },
                "date": 20211003,
                "density": 0,
                "ip": "96.43.250.251",
                "ip_is_dsl_dynamic": false,
                "ip_is_dsl_dynamic_score": 0,
                "ip_is_tor_exit_node": false,
                "ip_location": {
                    "continent_code": "NA",
                    "continent_name": "North America",
                    "country_code": "US",
                    "country_is_in_european_union": false,
                    "country_name": "United States"
                },
                "ip_ptr": "d96-43-250-251.allwest.net",
                "listing_score": 100,
                "listing_score_explain": {
                    "listed_first": 20210701,
                    "listed_first_ago": 94,
                    "listed_recent": 20211003,
                    "listed_recent_ago": 0,
                    "listed_span": 94,
                    "listings_all": 93,
                    "listings_last_180": 93,
                    "listings_last_30": 29,
                    "listings_last_365": 93,
                    "listings_last_7": 7,
                    "listings_last_90": 88
                },
                "malscore": 0,
                "sinkhole_info": {
                    "known_sinkhole_ip": false,
                    "tags": []
                },
                "sp_risk_score": 100,
                "sp_risk_score_explain": {
                    "sp_risk_score_decider": "listing_score"
                },
                "subnet": "96.43.248.0/21",
                "subnet_allocation_age": "UNKNOWN",
                "subnet_allocation_date": "UNKNOWN",
                "subnet_reputation": 38,
                "subnet_reputation_explain": {
                    "ips_in_subnet": 2048,
                    "ips_num_active": 13,
                    "ips_num_listed": 1
                },
                "subnet_reputation_score": 38
            }
        ]
    }
}

Data Collected from IPv4 Scanning

https://api.silentpush.com/api/v1/merge-api/explore/ipv4/ipv4info/1.1.1.1?scan_data=1
{
    "status_code": 200,
    "error": null,
    "response": {
        "ip2asn": [
            {
                "asn": 13335,
                "asn_allocation_age": 4291,
                "asn_allocation_date": 20100714,
                "asn_rank": 0,
                "asn_rank_score": 0,
                "asn_reputation": 0,
                "asn_reputation_score": 0,
                "asn_takedown_reputation": 0,
                "asn_takedown_reputation_score": 0,
                "asname": "CLOUDFLARENET, US",
                "benign_info": {
                    "actor": "Cloudflare",
                    "known_benign": true,
                    "tags": [
                        "Cloudflare DNS"
                    ]
                },
                "date": 20220413,
                "density": 57807,
                "ip": "1.1.1.1",
                "ip_is_dsl_dynamic": false,
                "ip_is_dsl_dynamic_score": 0,
                "ip_is_tor_exit_node": false,
                "ip_location": {
                    "continent_code": "OC",
                    "continent_name": "Oceania",
                    "country_code": "AU",
                    "country_is_in_european_union": false,
                    "country_name": "Australia"
                },
                "ip_ptr": "one.one.one.one",
                "listing_score": 0,
                "malscore": 0,
                "scan_data": {
                    "certificates": [
                        {
                            "fingerprint_sha1": "099d03214d1414a5325db61090e73ddb94f37d72",
                            "scan_date": 20220401
                        }
                    ],
                    "jarm": [
                        {
                            "first_seen": 20220120,
                            "jarm_hash": "27d3ed3ed0003ed1dc42d43d00041d6183ff1bfae51ebd88d70384363d525c",
                            "last_seen": 20220411,
                            "server_banner": "cloudflare"
                        }
                    ]
                },
                "sinkhole_info": {
                    "known_sinkhole_ip": false,
                    "tags": []
                },
                "sp_risk_score": 0,
                "subnet": "1.1.1.0/24",
                "subnet_allocation_age": 3898,
                "subnet_allocation_date": 20110811,
                "subnet_reputation": 0,
                "subnet_reputation_score": 0
            }
        ]
    }
}

Silent Push Risk Score for IPv4 Address

https://api.silentpush.com/api/v1/merge-api/explore/ipv4/ipv4info/96.43.250.251?sparse=sp_risk_score
{
    "status_code": 200,
    "error": null,
    "response": {
        "ip2asn": [
            {
                "ip": "96.43.250.251",
                "sp_risk_score": 100
            }
        ]
    }
}