ipstack API

Geocoding / API Key Intermediate HTTPS
Varies by plan (check documentation)

Overview

ipstack is a powerful IP geolocation API that returns location, language, currency, timezone, and security information for any IP address in real time. It supports both IPv4 and IPv6 and is used by thousands of developers for personalizing content and detecting fraud. A free tier with 100 requests per month is available for experimentation.

💡

Beginner Tip

Sign up at ipstack.com to get a free API key. Note that the free plan only supports HTTP (not HTTPS); upgrade to a paid plan if you need secure requests in production.

Available Data

IP address information
geographic location
ASN and ISP data

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from ipstack",
    "description": "Locate and identify website visitors by IP address",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

ip The IP address that was looked up.
country_code Two-letter ISO country code, e.g. GB for the United Kingdom.
region_name State or region name associated with the IP.
city City name for the IP location.
time_zone.id IANA time zone identifier, e.g. Europe/London.
security.is_proxy True if the IP is identified as a proxy or anonymizer.

Implementation Example

const url = "https://ipstack.com/";
// Replace headers or query params with the values required by this API.
const response = await fetch(url, {
  headers: {
  "X-API-Key": "YOUR_API_KEY"
  }
});
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

101 invalid_access_key The access_key parameter is missing or incorrect.
Pass your key as access_key=YOUR_API_KEY in the query string.
105 https_access_restricted Your free plan does not support HTTPS endpoints.
Switch the URL scheme to http:// or upgrade to a paid plan that includes HTTPS.
301 invalid_ip_address The IP address in the URL path is not a valid public IPv4 or IPv6 address.
Verify the IP format and ensure it is not a private address like 192.168.x.x.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 15/20
🔒 Security 15/15
🛠 Developer XP 12/20
✓ Reliability 10/15

Partially tested on Apr 5, 2026

Technical Specifications

Auth API Key
HTTPS REQUIRED
CORS UNKNOWN
Category Geocoding
Difficulty Intermediate
Verified: 2026-04-04

Similar APIs

View All →