Skip to main content

Legacy Free API vs. IPinfo Lite

Updated

IPinfo offers two free APIs: the Legacy Free API with 50,000 monthly requests and the recommended IPinfo Lite with unlimited requests. They differ in endpoints, data provided, and response formats, so migration requires updating endpoints, adding tokens, and adjusting integrations. Public use of Lite requires attribution, and paid plans offer more detailed data. Read this article to learn more about our free tier options.

IPinfo provides two free APIs:

  • Legacy Free API (older system)

  • IPinfo Lite (current free API)

These are not equivalent and use different endpoints, limits, and response formats:

  Legacy Free API IPinfo Lite
Endpoint 
https://ipinfo.io/<IP>/json?token=$TOKEN
https://ipinfo.io/json?token=$TOKEN
 
https://api.ipinfo.io/lite/<IP>?token=$TOKEN
https://api.ipinfo.io/lite/me?token=$TOKEN
Token Optional

Required
Requests 50,000/month (with token)
1,000/day (without token)		 Unlimited
Data City, region, hostname, timezone Country, continent, ASN
Response Example 
{
  "ip": "71.243.6.72",
  "hostname": "pool-71-243-6-72.bos.east.verizon.net",
  "city": "Boston",
  "region": "Massachusetts",
  "country": "US",
  "loc": "42.3584,-71.0598",
  "org": "AS701 Verizon Business",
  "timezone": "America/New_York"
}
 
{
  "ip": "8.8.8.8",
  "asn": "AS15169",
  "as_name": "Google LLC",
  "as_domain": "google.com",
  "country_code": "US",
  "country": "United States",
  "continent_code": "NA",
  "continent": "North America"
}
Status Legacy Recommended

 

Key API Response Differences

  • IPinfo Lite is not a drop-in replacement for the Legacy Free API

  • Lite does not include:

    • City or region

    • Coordinates (loc)

    • Hostname

    • Time zone

  • On the other hand IPinfo Lite allows commercial use and unlimited requests for free with attribution

Migration (Legacy → Lite)

To switch to IPinfo Lite:

  1. Update the endpoint  

  2. Add a token

  3. Update your integration

    • Remove dependencies on fields like city, loc, timezone, hostname

    • Use country, continent, and asn fields instead

Attribution

IPinfo Lite requires attribution when used publicly. We greatly appreciate when you give our service credit as your data source. Simply place a link to IPinfo on your website or application that uses our data.

Mention on website (Recommended)

<p>IP address data powered by <a href="https://ipinfo.io" >IPinfo</a></p>

 

Need more data?

If you need city-level data, privacy detection, or additional IP intelligence, consider upgrading to a paid plan.

Related articles