Help & API Reference
Basic Usage
Get your public IP address (plain text — works with curl, wget, HTTPie, etc.):
curl -s ifcfg.us/ipForce IPv4 or IPv6:
curl -4 ifcfg.uscurl -6 ifcfg.usJSON Response
Returns full GeoIP data including country, city, ASN, and more:
curl -s ifcfg.us/jsonForce JSON via Accept header:
curl -s -H "Accept: application/json" ifcfg.usSpecific Fields
Each field is accessible as a plain-text endpoint:
curl -s ifcfg.us/countrycurl -s ifcfg.us/country-isocurl -s ifcfg.us/citycurl -s ifcfg.us/asncurl -s ifcfg.us/asn-orgcurl -s ifcfg.us/latitudecurl -s ifcfg.us/longitudecurl -s ifcfg.us/timezonecurl -s ifcfg.us/hostnamecurl -s ifcfg.us/user-agentLook Up Another IP
Query any IP address for GeoIP data:
curl -s ifcfg.us/8.8.8.8curl -s ifcfg.us/8.8.8.8/jsoncurl -s ifcfg.us/2001:4860:4860::8888/jsonPort Reachability
Check if a port is open on the requesting IP:
curl -s ifcfg.us/port/22curl -s ifcfg.us/port/443API Formats
- Plain text — default for curl/wget/CLI user-agents and empty User-Agent
- JSON —
Accept: application/jsonheader, or/jsonsuffix - HTML — browser user-agents, or
Accept: text/html
Append .txt to any field endpoint for explicit plain text:
curl -s ifcfg.us/country.txt
Rate Limits
Automated use is permitted. Please limit requests to 1 per minute. Requests exceeding this may receive a 429 Too Many Requests response.