Today, I’ll teach you how to use the free API and the Apipheny API integrator to import IP geolocation data into Google Sheets. is an IP geolocation API that allows you to geolocate a specific IP address. Furthermore, it returns more data about your IP, like timezone, currencies, and more.

To import data from into Google Sheets, follow these steps:

  1. Install Apipheny
  2. Generate an API key
  3. Use Apipheny to get the country of multiple IPs

Step 1.) Install and open the Apipheny add-on for Google Sheets

Apipheny is a free API connector for Google Sheets. You can use Apipheny to connect your Google Sheets to API data sources, easily.

1.) Install Apipheny by opening the following link on desktop and then clicking the Install button in the Google Marketplace:

2.) After you’ve installed Apipheny, open a Google Sheet and then click on the Extensions dropdown in the menu at the top.

In the dropdown list you should see Apipheny. Click Apipheny then click Import API to open the Apipheny sidebar in your Google Sheet.

open apipheny

Tip: you can open a new Google Sheet by entering this URL in your browser:

Step 2.) Generate an API key

After logging in to your account, go to Dashboard and copy your API key.

Copy and paste your API key in a safe location because you’ll need it in the next steps.

Step 3.) Use Apipheny to get the country of multiple IPs

Imagine you have the following table, and you want to replace the question marks with the country of the IP.

To achieve this, we create and save a new Apipheny function:

  1. The “API URL Path” (1) is not that important as we will overwrite it when using it
  2. Important here is adding the apikey parameter as a header (2) so it can be re-used when you overwrite the URL later. You can use as a placeholder for now
  3. Continue by saving (3) and giving the request a name

After that, you go into your saved request and copy the request ID.


The second parameter of the APIPHENY function lets you overwrite the request URL. We will use this functionality to inject the IP of the corresponding row.

Now let’s use the saved function with an URL overwrite, and some other Google Sheets functions to build the following:

=INDEX(ARRAY_CONSTRAIN(TRANSPOSE(APIPHENY("req-xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"; ""&A1));100;2);MATCH("";ARRAY_CONSTRAIN(TRANSPOSE(APIPHENY("req-xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"; ""&A1));100;1);0);2)

This will fetch the data from and filter down to only the value of the field with the key You can use any other field specified in the documentation.

If we insert this function into B1 and pull it down, it will fill column B with the country codes of the IP addresses like so:

How to get IP geolocation data into Google Sheets.

Popular API Tutorials

API Knowledge

What is an API?

What is an API URL?

What are parameters?

What is an endpoint?

What is an API key/token?

What is basic authentication?

What are headers?

What is a GET request?

What is a POST request?

Import JSON to Google Sheets

SEO by SearchCyrus