Products
IP Geolocation Anonymity Detection Blocklists IP Reputation Scores ASN & Company Network Classification Mobile Carriers Extended ASN API ipdata.free
Resources
Documentation API Reference SDKs & Libraries Research Tool Datacenter networks Mobile carriers
Pricing Log in
Sign up
[ ipdata.free ]

curl ipdata.free

ipdata.free answers with the location and network of any IP address — yours, or one you put in the path. 1,000 requests a day from each calling address, no key, no account, and commercial use is fine with attribution.

the response, as ipdata.free returned it — no key

Country ISO code
City and region
Coordinates lat / lng
Network ASN and org
Time zone IANA name
Fields
▸ ipdata.free/86.128.12.34 — GB · AS2856 BTnet no key · 200 OK · 999 left today
Try it live Read the terms
Unlimited Country and ASN, with a key
1,000 City-level lookups daily
[ 01 — LIVE ]

Run it from your browser

A real request, made from this page with no key. Leave the path empty for your own address, or put any IPv4 or IPv6 address in it.

$ curl ipdata.free/
ipdata.free/GET · sending

            
# Your own address
curl https://ipdata.free/

# Any address, IPv4 or IPv6
curl https://ipdata.free/8.8.8.8

# With an API key: unlimited country and ASN lookups
curl "https://ipdata.free/8.8.8.8?api-key=YOUR_KEY"

# Where you stand: print the RateLimit headers too
curl -i https://ipdata.free/

            
          

          
a real request, sent from your browser — no key

        


        
        

          

            
string

            
ip

            
The address that was looked up, echoed back.

          

          

            
string

            
country

            
Two-letter ISO 3166-1 country code.

          

          

            
strings

            
city / region / postal

            
The place, down to city level. Left out when it isn't known for an address.

          

          

            
numbers

            
latitude / longitude

            
Coordinates of the estimated location.

          

          

            
strings

            
asn / org

            
The network the address belongs to: its AS number and the organization behind it.

          

          

            
string

            
timezone

            
IANA time zone name. Left out when it isn't known for an address.

          

        

      

    

  


  
  
  

  

    

      

        
[ 02 — TERMS ]

        
The whole deal

      


      

        
Quota
1,000 requests a day, for each calling IP address.

        
Resets
Every 24 hours. The seconds until the next reset come back in the RateLimit-Reset header.

        
Authentication
None needed. No key, no account.

        
With an API key
Unlimited country-level geolocation and ASN data. Add ?api-key= and your ipdata key to the URL.

        
Commercial use
Allowed, with attribution.

        
Your own address
GET https://ipdata.free/

        
Any address
GET https://ipdata.free/8.8.8.8 — IPv4 or IPv6

        
Response
JSON with ip, city, region, country, latitude, longitude, asn, org, postal and timezone. Fields that aren't known for an address are left out.

        
From a browser
Works — CORS is open to every origin, and the rate-limit headers are exposed to scripts.

        
Where you stand
Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset.

        
Bad input
A path that isn't an IP address gets a 400 with a message saying so.

      

    

  


  
  
  

  

    

      

        
[ 03 — PER IP ]

        
“Per IP address” means the caller's

        
The quota is counted against the address the request arrives from, not against a key or a domain. That has three consequences worth knowing before you build on it.

      


      

        

          01
          
          
From your server

          
Every request comes from your server's address, so the whole quota is yours. Enough for a lookup a minute and a half, all day — a sign-up form, a log enricher, a cron job.

          1,000 a day, total
        

        

          02
          
          
From an office or a shared network

          
Everyone behind the same public address shares one quota. A busy office, a campus or a mobile carrier's gateway can use it up between them.

          1,000 a day, shared
        

        

          03
          
          
From your users' browsers

          
Call it client-side and each visitor's device spends its own quota, not yours. Localising a page or pre-filling a country field costs you nothing at any traffic level.

          1,000 a day, per visitor
        

      

    

  


  
  
  

  

    

      

        
[ 04 — BEYOND ]

        
When a thousand isn't enough

        
ipdata.free is the same data behind the same fields, with no key in the way. The keyed plans add volume, and the datasets that need one.

      


      

        

          Free plan, with a key
          
Unlimited country-level lookups

          
A free key lifts the daily cap for country-level geolocation and ASN data: as many lookups as you need, tied to your account rather than your address, with usage you can see in a dashboard.

          Get a free key
        

        

          Paid plans
          
Threat intelligence, VPN detection, company data

          
Higher limits, the fields that identify VPNs, proxies and known attackers, company and carrier data, and an SLA.

          See pricing
        

      

    

  


  
  
  

  

    

      

        
[ 05 — ATTRIBUTION ]

        
Commercial use with attribution

      


      
      

        
You can use the free tier in a commercial product as long as you credit ipdata where the data appears. The credit is this, a link to ipdata.co with a few words saying what it does, and the HTML to paste is beside it:

        

          IP geolocation by ipdata.co
          

            <a href="https://ipdata.co">IP geolocation by ipdata.co</a>
            
          

        

        
Place it near the data or in your footer, and keep it readable. Paid plans need no attribution.