Spamhaus Technology and abuse.ch Logo

Frequently
Asked
Questions

Frequently asked questions about our solutions and data. If you can’t find what you’re looking for, get in touch below - we’re happy to help.

FAQs | Spamhaus Intelligence API


Spamhaus Intelligence API
  • Are domains categorized as phishing, malicious, or malware, or do you only allocate a score?

    Yes. In addition to the reputation score, relevant domains may be categorized with one of the following tags: “abused,” “adware,” “botnet,” “botnetcc,” “cdn,” or “compromised.”

    You can find more information here: https://docs.spamhaus.com/sia/docs/source/10-API-Interface/310-Domains.html#tag-list.

  • Does a reputation score of 0 mean a domain is neutral?

    Yes, the domain is rated as neutral.

  • Do you get denied access to the Intelligence API after the query limit has been reached?

    There are two query limits: Soft and hard. The soft limit will generate a warning email. The hard limit will prevent access. Further information can be found in our technical documentation.

  • How can you track query volumes in the Intelligence API?

    This is done via an API call as detailed in our technical documentation.

  • How do I access the beta Domain Reputation Dataset via the Intelligence API?

    Update: We are no longer accepting applications for the beta Domain Reputation Dataset.

    Apply to access the beta domain data via this form.

    One of our team will be in touch to set up your access. Once you’ve received confirmation that access has been enabled, you can log into the customer portal and create a user profile.

  • How low can a reputation score be?

    There is no limit. However, +/—50 would indicate a very good/bad reputation.

  • Is a domain with a reputation score of -50 or 50 considered malicious or non-malicious?

    No. The score is based on a summary of IOCs and signals and is a measure of reputation, not maliciousness.

    Therefore, a score of -50 indicates that a domain has a very poor reputation. The reason that reputation is poor will depend on the IOCs and metadata associated with that entity. For example, it may be due to phishing if the metadata collected implies this.

    Poor reputation can also be achieved by association, e.g., with negatively rated domains, ASNs, registries, etc. Again, these are signals rather than conclusions of malicious activity.

    It’s also important to note that not all entities will have IOCs from the same sources. For example, a reputation score of 10 from the dimension “human (research)” is proportional with what we know when we allocate the score based on available sources. If another domain has a score of 10, but this time from the “identity” dimension, it will be in line with what we know at the time, based on the sources we have. i.e., it is not meant to be conclusive evidence of good or bad.

  • Is the Intelligence API a monthly or yearly subscription?

    It is a yearly subscription.

  • Is the Intelligence API a stand-alone product or does it require in-house development?

    Customers will be able to plug the Intelligence API into a SIEM device, however, they will need to develop a connector of some type unless the SIEM can make API calls natively.

  • Is there a threshold for classifying domains as malicious or non-malicious with a 99% certainty to reduce false positives?

    For email, a reputation score of -5 would mean a domain is listed, and when used by organizations that filter and block email, this domain would be blocked.

    However, in cybersecurity, you are dealing with levels of risk. As the reputation score is unrelated to whether the domain is benign, suspicious or malicious, it is more difficult to allocate a score threshold related to definitions or grades of maliciousness. You would need at least two fields to get a maliciousness score – for example, the reputation score and a tag associated with malicious behavior.

    Here is an example:

    Domain: example.com

    Score: -6

    Tags: malware

    A score of -6 is not automatically malicious. A tag of “malware” does not necessarily mean it’s malicious either, as many large service providers have tags such as “malware” or “phishing” associated with their domain. At a minimum, you would need both fields to determine, within your own business, a threshold score defining malicious domains while minimizing false positives.

  • What datafeeds are available through the Spamhaus Intelligence API?

    The following data is included:

    • Botnet C2 IPs (Botnet Controller List)
    • Compromised IPs (Exploits Blocklist)
    • *Domain Intel (Domain Blocklist (Context))
    • Email Spam IPs (CSS Blocklist)
    • Zero reputation domains (Zero Reputation Domains)

    However, there are plans to introduce additional datasets soon.

  • What data is available from abuse.ch via Spamhaus’ Intelligence API?

    URLhaus data is no longer available through the Intelligence API, but can be access via the commercial abuse.ch API or abuse.ch Real-Time Feed.

  • What datasets are available through the Intelligence API?

    The following datasets are available:

    • Botnet C2 IPs (Botnet Controller List - BCL)
    • Compromised IPs (Exploits Blocklist - XBL)
    • Domain Intel (Domain dataset
    • Email Spam IPs (Combined Spam Sources - CSS)
  • What does it mean if you receive a “404 Client Error” message when querying a domain?

    If a domain is not in our database, you will receive a 404 error. Please be aware that the Intelligence API also does not accept subdomains and will return a 404 error.

  • What does it mean if you receive a “404 Client Error” message when querying a domain?

    If a domain is not in our database, you will receive a 404 error. Please be aware that the Intelligence API also does not accept subdomains and will return a 404 error.

  • What ranges can be queried in the Intelligence API?

    Only CIDR formats up to /24 can queried in the Intelligence API.

  • What ranges can be queried in the Spamhaus Intelligence API?

    Only CIDR formats up to /24 can queried in SIA.

  • Where does Intelligence API obtain its data?

    The data comes from intelligence gathered through a global network of probes, honeypots, and spam traps, as well as trusted data shared by hosting providers, ISPs, internet governing bodies, and other industry partners.

    Using a combination of machine learning, heuristics, and manual investigations, Spamhaus’ dedicated team of researchers analyze this data, to identify malicious behavior to deliver high-confidence signal through the API.

    This data is deduped and false positives are removed before assembling production data.

  • Where is the data coming from in the Spamhaus Intelligence API?

    The datasets accessed via the API are built from our broad-reaching sensor network, the same that is used to compile our DNS Blocklists. Through machine learning, heuristics and manual investigation connections are analyzed to identify indicators of compromise.

  • Who can use the Intelligence API?

    The API has multiple applications across many specialist areas. Here are some examples of how different users can benefit:

    Threat analysts – increase your understanding of security events and alerts relating to IPs and domains to more effectively prioritize and report.

    Product Managers – enhance existing data pools to provide additional validation points to increase customer confidence in vulnerabilities and threats.

    Email Service Providers – keep your network clean by using this data to perform in-depth vetting of potential customers. Build a comprehensive picture with a vast number of domain and IP signals.

    A free six-month Developer License is also available, giving you limited access to the data to explore its potential.

Need Help?
Get in touch

0

Spamhaus is committed to protecting and respecting your privacy. We’ll only use your personal information to respond to your enquiry, manage any accounts you may set-up, and to provide the products and services you request from us. From time to time, we would like to contact you about our products and services, as well as other security related content that may be of interest to you. If you consent to us contacting you for this purpose, please tick the box below.

You can unsubscribe from these communications at any time. For more information on how to unsubscribe, our privacy practices, and how we are committed to protecting and respecting your privacy, please review our Privacy Notice.

By clicking submit below, you consent to allow Spamhaus to store and process the personal information submitted above to provide you the content requested.

I agree to receive other communications from Spamhaus.