Installation

clawhub install javainthinking/apipick-ip-geolocation

Summary

Look up location and network information for any public IPv4 or IPv6 address.

SKILL.md

apipick IP Geolocation

Look up location and network information for any public IPv4 or IPv6 address.

Endpoint

text
GET https://www.apipick.com/api/ip-geolocation

Authentication: x-api-key: YOUR_API_KEY header required. Get a free API key at https://www.apipick.com/dashboard/api-keys

Request

bash
# Look up a specific IP
GET /api/ip-geolocation?ip=8.8.8.8

# Look up caller's own IP (omit parameter)
GET /api/ip-geolocation

Response

json
{
  "success": true,
  "code": 200,
  "message": "ok",
  "data": {
    "ip": "8.8.8.8",
    "country_code": "US",
    "country_name": "United States",
    "continent": "North America",
    "continent_code": "NA",
    "city": "Mountain View",
    "latitude": 37.4056,
    "longitude": -122.0775,
    "timezone": "America/Los_Angeles",
    "currency": "USD",
    "isp": "Google LLC",
    "asn": 15169
  },
  "credits_used": 1,
  "remaining_credits": 99
}

city, latitude, longitude may be empty or null for some IPs.

Error Codes

CodeMeaning
400Invalid or private/reserved IP address
401Missing or invalid API key
402Insufficient credits
404No geolocation data available for this IP
503Geolocation database temporarily unavailable

Cost: 1 credit per request

Usage Pattern

  1. Use $APIPICK_API_KEY env var as the x-api-key header value; if not set, ask the user for their apipick API key
  2. Make the GET request (with or without ip query parameter)
  3. Present location data in a readable format

See references/api_reference.md for full response field descriptions.

Recommended skills

Browse all →