Search API Connector Documentation

Print

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 API Connector add-on for Google Sheets.

There are 2 ways to connect to the Mailchimp API:

  • Preset “Connect” button (OAuth) premium
  • Personal API key. Please check the appendix for detailed instructions to retrieve your key.

Contents

Before You Begin

Click here to install the API Connector add-on from the Google Marketplace.

Part 1: Connect to the Mailchimp API

If you haven’t connected API Connector to Mailchimp before, you’ll first need to initiate the connection as follows:

  1. Open up Google Sheets and click Add-ons > API Connector > Manage Connections.
  2. In the list of available connections, find Mailchimp and click Connect.
    mailchimp-img1
  3. You will be asked to authorize the connection. Click Allow.
    mailchimp-img2
  4. You’ll then be returned to your Google Sheet, and can verify that your connection is active in the Connections screen.

Part 2: Create Your Mailchimp API Request URL

We’ll first retrieve information about members in an email list.

Base URL: https://YOUR_DATA_CENTER.api.mailchimp.com/3.0
Endpoint: /lists/YOUR_LIST_ID/members

Putting it all together, we get the full API Request URL:

https://us20.api.mailchimp.com/3.0/lists/32d8e317e4/members

You’ll need to substitute in your own values for YOUR_DATA_CENTER and YOUR_LIST_ID, which you can find as follows:

  • YOUR_DATA_CENTER: check the URL when you’re logged in to your Mailchimp account
    mailchimp-api-img4
  • YOUR_LIST_ID: navigate to Audience > Preferences Center > Settings > Audience Name and Defaults. Once you click this, you’ll see your list ID (which they’ve now begun calling an “Audience ID”).
    mailchimp-api-img3

Part 3: Pull Mailchimp API Data into Sheets

Now let’s add our URL into API Connector and get some Mailchimp data in Google Sheets.

  1. Open up Google Sheets and click Add-ons > API Connector > Open.
  2. In the Create screen, enter the Request URL we just created
    mailchimp-img6
  3. Under OAuth, choose Mailchimp
    mailchimp-img7
  4. We don’t need any headers so just leave that section blank.
  5. Create a new tab and click ‘Set current’ to use that tab as your data destination.
  6. Name your request and click Run. A moment later you’ll see your Mailchimp data populate the Mailchimp tab in your Google Sheet:mailchimp-img8

Part 4: Get More Mailchimp Data

If you want to see other data, like a list of campaigns, you’d just change the endpoint. For example, this URL will produce a list of campaigns:

https://us20.api.mailchimp.com/3.0/campaigns

Part 5: Handle Pagination

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.

mailchimp-api-img8

With API Connector, you can either set these up as separate requests or loop through them automatically with pagination handling (paid feature):
URL: https://us20.api.mailchimp.com/3.0/lists/32d8e317e4/members?offset=0&count=1000
Offset parameter: offset
Limit parameter: count
Limit value: 1000
Number of pages: enter the number of pages you’d like to fetch
mailchimp-img10

Appendix: Connect with an API Key

  1. As an alternative to using the preset OAuth integration, you can connect with an API key. 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
    mailchimp-api-img1
  3. You’ll now see your API key listed in a section titled “Your API keys”
    mailchimp-api-img2
  4. To use, under Headers, enter “Authorization” as your Key, and “apikey YOUR_API_KEY” as your Value, like this. Keep OAuth set to None as you’re authorizing with an API key.
    mailchimp-img9
Previous Import LinkedIn Ads Data to Google Sheets
Next Import MapBox Directions Data to Google Sheets

18 thoughts on “Import Mailchimp Data to Google Sheets”

  1. Super product, kudos! Is there a possibility to work with arrays such as are provided through e.g. this (in emails >> activity): https://usXX.api.mailchimp.com/3.0/reports/[campaign_id]/email-activity?count=500&fields=emails.campaign_id,emails.list_id,emails.email_address,emails.activity.timestamp,emails.activity.action,emails.activity.url,emails.activity.type

    Reply
  2. This is great!

    Is there a more efficient way to retrieve data count with 60,000 + rows rather than running the api request 65 times?

    Reply
    • I didn’t know that, but just checked and confirmed that poll data doesn’t seem to be available in the API. That’s unfortunate. Thanks for letting me know.

      Reply
    • This error means there’s an incorrect value into the Header field. Can you please make sure you haven’t included any typos or extra spaces at the beginning or end? If you’d like me to take a look, please feel free to message me a link to your sheet.

      Reply
    • Are survey results the same as poll results? If so, someone in the comments noted that this isn’t available via the API (you can see some more info on this here).

      Reply
  3. Thanks Ana.

    Thanks for your quick reply 🙂
    I already saw this info, but as it dated from 2018, I had hoped that Mailchimp had evolved in the meantime. So, it is not the case 🙁

    From my point of view, a poll is inside emails and his results are values 0-10. The survey is done via a separate form, with others questions than having a answer 0-10: it could be radio-buttons, check-boxes…

    Kind regards,
    Michel.

    Reply
    • Thank you for letting me know! That’s a shame, it was a useful tool. I’ve just updated the article to remove the link.

      Reply

Leave a Comment

Table of Contents