Skip to main content

​
Getting started

​
Https

The GeoIPFetcher API requires all communications to be secured over HTTPS. Unsecured HTTP requests will be rejected.

​
Api Versions

The GeoIPFetcher API is versioned, and the current version is v1. The version is part of the URL path, and the current version is v1. For example, the URL for the v1 version of the API is https://api.geoipfetcher.com/v1.

​
Api Key

An API key is required to use the GeoIPFetcher API. You can get your API key by signing up at https://geoipfetcher.com. To authenticate your requests, append your API key to the base url as a query parameter. For example, https://api.geoipfetcher.com/v1?api_key=YOUR_API_KEY.

​
Base Url

https://api.geoipfetcher.com/v1

​
Api Endpoint

GeoIPFetcher’s API only requires your API key. We will autodetect your IP address from the client’s request. You can override this behavior by appending the ip_address parameter. 
https://api.geoipfetcher.com/v1/\
?api_key=YOUR_API_KEY\
&ip_address=OPTIONAL_IP_ADDRESS
You can see a more detailed description of the request and response objects as well as test out requests in the API Reference.