How To Integrate Etsy with Google Sheets [API Tutorial]

How to connect 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:

Install the Apipheny add-on
Create an app and obtain an API key
Obtain an Endpoint URL
Enter the Etsy API URL Into Apipheny
Run the Etsy API request

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

Apipheny is an API connector for Google Sheets. You can use Apipheny to connect your Google Sheets to unlimited API data sources, make unlimited API requests, and more. There is a 30 day free trial included.

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

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.

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

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:

Fields to complete when registering a new app

Click the Read Terms and Create App button:

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

Once your app is approved by the Etsy team, 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

Obtaining an access token

It is against Etsy Terms of Service for developers of 3rd party apps, such as Apipheny, to instruct members to register their own API key. We recommend contacting Etsy support at https://help.etsy.com/hc/en-us/requests/new?ticket_form_id=360000108008#issue_account_trouble_signing_in for instructions on how to get an API key/access token.

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://developer.etsy.com/documentation/reference

The menu on the left contains authentication details and a list of the API’s endpoints categories:

Clicking on a category scrolls to that API’s section, containing a list of associated endpoints. For instance, the SellerTaxonomy category API scrolls to a list of its 2 endpoints (they are named methods in the API documentation): getSellerTaxonomyNodes and getPropertiesByTaxonomyId.

One of the available endpoints is getSellerTaxonomyNodes:

https://openapi.etsy.com/v3/application/seller-taxonomy/nodes

The endpoint’s documentation contains the endpoint name, a short description, the HTTP method used (GET), the URI and response samples:

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

This means any endpoint should be appended to this URL.

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 findAllListingsActive endpoint, along with active state to get the listings that are currently for sale:

https://openapi.etsy.com/v3/application/listings/active

Headers: In the Headers section of the Apipheny add-on, add one row with the following key and value:

Header
Key:
x-api-key
Value:
your_API_key

Make sure to replace your_API_key with your actual API key, in the Header Value.

Step 5.) Run the Etsy API Request

Lastly, 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:

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