Documentation - Gripover

Quick Start

The Gripover API is a RESTful service that returns IP geolocation data in JSON format. Getting started is simple and requires just a few steps.

API Endpoint

https://api.gripover.com/v1/lookup/{ip_address}

Authentication

Include your API key in the request header or as a query parameter:

?apikey=YOUR_API_KEY

Example Request

curl -X GET "https://api.gripover.com/v1/lookup/8.8.8.8?apikey=YOUR_API_KEY"

Response Structure

{
  "status": "success",
  "data": {
    "ip": "8.8.8.8",
    "type": "IPv4",
    "country": "United States",
    "country_code": "US",
    "region": "California",
    "region_code": "CA",
    "city": "Mountain View",
    "postal": "94043",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "timezone": "America/Los_Angeles",
    "utc_offset": "-08:00",
    "isp": "Google LLC",
    "organization": "Google Public DNS",
    "asn": "AS15169",
    "currency": {
      "code": "USD",
      "name": "US Dollar",
      "symbol": "$"
    }
  }
}

Supported Parameters

ip - The IP address to lookup (optional, defaults to requester's IP)
format - Response format: json, xml, csv (default: json)
fields - Comma-separated list of fields to return
language - Response language code (en, es, fr, de, etc.)

Code Examples

JavaScript (Fetch API)

const apiKey = 'YOUR_API_KEY';
const ip = '8.8.8.8';

fetch(`https://api.gripover.com/v1/lookup/${ip}?apikey=${apiKey}`)
  .then(response => response.json())
  .then(data => {
    console.log('Location:', data.data.city);
    console.log('Country:', data.data.country);
  })
  .catch(error => console.error('Error:', error));

Python

import requests

api_key = 'YOUR_API_KEY'
ip = '8.8.8.8'

response = requests.get(
    f'https://api.gripover.com/v1/lookup/{ip}',
    params={'apikey': api_key}
)

data = response.json()
print(f"City: {data['data']['city']}")
print(f"Country: {data['data']['country']}")

PHP

$apiKey = 'YOUR_API_KEY';
$ip = '8.8.8.8';

$url = "https://api.gripover.com/v1/lookup/{$ip}?apikey={$apiKey}";
$response = file_get_contents($url);
$data = json_decode($response, true);

echo "City: " . $data['data']['city'];
echo "Country: " . $data['data']['country'];

Error Codes

Code	Description
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid API key
403	Forbidden - Rate limit exceeded
404	Not Found - IP address not found
500	Server Error - Internal server error

Rate Limits

Rate limits vary by plan:

Free: 1,000 requests/month
Starter: 10,000 requests/month
Professional: 100,000 requests/month
Enterprise: Custom limits

Best Practices

Cache responses to minimize API calls
Use bulk lookup for multiple IPs
Implement proper error handling
Monitor your usage through the dashboard

API Documentation