Skip to main contentSkip to footer
REST Threat Intelligence · Free tier

Public API

A REST API over the community reputation database. Check a single address, report an attacker, or pull the whole blacklist, from any stack in any language.

Free tier · 25,000 checks a day on PRO, 100,000 on Business

Why this exists

Your server already knows who is attacking it. What it does not know is whether that address attacked two hundred other sites this morning. One HTTPS call answers that, before you decide whether to let the request through.

REST Threat Intelligence · Free tier

What you get

  • 1,000 checks and 50 reports a day on the free tier, no card
  • 63 threat categories with decay-weighted confidence scoring
  • Bulk check and report plus analytics from Professional up
  • Your API key travels in one header, the answer comes back as JSON, rate limits are documented
  • Ready to use in SIEM enrichment, custom firewalls and your own ban scripts
  • Every response says what it cost you against the daily quota

Who it's for

Developers and ops teams putting reputation checks into tooling they already run.

Pricing

Free tier · 25,000 checks a day on PRO, 100,000 on Business

Check one address

curl
curl -H "X-Key: YOUR_API_KEY" \
     "https://reportedip.com/wp-json/reportedip/v2/check?ip=1.2.3.4&verbose=true"

The answer carries a confidence score from 0 to 100, the threat categories the address was reported under, and how many independent reporters saw it.

Frequently asked questions

Do I need an account?

Yes, a free one. The account gives you the access key; the key is what the quota is counted against. No card is involved at the free tier.

What happens when I hit the daily limit?

The API answers with HTTP 429 and tells you when the quota resets. Nothing is billed automatically and no request is silently dropped.

What runs on your servers?

The API, the blacklist feed and the DNS/RBL zone are hosted by us on EU infrastructure. The Hive plugin and the Honeypot Server run on yours.

How is the confidence score calculated?

Each report is weighted by recency, reporter diversity, threat severity and honeypot trust, then decayed over time. The full formula is documented.

How is this different from AbuseIPDB or Spamhaus?

Three concrete differences. First, ReportedIP is EU-hosted with explicit GDPR compliance and EU-only sub-processors, with a data-processing agreement on offer. Second, the scoring is fully transparent: add verbose=true to any check and you see every component of the confidence score, report count, diversity, recency, severity and honeypot bonus, rather than an opaque number. Third, the clients are open source where they can be: the WordPress plugin, the honeypot server and the DNS checker are GPL-2.0 and auditable on GitHub. Scoring is time-decayed on a 30-day half-life, so dormant attackers fall off automatically.

Where can I download the blacklist?

Plain-text and JSON exports are served from /wp-json/reportedip/v2/blacklist; add ?format=txt for one IP per line or ?format=csv for spreadsheets and SIEM imports. The same data is mirrored to Git at github.com/reportedip/reportedip-blacklist with a diff-friendly commit history, so you can track which IPs were added or removed each day and pin a revision for reproducible builds. Entries are scored by the same confidence engine as the API, so a single threshold keeps your block list current and low on false positives.

How do I integrate the API into my firewall or ban scripts?

Two paths, depending on how fresh you need the data. For broad coverage, pull the community blacklist feed directly, an hourly-refreshed text file you can drop into an ipset with a single cron job, no API key required. For per-IP scoring at the moment of a request, for example inside a ban action or a custom firewall rule, call the REST API with a free account (1,000 checks per day). The documentation has ready-to-run filter examples, an iptables ipset script and nginx and Postfix snippets. Most operators combine both: the feed for bulk blocking, the API for real-time decisions on traffic that is not yet on the list.

Can I contribute data without running a honeypot?

Yes. Any system can submit reports via POST /reportedip/v2/report with a free API key; an automated reporter running on your own server is exactly the kind of contribution the network is built on. Honeypot operators get a badge and their reports carry extra weight, because honeypot traffic is unsolicited and therefore high-signal, but you do not need one to take part. Reporter diversity is itself a scoring factor, so every independent source makes the whole dataset more reliable.

The other products

Same dataset, different shape.

Downloadable Feed · Free

Blacklist Feed

Community-driven blacklist, automatically scored from real-time reports. Plain text, JSON and CSV, ready for iptables, nftables, nginx or any blocklist consumer.

Live DNSBL Add-on · from PRO

DNS / RBL Zone

Ask a DNS question instead of downloading a list: your mail server looks the address up live, the same way it already queries Spamhaus. No imports, always fresh.

WordPress Plugin · Free

ReportedIP Hive

Real-time WordPress security with 16 detection sensors, a Web Application Firewall, four 2FA methods and an opt-in community threat network. Free and open source forever.

Linux Server Agent · for hosters and admins

ReportedIP Agent

One static binary that puts thousands of known attackers into your kernel firewall before they reach you, and watches every log your server already writes for the ones nobody has reported yet.

DNS Diagnostics · Free

DNS Checker

Domain health diagnostics from 76 resolvers across 6 continents. Validate SPF, DKIM, DMARC and DNSSEC, run DNSBL lookups and track propagation during migrations.

PTR Check · Free

Reverse DNS Lookup

Resolve the PTR record of an IPv4 or IPv6 address and check whether it resolves back. A PTR record nobody confirms is the most common reason a mail server is refused at the door.

Public API

Free tier · 25,000 checks a day on PRO, 100,000 on Business

Security Focused GDPR Compliant Made in Germany