########### Reputation ########### ********************* Reputation endpoints ********************* These endpoints return reputation information ranked ASN takedown reputation =============================== .. http:get:: /explore/takedownreputation/rank :noindex: List ASNs with the highest takedown reputation :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/takedownreputation/rank?limit=3&explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "takedown_reputation_rank": [ { "asn": 395082, "asn_allocation_age": 1916, "asn_allocation_date": 20160411, "asn_takedown_reputation": 100, "asn_takedown_reputation_explain": { "ips_in_asn": 512, "ips_num_listed": 1, "items_num_listed": 170, "listings_max_age": 227 }, "asname": "BODIS-NJ, US" }, { "asn": 56088, "asn_allocation_age": 3799, "asn_allocation_date": 20110214, "asn_takedown_reputation": 99, "asn_takedown_reputation_explain": { "ips_in_asn": 256, "ips_num_listed": 1, "items_num_listed": 55, "listings_max_age": 605 }, "asname": "PANDI-ID PANDI - Pengelola Nama Domain Internet Indonesia, I" }, { "asn": 204915, "asn_allocation_age": 1311, "asn_allocation_date": 20171207, "asn_takedown_reputation": 98, "asn_takedown_reputation_explain": { "ips_in_asn": 768, "ips_num_listed": 19, "items_num_listed": 36, "listings_max_age": 1016 }, "asname": "AWEX, CY" } ] } } ASN takedown reputation ============================= .. http:get:: /explore/takedownreputation/asn/{asn} :noindex: Get takedown reputation for ASN :query *required* **asn** (*int*): * AS number :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/takedownreputation/asn/13335?explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "takedown_reputation": { "asn": 13335, "asn_allocation_age": 4014, "asn_allocation_date": 20100714, "asn_takedown_reputation": 0, "asn_takedown_reputation_explain": { "ips_in_asn": 2307840, "ips_num_listed": 902, "items_num_listed": 2448, "listings_max_age": 1853 }, "asname": "CLOUDFLARENET, US" } } } ASN takedown reputation history =============================== .. http:get:: /explore/takedownreputation/history/asn/{asn} :noindex: Get takedown reputation history for ASN :query *required* **asn** (*int*): * AS number :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/takedownreputation/history/asn/56088?limit=3&explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "takedown_reputation_history": [ { "asn": 56088, "asn_takedown_reputation": 99, "asn_takedown_reputation_explain": { "ips_in_asn": 256, "ips_num_listed": 1, "items_num_listed": 55, "listings_max_age": 605 }, "date": 20210710 }, { "asn": 56088, "asn_takedown_reputation": 99, "asn_takedown_reputation_explain": { "ips_in_asn": 256, "ips_num_listed": 1, "items_num_listed": 54, "listings_max_age": 604 }, "date": 20210709 }, { "asn": 56088, "asn_takedown_reputation": 99, "asn_takedown_reputation_explain": { "ips_in_asn": 256, "ips_num_listed": 1, "items_num_listed": 54, "listings_max_age": 603 }, "date": 20210708 } ] } } ranked name server reputation =============================== .. http:get:: /explore/nsreputation/rank :noindex: List name servers with the highest reputation scores :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/nsreputation/rank?limit=3&explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "ns_server_reputation_rank": [ { "date": 20210709, "ns_server": "a.dns-servers.net.ru", "ns_server_reputation": 100, "ns_server_reputation_explain": { "ns_server_domain_density": 3, "ns_server_domains_listed": 3 } }, { "date": 20210709, "ns_server": "b.dns-servers.net.ru", "ns_server_reputation": 100, "ns_server_reputation_explain": { "ns_server_domain_density": 3, "ns_server_domains_listed": 3 } }, { "date": 20210709, "ns_server": "d.dns-servers.net.ru", "ns_server_reputation": 100, "ns_server_reputation_explain": { "ns_server_domain_density": 3, "ns_server_domains_listed": 3 } } ] } } name server reputation =============================== .. http:get:: /explore/nsreputation/nameserver/{nameserver} :noindex: Get name server reputation :query *required* **nameserver** (*string*): * name server name :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/nsreputation/nameserver/a.dns-servers.net.ru?explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "ns_server_reputation": [ { "date": 20210709, "ns_server": "a.dns-servers.net.ru", "ns_server_reputation": 100, "ns_server_reputation_explain": { "ns_server_domain_density": 3, "ns_server_domains_listed": 3 } } ] } } name server reputation history =============================== .. http:get:: /explore/nsreputation/history/nameserver/{nameserver} :noindex: Get name server reputation history :query *required* **nameserver** (*string*): * name server name :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/nsreputation/history/nameserver/a.dns-servers.net.ru?explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "ns_server_reputation_history": [ { "date": 20210709, "ns_server": "a.dns-servers.net.ru", "ns_server_reputation": 100, "ns_server_reputation_explain": { "ns_server_domain_density": 3, "ns_server_domains_listed": 3 } }, { "date": 20210708, "ns_server": "a.dns-servers.net.ru", "ns_server_reputation": 100, "ns_server_reputation_explain": { "ns_server_domain_density": 3, "ns_server_domains_listed": 3 } }, { "date": 20210707, "ns_server": "a.dns-servers.net.ru", "ns_server_reputation": 100, "ns_server_reputation_explain": { "ns_server_domain_density": 3, "ns_server_domains_listed": 3 } } ] } } name server listings =============================== .. http:get:: /explore/nameserverlisted :noindex: Name servers with the most blacklisted domains :query *optional* **limit** = (*int*): * number of results to return :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/nameserverlisted?limit=3 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "listed_on_nameserver": [ { "listed": 123, "ns_srv": "verify-contact-details.namecheap.com" }, { "listed": 123, "ns_srv": "failed-whois-verification.namecheap.com" }, { "listed": 77, "ns_srv": "dns2.registrar-servers.com" } ] } } ranked ASN reputation =============================== .. http:get:: /explore/ipreputation/rank/asn :noindex: List ASNs with the highest reputation scores :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/ipreputation/rank/asn?limit=3&explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "asn_reputation_rank": [ { "asn": 61911, "asn_allocation_age": 2698, "asn_allocation_date": 20140429, "asn_reputation": 100, "asn_reputation_explain": { "ips_in_asn": 2048, "ips_num_active": 4, "ips_num_listed": 8 }, "asname": "RIDERSON MENDES BORGES - ME, BR" }, { "asn": 44446, "asn_allocation_age": 406, "asn_allocation_date": 20200807, "asn_reputation": 100, "asn_reputation_explain": { "ips_in_asn": 768, "ips_num_active": 7, "ips_num_listed": 9 }, "asname": "SIBIRINVEST, NL" }, { "asn": 139535, "asn_allocation_age": "UNKNOWN", "asn_allocation_date": "UNKNOWN", "asn_reputation": 100, "asn_reputation_explain": { "ips_in_asn": 256, "ips_num_active": 2, "ips_num_listed": 2 }, "asname": "RAYFPL-AS Raycom Fibers Private Limited, IN" } ] } } ASN reputation =============================== .. http:get:: /explore/ipreputation/asn/{asn} :noindex: Get ASN reputation :query *required* **asn** (*int*): * AS number :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/ipreputation/asn/211298?explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "asn_reputation": [ { "asn": 211298, "asn_reputation": 100, "asn_reputation_explain": { "ips_in_asn": 256, "ips_num_active": 62, "ips_num_listed": 252 }, "asname": "CYBER-CASA, GB", "date": 20210916 } ] } } ASN reputation history =============================== .. http:get:: /explore/ipreputation/history/asn/{asn} :noindex: Get ASN reputation history :query *required* **asn** (*int*): * AS number :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/ipreputation/history/asn/211298?limit=3&explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "asn_reputation_history": [ { "asn": 211298, "asn_reputation": 100, "asn_reputation_explain": { "ips_in_asn": 256, "ips_num_active": 62, "ips_num_listed": 252 }, "asname": "CYBER-CASA, GB", "date": 20210916 }, { "asn": 211298, "asn_reputation": 100, "asn_reputation_explain": { "ips_in_asn": 256, "ips_num_active": 61, "ips_num_listed": 252 }, "asname": "CYBER-CASA, GB", "date": 20210915 }, { "asn": 211298, "asn_reputation": 100, "asn_reputation_explain": { "ips_in_asn": 256, "ips_num_active": 62, "ips_num_listed": 252 }, "asname": "CYBER-CASA, GB", "date": 20210914 } ] } } ranked subnet reputation =============================== .. http:get:: /explore/ipreputation/rank/subnet :noindex: List IPv4 subnets with the highest reputation scores :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/ipreputation/rank/subnet?limit=3&explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "subnet_reputation_rank": [ { "subnet": "103.119.107.0/24", "subnet_allocation_age": "UNKNOWN", "subnet_allocation_date": "UNKNOWN", "subnet_reputation": 100, "subnet_reputation_explain": { "ips_in_subnet": 256, "ips_num_active": 2, "ips_num_listed": 2 } }, { "subnet": "103.123.42.0/24", "subnet_allocation_age": "UNKNOWN", "subnet_allocation_date": "UNKNOWN", "subnet_reputation": 100, "subnet_reputation_explain": { "ips_in_subnet": 256, "ips_num_active": 2, "ips_num_listed": 3 } }, { "subnet": "103.123.43.0/24", "subnet_allocation_age": "UNKNOWN", "subnet_allocation_date": "UNKNOWN", "subnet_reputation": 100, "subnet_reputation_explain": { "ips_in_subnet": 256, "ips_num_active": 2, "ips_num_listed": 20 } } ] } } subnet reputation =============================== .. http:get:: /explore/ipreputation/subnet/{subnet}/{mask} :noindex: Get IPv4 subnet reputation :query *required* **subnet** (*string*): * IPv4 subnet :query *required* **mask** (*int*): * subnet mask :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/ipreputation/subnet/192.35.168.0/23?explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "subnet_reputation": [ { "date": 20210916, "subnet": "192.35.168.0/23", "subnet_reputation": 100, "subnet_reputation_explain": { "ips_in_subnet": 512, "ips_num_active": 45, "ips_num_listed": 144 } } ] } } subnet reputation history =============================== .. http:get:: /explore/ipreputation/history/subnet/{subnet}/{mask} :noindex: Get IPv4 subnet reputation history :query *required* **subnet** (*string*): * IPv4 subnet :query *required* **mask** (*int*): * subnet mask :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/ipreputation/history/subnet/192.35.168.0/23?limit=3&explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "subnet_reputation_history": [ { "date": 20210916, "subnet": "192.35.168.0/23", "subnet_reputation": 100, "subnet_reputation_explain": { "ips_in_subnet": 512, "ips_num_active": 45, "ips_num_listed": 144 } }, { "date": 20210915, "subnet": "192.35.168.0/23", "subnet_reputation": 100, "subnet_reputation_explain": { "ips_in_subnet": 512, "ips_num_active": 45, "ips_num_listed": 158 } }, { "date": 20210914, "subnet": "192.35.168.0/23", "subnet_reputation": 100, "subnet_reputation_explain": { "ips_in_subnet": 512, "ips_num_active": 45, "ips_num_listed": 144 } } ] } } IPv4 reputation =============================== .. http:get:: /explore/ipreputation/ipv4/{ipv4} :noindex: Get IPv4 address reputation :query *required* **ipv4** (*string*): * IPv4 address :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/ipreputation/ipv4/91.213.50.101?explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "ip_reputation": [ { "date": 20230315, "ip": "91.213.50.101", "ip_reputation": 31, "ip_reputation_explain": { "ip_density": 9, "names_num_listed": 2 } } ] } } IPv4 reputation history =============================== .. http:get:: /explore/ipreputation/history/ipv4/{ipv4} :noindex: Get IPv4 address reputation history :query *required* **ipv4** (*string*): * IPv4 address :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/ipreputation/history/ipv4/91.213.50.101?limit=3&explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "ip_reputation_history": [ { "date": 20230315, "ip": "91.213.50.101", "ip_reputation": 31, "ip_reputation_explain": { "ip_density": 9, "names_num_listed": 2 } }, { "date": 20230314, "ip": "91.213.50.101", "ip_reputation": 35, "ip_reputation_explain": { "ip_density": 7, "names_num_listed": 2 } }, { "date": 20230313, "ip": "91.213.50.101", "ip_reputation": 38, "ip_reputation_explain": { "ip_density": 6, "names_num_listed": 2 } } ] } } ranked IPv4 reputation =============================== .. http:get:: /explore/ipreputation/rank/ipv4 :noindex: List IPv4 addresses with the highest reputation scores :query *optional* **limit** = (*int*): * number of results to return :query *optional* **explain** =<0|1> (*int*): * show information used to calculate the reputation score * 0 = (default) do not show * 1 = show details :requestheader X-API-KEY: `api-key` **Example Request** .. sourcecode:: bash https://api.silentpush.com/api/v1/merge-api/explore/ipreputation/rank/ipv4?limit=3&explain=1 **Example Response** .. sourcecode:: json { "status_code": 200, "error": null, "response": { "ip_reputation_rank": [ { "ip": "1.116.74.169", "ip_reputation": 100, "ip_reputation_explain": { "ip_density": 1, "names_num_listed": 1 } }, { "ip": "1.161.36.35", "ip_reputation": 100, "ip_reputation_explain": { "ip_density": 1, "names_num_listed": 1 } }, { "ip": "100.25.214.104", "ip_reputation": 100, "ip_reputation_explain": { "ip_density": 1, "names_num_listed": 1 } } ] } }