Connecting the Etsy API to Google Sheets

Etsy is the global marketplace for unique and creative goods. We can use the Etsy API to import data from Etsy into Google Sheets. In this tutorial, I’ll show you how to connect the Etsy API to Google Sheets in 5 steps:

  1. Install the Apipheny add-on
  2. Create an app and obtain an API key
  3. Obtain an Endpoint URL
  4. Enter the Etsy API URL Into Apipheny
  5. Run the Etsy API request

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

To pull data from the Etsy API to Google Sheets, first install and open the Apipheny Google Sheets add-on.

Apipheny is a no-code API integrator for Google Sheets that you can use to make unlimited API requests, connect to unlimited APIs, save API requests, schedule API requests, and more. 

1. Install Apipheny by opening the following link on desktop and then clicking the Install button on the page: https://apipheny.io/install

Install Apipheny in the Google Workspace Marketplace
Install Apipheny in the Google Workspace Marketplace

2. After you’ve installed Apipheny, open a Google Sheet and then click on the Add-Ons or Extensions option in the top menu. In the add-ons menu, you should see Apipheny.

Click Apipheny > Import API to open the Apipheny sidebar in your Google Sheets.

Opening the Apipheny add-on in Google Sheets
Opening the Apipheny add-on in Google Sheets

Step 2.) Create an app and obtain an API key

Go to https://www.etsy.com/developers/register and register an app. Complete all the required fields:

Registering a new app
Registering a new app
Fields to complete when registering a new app
Fields to complete when registering a new app

Click the Read Terms and Create App button:

Terms confirmation and creating the app
Terms confirmation and creating the app

Check the I have read and agree to the Etsy API Terms of Use checkbox, then click the Create App button:

Creating the app final step
Creating the app final step


Your app has been created and the KEYSTRING is displayed on the screen. Copy it to a safe location because you’ll need it later.

The app's initial screen
The app’s initial screen

Step 3.) Obtain an Endpoint URL

In this section, we’ll show you how to browse the Etsy API documentation to get an API URL that retrieves the information you need. If you already know your URL, or you want to use the same example URL as us, just skip to Step 4.

First, open the Etsy API documentation page: https://www.etsy.com/developers/documentation

The main section on the page contains the API Reference tab where you will find the API’s endpoints categories:

Etsy documentation
Etsy documentation

Clicking on a category scrolls to that API’s section, containing a list of associated endpoints. For instance, the User category API scrolls to an Overview section and the list of its 8 endpoints (they are named methods in the API documentation): findAllUsers, getUser, findAllUsersForTeam, getCirclesContainingUser, getConnectedUser, unconnectUsers, getConnectedUsers and connectUsers.

One of the available endpoints is getUser: https://openapi.etsy.com/v2/users/:user_id

When calling it, you should replace the :user_id parameterwith a real user id value.

This tutorial refers to the endpoints that don’t require OAuth. You could tell if an endpoint requires OAuth by the Requires OAuth field value, which could be Y (Yes) or N (No).

The endpoint’s documentation contains the endpoint name, a short description, the HTTP method used (GET), the URI and a list of accepted parameters, the Requires OAuth field and Permission Scope:

Etsy endpoint documentation
Etsy endpoint documentation

All API calls to Etsy should be made to the base domain: https://openapi.etsy.com/v2/…

This means any endpoint should be appended to this URL (replacing the three dots).

Step 4.) Enter the Etsy API URL Into Apipheny

Go back to your Google Sheet and make sure that the Apipheny add-on is open on the “Import” tab.

With the Import Tab open, enter these details into the add-on:

Method: At the top of the Apipheny sidebar, select the HTTP method (GET or POST) required by your API endpoint. For this example, we are using the GET method.

API URL: In Step 3, we explained how you can find the Etsy API endpoint that you need. Now copy the complete URL into the Apipheny add-on, where it says API URL Path, followed by any GET parameters required for your query.

For this example, we are using the Listing API endpoint, along with active state to get the listings that are currently for sale:

https://openapi.etsy.com/v2/listings/active?api_key=<API_key>

Don’t forget to replace <API_key> with your previously obtained API key.

Headers aren’t required, you can leave those fields blank in Apipheny.

Etsy API request entered into Apipheny
Etsy API request entered into Apipheny

Step 5.) Run the Etsy API Request

Click the Run button at the bottom of the Apipheny add-on and then wait for the Etsy API data to be retrieved and added to your Google spreadsheet:

Etsy data imported into Google Sheets
Etsy data imported into Google Sheets

After making a successful request to the Etsy API, try querying a different endpoint, or try using one of the other features in the Apipheny add-on.

Related articles:

Related Posts