Name: IP Geolocation API - Precise Location, ISP & Timezone Data
Brand: spvn-tech
SKU: api-spvn-tech-location
Availability: InStock
Rating: 5.00 (1 reviews)
Author: API Market

Sai Pavan

# 📍 Locate IP Addresses: Get precise location, ISP, and timezone data with the IP Geolocation API

## Overview
The Locate IP Addresses API offers a powerful and precise solution for pinpointing the exact location, ISP details, and timezone information for any IPv4 or IPv6 address globally. Leveraging a lightning-fast and highly accurate database, this API provides comprehensive geolocation data that is essential for robust security measures, content personalization, fraud detection, and network analysis. Instantly retrieve country, city, state, coordinates, ASN (Autonomous System Number), and organization details with a single API call, ensuring you have the critical location intelligence you need.

## Features
*   **Precise IP Geolocation:** Accurately determine the physical location (country, city, state, latitude, longitude) associated with any IP address.
*   **ISP and ASN Data:** Retrieve detailed information about the Internet Service Provider (ISP) and the Autonomous System Number (ASN) that an IP address belongs to, including the organization name.
*   **Timezone Information:** Get specific timezone data, including zone name and GMT offset, for the IP's location.
*   **Global Coverage:** Comprehensive data for IPv4 and IPv6 addresses worldwide.
*   **High Accuracy & Speed:** Built for performance, delivering fast responses with highly reliable data.
*   **Easy Integration:** Simple RESTful API design for straightforward integration into any application.

## Use Cases
*   **Fraud Detection and Prevention:** Enhance cybersecurity by identifying suspicious login attempts or fraudulent transactions. Cross-reference user-reported locations with the IP's actual geolocation to detect discrepancies and prevent malicious activities.
*   **Content Personalization and Geo-Targeting:** Optimize marketing and user engagement strategies by delivering localized content, advertisements, or services. Tailor experiences based on a user's geographical location for increased relevance and conversion rates.
*   **Network Security and Analytics:** Strengthen IT infrastructure by monitoring network traffic, identifying potential threats, and analyzing attack origins. Track the precise location of incoming and outgoing IP addresses to understand and mitigate cyber risks.
*   **Digital Rights Management:** Enforce geographical restrictions on digital content or services. Ensure compliance with licensing agreements and regional regulations by accurately determining user locations.
*   **Customer Relationship Management (CRM):** Enrich customer profiles with valuable location data. Gain deeper insights into customer demographics to refine marketing campaigns, improve sales strategies, and provide more targeted support.


## API Documentation

### Base URL
All API requests should be made to:
`https://prod.api.market/api/v1/spvn-tech/location`

### Authentication
Authentication is handled via API key. Include your API key in the request header for every request:
```
x-api-market-key: YOUR_API_MARKET_KEY
```
Replace `YOUR_API_MARKET_KEY` with the actual API key provided to you by API.market.


### Endpoints
#### Get Geolocation details by IP
`POST /api/v1/spvn-tech/location/api/geo/get-location-details-by-ip`
**Summary**: Get Geolocation details by IP
**Description**: Returns highly accurate location, ASN, Timezone, and provider details for a given IPv4 or IPv6 address.

**Request Body** (`application/x-www-form-urlencoded`)

| Parameter | Type   | Required | Description                      | Example           |
| :-------- | :----- | :------- | :------------------------------- | :---------------- |
| `ip`      | `string` | Yes      | The IP address you want to look up. | `104.16.132.229`  |

**Example Request (cURL)**
```bash
curl -X POST "https://prod.api.market/api/v1/spvn-tech/location/api/geo/get-location-details-by-ip" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d "ip=104.16.132.229"
```

**Example Response (200 OK)**
```json
{
  "success": true,
  "ip": "104.16.132.229",
  "country": {
    "id": 226,
    "name": "United States",
    "iso3": "USA",
    "iso2": "US",
    "timezone": [
      {
        "zoneName": "America/New_York",
        "gmtOffsetName": "UTC-05:00"
      }
    ]
  },
  "city_data": {
    "city": "San Francisco",
    "state": "California",
    "country_code": "US",
    "latitude": 37.7749,
    "longitude": -122.4194,
    "attribution": "<a href=\"https://db-ip.com\" target=\"_blank\">IP Geolocation by DB-IP</a>"
  },
  "iptoasn_data": {
    "asn": "AS13335",
    "organization": "Cloudflare, Inc."
  },
  "metadata": {
    "cache": "MISS",
    "lookup_time_ms": 12.34,
    "provider": "GeolocationEngine"
  }
}
```

**Example Response (400 Bad Request)**
```json
{
  "success": false,
  "error": "Invalid or missing IP address"
}
```

