API
IP Reputation Checker API
The IP Reputation Checker API allows developers, security analysts, and businesses to instantly verify whether an IP address is safe or malicious. By classifying IPs into categories such as VPN, Proxy, Spam Source, Botnet, or Clean, this API provides the insights needed to block threats, detect fraud, and secure digital systems.
The API caters to a wide range of programming languages, including but not limited to: C, Clojure, C#, GO, Java, JavaScript, Kotlin, Node.js, Objective-C, OCaml, PHP, PowerShell, Python, R, RapidQL, Ruby, Shell, and Swift.
Introduction
API Overview
The API is designed for real-time IP intelligence. It processes IPv4 and IPv6 addresses and returns reputation details including:
Risk score (0–100)
Threat category (e.g., Botnet, Spam, Proxy, etc.)
Abuse reports & history
ISP, ASN, and geolocation
Usage type (Residential, Hosting, VPN, etc.)
Tor exit node detection
Integration is simple: just provide the IP address via GET or POST, and the API responds with a detailed JSON report.
Key Features:
Instant IP Analysis – Quickly assess if an IP is risky or safe
✅ Risk Scoring – Numeric score to guide automated blocking decisions
✅ Threat Categorization – Identifies botnets, proxies, spam sources, or clean IPs
✅ Abuse History Reports – Includes community-driven and historical abuse data
✅ ISP & Geo Data – Provides country, ISP, domain, and usage type
✅ IPv4 & IPv6 Support – Works seamlessly across modern networks
✅ Tor Detection – Flags traffic originating from the Tor network
Additional Highlights:
Security Integration Ready – Use it with firewalls, SIEM tools, fraud detection pipelines, and email filters.
🔹 Flexible Deployment – Works via GET and POST, making it compatible with web apps, mobile apps, and backend services.
🔹 Developer-Friendly – Clean JSON responses with clear risk categories.
🔹 RapidAPI Compatible – Easy authentication using the x-rapidapi-key
header.
🔹 Scalable for Business – Handle single lookups or integrate into large-scale enterprise security systems.
Endpoints
- /scan
Endpoints Overview
Analyze An IP Address
The IP Reputation Checker API helps developers, security teams, and businesses assess the trustworthiness of any IPv4/IPv6 address.
It classifies IPs into categories such as:
✅ Clean
🚫 VPN / Proxy
🛑 Spam Source
⚠️ Botnet / Malicious
Perfect for:
Login systems
Fraud detection
Firewalls
Email security
Web apps
Endpoint:
GET & POST: /scan
Parameters:
Name | Type | Required | Description |
---|---|---|---|
ip | String | ✅ Yes | IPv4 or IPv6 address to analyze. Example: 118.25.6.39 |
Python Requests Example:
import requests url = "https://ip-reputation-checker-api.p.rapidapi.com/scan" querystring = {"ip":"118.25.6.39"} headers = { "x-rapidapi-key": "YOUR_RAPIDAPI_KEY", "x-rapidapi-host": "ip-reputation-checker-api.p.rapidapi.com" } response = requests.get(url, headers=headers, params=querystring) print(response.json())
Response Example:
{ "success": true, "input": "118.25.6.39", "analysis": { "risk_score": 85, "category": "Botnet", "country": "CN", "isp": "Tencent Cloud Computing", "isPublic": true, "ipVersion": 4, "usageType": "Data Center/Web Hosting/Transit", "domain": "tencent.com", "isTor": false, "numDistinctUsers": 15, "totalReports": 48, "lastReportedAt": "2023-07-10T20:55:14+00:00", "reports": [ { "reportedAt": "2023-07-10T20:55:14+00:00", "comment": "SSH brute force attempt", "categories": [18, 22], "reporterId": 1, "reporterCountryCode": "US", "reporterCountryName": "United States" } ] } }
Subscribe to IP Reputation Checker API
Subscribe to IP Reputation Checker API
Subscribe to IP Reputation Checker API
Subscribe to IP Reputation Checker API
Subscribe on RapidAPI
Head over to our API listing on RapidAPI and click the “Subscribe” button. Choose a plan that fits your needs — from free testing to full-scale production.
Get Your API Key
Once subscribed, grab your unique X-RapidAPI-Key from the "Endpoints" tab. You’ll use this key to authenticate all your requests securely.
Start Making Requests
Use the provided code snippets or integrate directly into your app. Send requests to any available endpoint and enjoy seamless access to our powerful API features.

Frequently Asked Questions
What is an IP Reputation Checker API?
The IP Reputation Checker API is a security tool that helps identify whether an IP address is trustworthy or malicious. It classifies IPs into categories like VPN, Proxy, Spam Source, Botnet, or Clean.
Who should use the IP Reputation Checker API?
This API is ideal for developers, cybersecurity teams, businesses, and SaaS providers who want to prevent fraud, block malicious traffic, and protect their platforms.
How accurate is the risk scoring system?
The API combines real-time intelligence, community reports, and threat databases to provide a risk score (0–100), where higher values indicate greater threat likelihood.
Does it support both IPv4 and IPv6?
Yes, the API supports both IPv4 and IPv6 addresses, ensuring compatibility with modern networks.
How do I authenticate requests?
Authentication requires an API key. If using RapidAPI, include your key in the x-rapidapi-key
request header.