Skip to main content

​
IP Lookup API

Get comprehensive geolocation and network information for any IP address. Our IP lookup service provides detailed location data, country information, and network details for both IPv4 and IPv6 addresses.

​
What it does

The IP Lookup API helps you understand the geographic location and network details of any IP address. Get instant insights into where your users, traffic, or security events are coming from with precise geolocation data. Key capabilities:
  • IPv4 and IPv6 support - Complete support for both IP address formats
  • Precise geolocation - Country, region, city, and coordinate data
  • Network information - ISP, organization, and network details
  • EU compliance detection - Automatic EU region identification
  • Private IP handling - Proper handling of internal network addresses
  • High accuracy - Multiple data sources for reliable results

​
Developer Experience First

Our API is designed with simplicity in mind - all endpoints are single-request only. No need to worry about batching, managing batch sizes, or handling complex partial failure scenarios.
We handle batching and optimization in the background for you. Send one IP at a time, and we’ll automatically optimize performance behind the scenes. This gives you the best of both worlds: simple integration and high-performance processing.
Why this matters:
  • Simple integration - One request, one response - no batch complexity
  • No batch management - We handle optimization automatically
  • Cleaner error handling - Each request succeeds or fails independently
  • Easier testing - Test with single IPs, not complex batch payloads
  • Better debugging - Clear request-response mapping for troubleshooting

​
Use Cases

​
Security & Fraud Prevention

  • Threat detection - Identify suspicious IP addresses and locations
  • Fraud prevention - Flag transactions from high-risk regions
  • Access control - Implement geo-based access restrictions
  • Incident response - Track the geographic origin of security events

​
Analytics & Business Intelligence

  • User analytics - Understand where your users are located
  • Market research - Analyze traffic patterns by geography
  • Content localization - Serve region-appropriate content
  • Performance optimization - Route traffic to nearest servers
  • GDPR compliance - Identify EU users for privacy regulations
  • Content restrictions - Comply with regional content laws
  • Tax calculations - Determine tax obligations by location
  • Regulatory reporting - Generate location-based compliance reports

​
Log Processing & Monitoring

  • Server log analysis - Enrich web server logs with location data
  • CDN optimization - Analyze traffic patterns for edge deployment
  • Network monitoring - Track the geographic distribution of network events
  • Real-time dashboards - Display live traffic by location

​
Pricing

Our IP lookup API uses a simple, transparent credit-based pricing model:

​
IP Lookup

  • Custom pricing per 100 IP lookups
  • Sold in blocks of 100 validations for cost efficiency
  • Both IPv4 and IPv6 addresses

​
Free Scenarios

  • Invalid IP addresses - No charge for malformed IP addresses (returns validation error)
  • Rate-limited requests - Failed requests due to rate limits are not charged
You’re only charged for successful IP lookups. Invalid IP formats and rate-limited requests don’t consume credits. IP lookups are sold in blocks of 100 for maximum cost efficiency.

​
Pricing Examples

ScenarioIP ValidCredits Used
Valid public IP (IPv4)✅Custom pricing
Valid public IP (IPv6)✅Custom pricing
Private IP address✅Custom pricing
Invalid IP format❌0 credits
Rate limited requestN/A0 credits
Note: Individual lookups use custom pricing, sold in blocks of 100

​
Getting Started

  1. Get your API key from the MDB Dashboard
  2. Review the documentation - API Reference
  3. Check rate limits - Rate Limits (starts at 100 calls/sec)
  4. Test your integration - Use our interactive playground
  5. Monitor usage - Track credits and performance in your dashboard

​
API Endpoint

POST https://api.mdb.tools/v1/ip/lookup
Authentication: x-api-key header
Rate Limit: 100 calls per second (upgradeable)
Response Format: JSON with detailed geolocation results

​
Quick Example

curl -X POST "https://api.mdb.tools/v1/ip/lookup" \
  -H "x-api-key: your-api-key-here" \
  -H "Content-Type: application/json" \
  -d '{
    "ip": "8.8.4.4"
  }'

​
High-Volume Capabilities

With our generous 100 requests per second starting limit, you can process substantial IP lookup volumes:
  • Per minute: Up to 6,000 IP lookups
  • Per hour: Up to 360,000 IP lookups
  • Per day: Up to 8.64 million IP lookups
Perfect for real-time applications, log processing, security monitoring, and analytics workflows.

​
Next Steps

Need help getting started? Contact our support team at [email protected] - we respond fast!