# 2k.is - IP Address Lookup Service

A fast, modern IP address lookup tool that provides comprehensive geolocation and network information.

## Overview
2k.is (also available at ou.is) is a free IP address lookup service that helps users identify geographical location, ISP details, and network information for both IPv4 and IPv6 addresses. The service features a clean, responsive interface with dark mode support and provides data through both a web interface and RESTful API.

## Core Features
- **IP Geolocation**: Get country, city, region, and coordinates
- **ISP Information**: Identify internet service provider and organization
- **Network Details**: ASN, network range, and abuse contact information
- **Timezone Data**: Local timezone for the IP location
- **Interactive Maps**: Visual location display using Google Maps
- **Dark/Light Theme**: User preference saved locally
- **Mobile Responsive**: Optimized for all device sizes

## API Documentation

### Basic IP Lookup
```
GET https://2k.is/{ip_address}
```
Returns HTML page with IP information

### JSON Response
```
GET https://2k.is/{ip_address}?json
```
Returns pure JSON data:
```json
{
  "ip": "8.8.8.8",
  "country": "United States",
  "city": "Mountain View",
  "region": "California",
  "latitude": 37.4056,
  "longitude": -122.0775,
  "isp": "Google LLC",
  "org": "Google Public DNS",
  "asn": "AS15169",
  "timezone": "America/Los_Angeles"
}
```

### JSONP Callback
```
GET https://2k.is/{ip_address}?callback={function_name}
```
Returns JSONP for cross-domain requests

### Current User IP
```
GET https://2k.is/
GET https://2k.is/?json
```
Returns information for the requesting IP address

### Raw IP Only
```
GET https://2k.is/raw
```
Returns just the IP address as plain text

### Specific Field
```
GET https://2k.is/{ip_address}/{field}
```
Returns a specific field value (e.g., /country, /city, /isp)

## Use Cases
- Network diagnostics and troubleshooting
- Geolocation services integration
- Security and fraud detection
- Content localization
- VPN/Proxy detection
- Educational purposes

## Technical Implementation
- **Backend**: PHP-based API
- **Frontend**: Vanilla JavaScript, CSS animations
- **Performance**: Optimized with lazy loading and caching
- **Security**: Input validation and rate limiting
- **Standards**: SEO optimized, PWA ready

## Data Sources
IP geolocation data is aggregated from multiple reliable sources to ensure accuracy and up-to-date information.

## Privacy
- No user tracking or analytics
- No cookies (except theme preference)
- No personal data collection
- SSL encrypted connections

## Rate Limits
API requests are subject to fair use limits to ensure service availability for all users.

## Alternative Access
The service is also available at https://ou.is with identical functionality.

## Contact
For API access, bug reports, or feature requests, contact information is available on the main page.