Name: IP Geo Data API: Get Accurate IP Geolocation & Location Info
Brand: coolapps.mobi
SKU: api-coolapps.mobi-ip-geo-data
Availability: InStock
Author: API Market

Yong Jason

# IP Geo Data

## Overview
The IP Geo Data API provides comprehensive, real-time geolocation information for any given IPv4 or IPv6 internet address. This powerful tool allows developers to instantly retrieve detailed geographical metadata, including continent, country, district, city, precise latitude and longitude coordinates, local currency, and international phone-code associated with an IP address. It's ideal for applications requiring location intelligence, user segmentation, or security analysis.

## Features
*   **Real-time IP Geolocation**: Instantly look up geographical data for any IP address.
*   **Comprehensive Data Fields**: Access continent code and name, country code, name, capital, currency, phone code, region, city, latitude, and longitude.
*   **IPv4 and IPv6 Support**: Compatible with both IPv4 and IPv6 address formats.
*   **High Accuracy**: Leveraging regularly updated geographical datasets.
*   **Simple Integration**: A straightforward RESTful API with easy-to-understand endpoints.

## Use Cases
*   **Fraud Detection & Security**: Identify suspicious activities by flagging transactions or login attempts originating from unexpected or high-risk geographical locations.
*   **Content Localization & Personalization**: Deliver targeted content, advertisements, or language preferences to users based on their geographical location, enhancing user experience.
*   **User Analytics & Market Research**: Gain insights into your user base's geographical distribution, helping to identify target markets and refine marketing strategies.
*   **Geo-fencing & Compliance**: Enforce geographical restrictions for services, digital rights management, or compliance with regional regulations by allowing or blocking access based on location.
*   **Network Monitoring & DDoS Mitigation**: Track the origin of network traffic to analyze potential threats, monitor service availability across regions, or assist in distributed denial-of-service (DDoS) attack mitigation.


## API Documentation

### Base URL
All API requests should be made to: `https://prod.api.market/api/v1/coolapps.mobi/ip-geo-data`

### Authentication
Authentication is handled via API key. Include your API key in the request header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Endpoints

#### GET /api/v1/coolapps.mobi/ip-geo-data/get_ip_info/{ip}
*   **Summary**: Look up IP geolocation.
*   **Description**: Retrieves detailed geographical information for a given IPv4 or IPv6 address. This includes continent, country, region, city, latitude, longitude, currency, and phone code.
*   **Parameters**:
    *   `ip` (Path Parameter, Required)
        *   **Type**: `string`
        *   **Description**: The IPv4 or IPv6 address to look up.
        *   **Example**: `203.0.100.123`

*   **Example Request (cURL)**:
    ```bash
    curl -X GET "https://prod.api.market/api/v1/coolapps.mobi/ip-geo-data/get_ip_info/203.0.100.123" \
      -H "x-api-market-key: YOUR_API_MARKET_KEY"
    ```

*   **Example Response (200 OK)**:
    ```json
    {
      "ip": "203.0.100.123",
      "continent": {
        "code": "OC",
        "name": "Oceania"
      },
      "country": {
        "code": "AU",
        "name": "Australia",
        "capital": "Canberra",
        "currency": "AUD",
        "phone-code": "61"
      },
      "region": "ACT",
      "city": "Acton",
      "latitude": -35.2733,
      "longitude": 149.115
    }
    ```

*   **Example Response (400 Bad Request - Invalid IP)**:
    ```json
    {
      "error": "Invalid IP address format."
    }
    ```

*   **Example Response (404 Not Found - IP Info Not Found)**:
    ```json
    {
      "error": "IP info not found"
    }
    ```

## Status Codes
A comprehensive list of HTTP status codes and their meaning in the context of the IP Geo Data API:

*   **200 OK**: The request was successful, and the IP geolocation data is returned in the response body.
*   **400 Bad Request**: The request was malformed or contained invalid input parameters, such as an incorrectly formatted IP address. The `error` field in the response body will provide more details.
*   **401 Unauthorized**: The request is missing a valid API key or the provided `x-api-market-key` is incorrect or expired. Ensure your API key is properly included in the request headers.
*   **403 Forbidden**: Your API key is valid but does not have the necessary permissions to access this resource, or your account might be restricted. Contact support if you believe this is an error.
*   **404 Not Found**: No geographical data could be found for the specified IP address. This might occur for private IPs, unallocated ranges, or if the IP is unknown to the dataset. The `error` field will typically indicate "IP info not found".
*   **429 Too Many Requests**: You have exceeded the allocated rate limits for the API. Please slow down your request rate and retry after some time. Check the `Retry-After` header if available.
*   **500 Internal Server Error**: An unexpected error occurred on the server-side while processing your request. This is usually a temporary issue.
*   **503 Service Unavailable**: The service is temporarily unable to handle your request, often due to maintenance or high load. Please try again after a short delay.



## Performance Optimization
To ensure efficient and cost-effective usage of the IP Geo Data API, consider the following optimization strategies:

*   **Client-Side Caching**: For IP addresses that are known to be static or frequently queried (e.g., server IPs, known VPN endpoints), implement a client-side caching mechanism. Store the API response for a set period and retrieve it from the cache before making a new API call. This reduces redundant requests and improves application responsiveness.
*   **Handle Errors Gracefully**: Implement robust error handling (as described in the Error Handling section) to avoid unnecessary retries or cascading failures. Distinguish between transient errors (which can be retried) and permanent errors (which require intervention).
*   **Monitor Usage**: Keep track of your API usage to stay within your plan limits and understand your consumption patterns. This can help identify opportunities for caching or adjustments to your API call strategy.

## FAQ

### What kind of IP addresses does the API support?
The API supports both **IPv4** and **IPv6** addresses.

### How accurate is the IP geolocation data?
Our data is derived from industry-standard sources and is regularly updated to provide high accuracy for continent, country, region, and city-level lookups. However, geolocation accuracy can vary depending on the IP type (e.g., mobile vs. fixed-line broadband) and the IP owner's location.

### What happens if an IP address is not found in the database?
If the API cannot find geographical information for a provided IP address, it returns a **`404 Not Found`** HTTP status code with an error message such as:

```json
{
  "error": "IP info not found"
}
```

This can occur for unallocated IP ranges, private IP addresses, or newly assigned IPs that have not yet been indexed.

### Is the API rate-limited?
Yes. The API enforces rate limits to ensure fair usage for all customers. If you exceed your allocated request quota, you will receive a **`429 Too Many Requests`** response. We recommend implementing retry logic with exponential backoff to handle these responses gracefully.

### Can I use this API for commercial purposes?
Yes. The API is designed for a wide range of commercial applications, including fraud detection, content localization, analytics, personalization, and other location-aware services. Please refer to the available pricing tiers for usage limits and commercial licensing details.

## Contact Us
If you have any questions or need assistance, you can reach out to us through the embedded chat on the bottom right corner of the page or send an email to hello@magicapi.com.

Access comprehensive IP geolocation data. This API provides accurate details like continent, country, city, coordinates, currency, and phone codes for any IPv4 

IP Geo Data API: Get Accurate IP Geolocation & Location Info

Free