Sample code for 30+ languages & platforms
Unicode C++ Requires Chilkat v11.0.0+

Look up an IP location with IPinfo Core

See more Geolocation Examples

Use an IPinfo token with Core, Plus, or Max access. The current api.ipinfo.io/lookup/ endpoint returns location fields inside geo and network fields inside as. Authenticate with a Bearer token.

IPinfo continues to support its older ipinfo.io API for existing integrations. This example uses the current Core response structure. The free Lite API uses /lite/ and a different, country-level response. Choose the endpoint and parser for your subscription.

IP geolocation estimates a network location. VPNs, mobile gateways, and anycast routing can affect the result. City and coordinate fields can be missing or approximate. The sample address 8.8.8.8 is a public DNS address used to demonstrate the request.

Service documentation

Chilkat Unicode C++ Downloads

Unicode C++
#include <CkHttpW.h>
#include <CkStringBuilderW.h>
#include <CkHttpResponseW.h>
#include <CkJsonObjectW.h>

void ChilkatSample(void)
    {
    bool success = false;

    //  Assumes Chilkat is unlocked. See Global Unlock Sample.
    //  Use a public IP address. Provider results can change as their databases are updated.
    const wchar_t *ipAddress = L"8.8.8.8";
    CkHttpW http;
    http.put_RequireSslCertVerify(true);
    http.put_ConnectTimeout(10);
    http.put_ReadTimeout(30);
    http.put_Accept(L"application/json");
    http.put_AuthToken(L"IPINFO_TOKEN");
    CkStringBuilderW url;
    url.Append(L"https://api.ipinfo.io/lookup/");
    url.Append(http.urlEncode(ipAddress));
    CkHttpResponseW response;
    success = http.HttpNoBody(L"GET",url.getAsString(),response);
    if (response.get_StatusCode() == 0) {
        //  Request diagnostics can contain an API key. Report transport failure without logging credentials.
        wprintf(L"No HTTP response. Check connectivity, DNS, and TLS configuration.\n");
        return;
    }

    CkJsonObjectW json;
    bool parsed = json.Load(response.bodyStr());
    if ((success != true) || (response.get_StatusCode() < 200) || (response.get_StatusCode() >= 300)) {
        wprintf(L"Lookup failed. HTTP %d\n",response.get_StatusCode());
        if (parsed == true) {
            if (json.JsonTypeOf(L"error.title") == 1) {
                wprintf(L"%s\n",json.stringOf(L"error.title"));
            }

            if (json.JsonTypeOf(L"error.message") == 1) {
                wprintf(L"%s\n",json.stringOf(L"error.message"));
            }

        }

        return;
    }

    if (parsed != true) {
        wprintf(L"Expected a JSON object in the lookup response.\n");
        return;
    }

    if ((json.JsonTypeOf(L"error") == 3)) {
        wprintf(L"The service could not complete the lookup.\n");
        if (json.JsonTypeOf(L"error.title") == 1) {
            wprintf(L"%s\n",json.stringOf(L"error.title"));
        }

        if (json.JsonTypeOf(L"error.message") == 1) {
            wprintf(L"%s\n",json.stringOf(L"error.message"));
        }

        return;
    }

    if ((json.JsonTypeOf(L"bogon") == 5) && (json.BoolOf(L"bogon") == true)) {
        wprintf(L"This is a reserved or otherwise non-public IP address.\n");
        return;
    }

    if ((json.JsonTypeOf(L"ip") != 1) || (json.StringOfEquals(L"ip",L"",true) == true)) {
        wprintf(L"The response did not contain the expected IP address.\n");
        return;
    }

    wprintf(L"IP address: %s\n",json.stringOf(L"ip"));
    if ((json.JsonTypeOf(L"geo.country") == 1) && (json.StringOfEquals(L"geo.country",L"",true) != true)) {
        wprintf(L"Country: %s\n",json.stringOf(L"geo.country"));
    }
    else {
        wprintf(L"Country: unavailable\n");
    }

    if ((json.JsonTypeOf(L"geo.country_code") == 1) && (json.StringOfEquals(L"geo.country_code",L"",true) != true)) {
        wprintf(L"Country code: %s\n",json.stringOf(L"geo.country_code"));
    }
    else {
        wprintf(L"Country code: unavailable\n");
    }

    if ((json.JsonTypeOf(L"geo.region") == 1) && (json.StringOfEquals(L"geo.region",L"",true) != true)) {
        wprintf(L"Region: %s\n",json.stringOf(L"geo.region"));
    }
    else {
        wprintf(L"Region: unavailable\n");
    }

    if ((json.JsonTypeOf(L"geo.city") == 1) && (json.StringOfEquals(L"geo.city",L"",true) != true)) {
        wprintf(L"City: %s\n",json.stringOf(L"geo.city"));
    }
    else {
        wprintf(L"City: unavailable\n");
    }

    if ((json.JsonTypeOf(L"geo.timezone") == 1) && (json.StringOfEquals(L"geo.timezone",L"",true) != true)) {
        wprintf(L"Time zone: %s\n",json.stringOf(L"geo.timezone"));
    }
    else {
        wprintf(L"Time zone: unavailable\n");
    }

    //  Missing coordinates stay unavailable. A numeric zero is a valid coordinate.
    if ((json.JsonTypeOf(L"geo.latitude") == 2) && (json.JsonTypeOf(L"geo.longitude") == 2)) {
        wprintf(L"Coordinates: %s, %s\n",json.stringOf(L"geo.latitude"),json.stringOf(L"geo.longitude"));
    }
    else {
        wprintf(L"Coordinates: unavailable\n");
    }

    if ((json.JsonTypeOf(L"as.asn") == 1) && (json.StringOfEquals(L"as.asn",L"",true) != true)) {
        wprintf(L"ASN: %s\n",json.stringOf(L"as.asn"));
    }
    else {
        wprintf(L"ASN: unavailable\n");
    }

    if ((json.JsonTypeOf(L"as.name") == 1) && (json.StringOfEquals(L"as.name",L"",true) != true)) {
        wprintf(L"Network organization: %s\n",json.stringOf(L"as.name"));
    }
    else {
        wprintf(L"Network organization: unavailable\n");
    }
    }