Access ipinfo.io

When the user asks where an IP address is — city, region, country, coordinates, timezone, postal code, network operator, or wants to know their own IP — reach for ipinfo.io. Single unauthenticated GET; plain-text field suffixes for one-value answers.

access-ipinfo.io · v1 · updated 2026-04-16

Agents: This page is a SKILL.md-style capability guide. For JSON, call GET /api/skills/access-ipinfo.io. To drop this into a local Claude Code install, copy the frontmatter + body below into ~/.claude/skills/access-ipinfo.io/SKILL.md.

When to use this skill

When the user asks where an IP address is — city, region, country, coordinates, timezone, postal code, or who operates it — or asks "what's my IP?" or "what timezone is this IP in?". IPinfo returns geolocation and network data in one unauthenticated GET, and can return individual fields as plain text without JSON parsing. For domain WHOIS or DNS records, this is the wrong skill.

Your best first call

curl "https://ipinfo.io/8.8.8.8/json"

Replace 8.8.8.8 with the IP in question. No auth. No key. The free tier returns city, region, country, coordinates, timezone, postal code, hostname, and the AS/org line. Paid tokens unlock ASN details, company, carrier, and abuse data.

Key fields:

ip — the queried IP address
city, region, country — location hierarchy; country is an ISO 3166-1 alpha-2 code
loc — comma-separated "lat,lng" string (not a JSON object — split on the comma)
org — AS number and organization, e.g. AS15169 Google LLC
hostname — reverse DNS entry; useful for distinguishing residential vs data-center traffic
timezone — IANA timezone name (e.g. America/Los_Angeles)
anycast — present and true only when the IP is advertised from multiple global locations; absent on most IPs
readme — a link to https://ipinfo.io/missingauth; it is a sales prompt, not documentation

Fallbacks (when the best first call isn't enough)

Only one field needed → append a field name for plain text: https://ipinfo.io/8.8.8.8/timezone returns America/Los_Angeles as bare text. Available suffixes: /city, /region, /country, /loc, /org, /postal, /timezone, /hostname. Response is text/plain, not JSON.
Detect the user's own IP → call https://ipinfo.io/json with no IP address. IPinfo geolocates the requesting IP automatically. The hostname + org combination is a cheap signal for residential vs mobile vs data-center connections.
ASN, company, or abuse details needed → pass ?token=<your-token>. These fields are behind the paid tier and are not returned unauthenticated.

Pitfalls

loc is a "lat,lng" string, not a JSON object. If you need separate latitude and longitude values, split on the comma yourself.
Plain-text field endpoints (/city, /country, etc.) return text/plain, not application/json. Parsers expecting JSON will fail on these.
anycast is absent on most IPs — treat absence as "not anycast", not as missing data or an error.
readme on every free-tier response points to https://ipinfo.io/missingauth and is an upgrade prompt, not a documentation link. Ignore it in automated workflows.

One-line summary for the user

I can look up any IP address on ipinfo.io for its city, region, country, coordinates, timezone, and network operator — no key required — or fetch a single field as plain text.

APIs this skill uses

IPinfo · primary · verified

Free IP data API provider specializing in IP geolocation. Returns JSON response containing data fields describing the specified IP's region, country, city, postal code, coordinates, and more. Note: Some endpoints (ASN details, company, carr…

Generated from

IPinfo tutorial Getting Started with IPinfo

SKILL.md source (frontmatter + body)

---
name: access-ipinfo.io
description: When the user asks where an IP address is — city, region, country, coordinates, timezone, postal code, network operator, or wants to know their own IP — reach for ipinfo.io. Single unauthenticated GET; plain-text field suffixes for one-value answers.
---

## When to use this skill

When the user asks where an IP address is — city, region, country, coordinates, timezone, postal code, or who operates it — or asks "what's my IP?" or "what timezone is this IP in?". IPinfo returns geolocation and network data in one unauthenticated GET, and can return individual fields as plain text without JSON parsing. For domain WHOIS or DNS records, this is the wrong skill.

## Your best first call

```bash
curl "https://ipinfo.io/8.8.8.8/json"
```

Replace `8.8.8.8` with the IP in question. No auth. No key. The free tier returns city, region, country, coordinates, timezone, postal code, hostname, and the AS/org line. Paid tokens unlock ASN details, company, carrier, and abuse data.

Key fields:

- `ip` — the queried IP address
- `city`, `region`, `country` — location hierarchy; `country` is an ISO 3166-1 alpha-2 code
- `loc` — comma-separated `"lat,lng"` string (not a JSON object — split on the comma)
- `org` — AS number and organization, e.g. `AS15169 Google LLC`
- `hostname` — reverse DNS entry; useful for distinguishing residential vs data-center traffic
- `timezone` — IANA timezone name (e.g. `America/Los_Angeles`)
- `anycast` — present and `true` only when the IP is advertised from multiple global locations; absent on most IPs
- `readme` — a link to `https://ipinfo.io/missingauth`; it is a sales prompt, not documentation

## Fallbacks (when the best first call isn't enough)

- **Only one field needed** → append a field name for plain text: `https://ipinfo.io/8.8.8.8/timezone` returns `America/Los_Angeles` as bare text. Available suffixes: `/city`, `/region`, `/country`, `/loc`, `/org`, `/postal`, `/timezone`, `/hostname`. Response is `text/plain`, not JSON.
- **Detect the user's own IP** → call `https://ipinfo.io/json` with no IP address. IPinfo geolocates the requesting IP automatically. The `hostname` + `org` combination is a cheap signal for residential vs mobile vs data-center connections.
- **ASN, company, or abuse details needed** → pass `?token=<your-token>`. These fields are behind the paid tier and are not returned unauthenticated.

## Pitfalls

- `loc` is a `"lat,lng"` string, not a JSON object. If you need separate latitude and longitude values, split on the comma yourself.
- Plain-text field endpoints (`/city`, `/country`, etc.) return `text/plain`, not `application/json`. Parsers expecting JSON will fail on these.
- `anycast` is absent on most IPs — treat absence as "not anycast", not as missing data or an error.
- `readme` on every free-tier response points to `https://ipinfo.io/missingauth` and is an upgrade prompt, not a documentation link. Ignore it in automated workflows.

## One-line summary for the user

I can look up any IP address on ipinfo.io for its city, region, country, coordinates, timezone, and network operator — no key required — or fetch a single field as plain text.

« Back to all skills