SkillHub

apipick-ip-geolocation

v1.0.0

Look up geographic location and network information for any IPv4 or IPv6 address using the apipick IP Geolocation API. Returns country, continent, city, latitude/longitude, timezone, currency, ISP, and ASN. Use when the user wants to geolocate an IP address, find the country or city for an IP, ident...

Sourced from ClawHub, Authored by javainthinking

Installation

Please help me install the skill `apipick-ip-geolocation` from SkillHub official store. npx skills add javainthinking/apipick-ip-geolocation

apipick IP Geolocation

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

Endpoint

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

# 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

{
  "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

Code Meaning
400 Invalid or private/reserved IP address
401 Missing or invalid API key
402 Insufficient credits
404 No geolocation data available for this IP
503 Geolocation 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.