# Ipstack

> Ipstack is a real-time IP geolocation REST API used by developers and global brands to locate visitors, personalise content and pricing, target advertising by region, apply regional tax and shipping rules, and detect fraud. A single HTTP GET enriches any IPv4 or IPv6 address with 100+ data fields organised into modules: location (continent, country, region, city, ZIP, latitude and longitude, plus country flag and calling code), time zone (ID, current time, GMT offset, daylight saving), currency (code, name, symbol), connection (ASN, ISP, connection type), and security (proxy, VPN, TOR and crawler detection, threat level and types). Coverage spans over 2 million unique locations across more than 200,000 cities, sourced through direct partnerships with large ISPs and refreshed with up to 24 database updates per day. Responses are returned in JSON or XML over 256-bit SSL, on infrastructure that handles 2–3 billion requests per day with 99.9%+ uptime. Ipstack is part of the APILayer suite (one account, one API key, one dashboard across the APILayer product family).
A free API key is available at https://dashboard.ipstack.com/signup/free/monthly — the Free Plan includes 100 requests per month with SSL and the location module only, without support or commercial-use rights; paid plans unlock the remaining modules in stages. Paid tiers are Basic ($12.99/month, 50,000 requests, adds commercial use, standard support, and the time zone, connection, and currency modules), Professional ($59.99/month, 500,000 requests, same feature set at higher volume), and Professional+ ($99.99/month, 2,000,000 requests, adds the bulk endpoint and the security module), with custom pricing above that and up to 15% off on annual billing. Note that module access is gated by plan, so a field present on one tier may be absent on a lower one. To call the API, append your access_key as a query parameter. The base URL is api.ipstack.com. A single lookup is one HTTP GET request: api.ipstack.com/134.201.250.155?access_key=YOUR_KEY. There are three endpoints: Standard Lookup (GET /{ip}) for one address, Bulk Lookup (GET /{ip1},{ip2},{ip3}) for up to 50 comma-separated addresses in one call, available on Professional+ and above, and Requester Lookup (GET /check) for the IP the request originated from. All three accept optional parameters: fields to select a subset of the response, hostname to enable reverse DNS, security to include the security module, language to localise place names, output to switch between JSON and XML, and callback for JSONP. Usage notifications are sent at 75%, 90%, and 100% of the monthly allowance, after which overage fees apply. Code examples and integration guides are provided for multiple languages.
## Getting Started
- [Ipstack Homepage](https://ipstack.com/): Real-time IP geolocation API with 100+ data fields
- [API Documentation](https://docs.apilayer.com/ipstack/docs/api-documentation): Full reference — endpoints, parameters, response objects, error codes, and code examples
- [Free API Key Signup](https://dashboard.ipstack.com/signup/free/monthly): Create a free account with 100 monthly requests
- [Login](https://dashboard.ipstack.com/login): Access your dashboard, API key, and usage statistics
- [Pricing](https://ipstack.com/pricing/): Free and premium plan tiers with request volumes and module access
## Tools
- [MCP Server](https://ipstack.com/mcp/): Connect Ipstack to AI agents and assistants over the Model Context Protocol
- [Official SDKs](https://ipstack.com/sdk/): Ready-to-use client libraries for quick integration
- [Run in Postman](https://www.postman.com/apilayer/apilayer/collection/1jn3xlj/ipstack): Fork the official collection to test endpoints immediately
- [API Status](https://ipstack.com/api-status/): Real-time updates on API performance and uptime
## Resources
- [FAQs](https://ipstack.com/faq/): Common questions on accuracy, update frequency, coverage, plans, and overages
- [How to Use the Ipstack API](https://ipstack.com/how-to-use-ipstack-api/): Walkthrough of a first request and the response structure
- [API Glossary](https://ipstack.com/api-glossary/): Definitions of common geolocation and API terms
- [Ipstack Blog](https://blog.ipstack.com/): Tutorials, use cases, and product updates
## Support
- [Contact Us](https://ipstack.com/contact/): Sales and technical support, including custom and high-volume plan inquiries