## Status Codes
A comprehensive list of HTTP status codes and their meanings in the context of this API:

*   **200 OK:** Request successful. The API processed the request and returned the expected geolocation data for the provided IP address.
*   **400 Bad Request:** Invalid input parameters or a malformed request body. This typically indicates that the `ip` parameter is missing or contains an invalid IP address format. Check your request body and IP address.
*   **401 Unauthorized:** Missing or invalid API key. Ensure you are including a valid `x-api-market-key` header with your request.
*   **403 Forbidden:** Valid API key but insufficient permissions or direct access blocked. Ensure requests go through the API Market infrastructure.
*   **404 Not Found:** The requested resource was not found. Check the endpoint URL path to ensure it is correct.
*   **405 Method Not Allowed:** Only POST requests are allowed on this endpoint. Ensure your request uses the `POST` method.
*   **429 Too Many Requests:** Rate limit exceeded. You have sent too many requests in a given amount of time. Implement retry logic with exponential backoff.
*   **500 Internal Server Error:** A server-side error occurred. This is typically a transient issue.
*   **503 Service Unavailable:** The service is temporarily unavailable, usually due to maintenance or high load. This is a transient error.



## Implementation Guide

### Example Code
Below are code examples demonstrating how to use the Locate IP Addresses API in various programming languages. Since this is a synchronous API, each example makes a single request and directly processes the response.

**JavaScript**
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/spvn-tech/location";
const ipToLookup = "104.16.132.229";

async function getIpGeolocation(ipAddress) {
  try {
    const params = new URLSearchParams();
    params.append('ip', ipAddress);

    const response = await fetch(`${baseUrl}/api/geo/get-location-details-by-ip`, {
      method: "POST",
      headers: {
        "Content-Type": "application/x-www-form-urlencoded",
        "x-api-market-key": apiKey
      },
      body: params.toString()
    });
    
    if (!response.ok) {
      const errorData = await response.json();
      throw new Error(`API error: ${response.status} ${response.statusText} - ${errorData.error || 'Unknown error'}`);
    }
    
    const result = await response.json();
    console.log("IP Geolocation Result:", result);
    return result;
  } catch (error) {
    console.error("Error fetching IP geolocation:", error);
    throw error;
  }
}

getIpGeolocation(ipToLookup);
```

**Python**
```python
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/spvn-tech/location"
IP_TO_LOOKUP = "104.16.132.229"

def get_ip_geolocation(ip_address):
    headers = {
        "Content-Type": "application/x-www-form-urlencoded",
        "x-api-market-key": API_KEY
    }
    
    data = {
        "ip": ip_address
    }
    
    try:
        response = requests.post(
            f"{BASE_URL}/api/geo/get-location-details-by-ip",
            headers=headers,
            data=data
        )
        
        response.raise_for_status()  # Raises HTTPError for bad responses (4xx or 5xx)
        result = response.json()
        print("IP Geolocation Result:", result)
        return result
        
    except requests.exceptions.HTTPError as http_err:
        print(f"HTTP error occurred: {http_err}")
        print("Error response:", response.json())
        raise
    except requests.exceptions.RequestException as req_err:
        print(f"Request error occurred: {req_err}")
        raise

get_ip_geolocation(IP_TO_LOOKUP)
```

**cURL**
```bash
curl -X POST "https://prod.api.market/api/v1/spvn-tech/location/api/geo/get-location-details-by-ip" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d "ip=104.16.132.229"
```

### Performance Optimization
To ensure optimal performance and cost efficiency when integrating the IP Geolocation API:
*   **Client-Side Caching:** If your application frequently looks up the same IP addresses, consider implementing a client-side cache for a short duration. Geolocation data for static IPs typically doesn't change rapidly.
*   **Batching (if applicable):** While this API processes one IP at a time, for services that may offer batch processing in the future, aggregating requests can reduce overhead.
*   **Error Handling and Retries:** Implement robust error handling and retry mechanisms with exponential backoff for transient errors (e.g., 5xx status codes) to make your integration more resilient and reduce failed requests.
*   **Monitor Usage:** Regularly review your API usage to identify any unusual patterns or unnecessary lookups.

## FAQ

**Q: What kind of IP addresses can I look up?**

A: You can look up both IPv4 and IPv6 addresses.

**Q: How accurate is the geolocation data?**

A: The API leverages a highly accurate and regularly updated database to provide precise location, ISP, and timezone data globally.

**Q: What if I provide an invalid IP address?**

A: The API will return a `400 Bad Request` error with a message indicating an invalid or missing IP address.

## 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.

Get precise location, ISP, and timezone data for any IPv4/IPv6 address globally with our IP Geolocation API. Enhance security, personalize content, and detect f

IP Geolocation API - Precise Location, ISP & Timezone Data