Import Mailchimp Data to Google Sheets

In this guide, we’ll walk through how to pull data from the Mailchimp API directly into Google Sheets, using the free API Connector add-on for Google Sheets. We'll first get an API key from Mailchimp, and then set up a request to pull in email campaign details from your Mailchimp account to your spreadsheet.

• Part 1: Get your Mailchimp API Key
• Part 2: Create your API Request URL
• Part 3: Enter values into API Connector
• Part 4: Notes and Expansions

PART 1: GET YOUR MAILCHIMP API KEY

1. Log into your Mailchimp account and navigate to the API Keys section (or just click this link: https://us1.admin.mailchimp.com/account/api/)
2. Click the Create A Key button
   
3. You'll now see your API key listed in a section titled "Your API keys"
   
4. Congrats, that's it! You now have access to the Mailchimp API, and can start pulling Mailchimp data into Google Sheets.

PART 2: CREATE YOUR API REQUEST URL

We’re going to follow the Mailchimp API documentation to retrieve information about members in an email list.

Mailchimp base URL: https://us{data_center_ID}.api.mailchimp.com/3.0
Example: https://us20.api.mailchimp.com/3.0/

Endpoint: /lists/{list_id}/members
Example: /lists/32d8e317e4/members

Putting it all together, we get the full API Request URL:
https://us20.api.mailchimp.com/3.0/lists/32d8e317e4/members

Of course, you'll need to substitute in your own values for {data_center} and {list_id}, which you can find as follows:

• {data_center_ID}: check the URL when you're logged in to your Mailchimp account
  
• {list_id}: navigate to Settings > Audience Name and Defaults. Once you click this, you'll see your list ID (which they've now begun calling an "Audience ID").
  

PART 3: ENTER VALUES INTO API CONNECTOR

We’re now ready to enter all our values into API Connector to start importing Mailchimp data into Google Sheets.

1. Open up Google Sheets and click Add-ons > API Connector >  Create New API Request
2. In the Create Request interface, enter the Request URL we just created
   
3. Under Headers, enter Authorization as your Key, and apikey {your API key} as your Value, like this (the curly brackets indicate where need to substitute in your actual API key):
   

   Authorization

   apikey {your API key}

   It should look like this:
   

4. Create a new tab. You can call it whatever you like, but here we'll call it 'Mailchimp Members'. While still in that tab, click 'Set' to use that tab as your data destination.
5. Name your request. Again we'll call it 'Mailchimp Members'
6. Click Run and a moment later you’ll see your Mailchimp data populate the Mailchimp tab in your Google Sheet:
   

PART 4: NOTES AND EXPANSIONS

1. If you want to see other data, like a list of campaigns, you'd just change the endpoint. For example, https://us20.api.mailchimp.com/3.0/campaigns will give you a list of your campaigns.
2. Note Mailchimp’s limits on the number of records returned on a response. By default, only 10 records will be returned unless you use the ‘count’ and ‘offset’ parameters as described in their documentation.
   

   To get more records, use the 'count' and 'offset' parameters, like this:
   page 1: https://us20.api.mailchimp.com/3.0/campaigns?offset=0&count=1000
   page 2: https://us20.api.mailchimp.com/3.0/campaigns?offset=1000&count=1000

   With API Connector, you can either set these up as separate requests or run them simultaneously (paid feature) for added efficiency.

3. The Mailchimp API Playground is a great resource to test out different API calls.