Table: mailchimp_list - Query Mailchimp Lists using SQL
Mailchimp Lists are a fundamental component of the Mailchimp platform. They represent a collection of contacts and subscribers that users can target and manage for marketing campaigns. Lists contain detailed information about subscribers, including their email addresses, subscription status, and other associated data.
Table Usage Guide
The mailchimp_list
table provides insights into Lists within Mailchimp. As a marketing professional or business owner, explore list-specific details through this table, including subscriber count, campaign statistics, and associated metadata. Utilize it to uncover information about your Lists, such as those with high unsubscribe rates, the growth of your lists over time, and the performance of your marketing campaigns.
Examples
Basic info
Gain insights into your Mailchimp lists by identifying their creation dates and visibility settings. This can help you understand the evolution of your email marketing efforts and assess the accessibility of your lists.
select id, name, date_created, visibilityfrom mailchimp_list;
select id, name, date_created, visibilityfrom mailchimp_list;
Get the campaign defaults of each audience
Explore the default settings of each marketing campaign to understand the sender's email and name, the subject line, and the language used. This could be beneficial for assessing consistency in branding or identifying areas for personalization.
select id, campaign_defaults ->> 'from_email' as from_email, campaign_defaults ->> 'from_name' as from_name, campaign_defaults ->> 'subject' as subject, campaign_defaults ->> 'language' as languagefrom mailchimp_list;
select id, json_extract(campaign_defaults, '$.from_email') as from_email, json_extract(campaign_defaults, '$.from_name') as from_name, json_extract(campaign_defaults, '$.subject') as subject, json_extract(campaign_defaults, '$.language') as languagefrom mailchimp_list;
Get the contact information of each audience
Explore which audience members are associated with specific companies and locations. This is useful for tailoring marketing campaigns or communications to specific geographical areas or business sectors.
select id, contact ->> 'company' as company, contact ->> 'address1' as address1, contact ->> 'address2' as address2, contact ->> 'city' as city, contact ->> 'state' as state, contact ->> 'zip' as zip, contact ->> 'country' as country, contact ->> 'phone' as phonefrom mailchimp_list;
select id, json_extract(contact, '$.company') as company, json_extract(contact, '$.address1') as address1, json_extract(contact, '$.address2') as address2, json_extract(contact, '$.city') as city, json_extract(contact, '$.state') as state, json_extract(contact, '$.zip') as zip, json_extract(contact, '$.country') as country, json_extract(contact, '$.phone') as phonefrom mailchimp_list;
Get the stats of each audience
Explore the performance of each audience segment by evaluating statistics such as total contacts, unsubscribe rate, and campaign engagement. This information can be used to understand audience behavior and optimize your marketing strategies.
select id, stats ->> 'member_count' as member_count, stats ->> 'total_contacts' as total_contacts, stats ->> 'unsubscribe_count' as unsubscribe_count, stats ->> 'cleaned_count' as cleaned_count, stats ->> 'member_count_since_send' as member_count_since_send, stats ->> 'unsubscribe_count_since_send' as unsubscribe_count_since_send, stats ->> 'cleaned_count_since_send' as cleaned_count_since_send, stats ->> 'campaign_count' as campaign_count, stats ->> 'campaign_last_sent' as campaign_last_sent, stats ->> 'merge_field_count' as merge_field_count, stats ->> 'avg_sub_rate' as avg_subscribe_rate, stats ->> 'avg_unsub_rate' as avg_unsubscribe_rate, stats ->> 'target_sub_rate' as target_subscribe_rate, stats ->> 'open_rate' as open_rate, stats ->> 'click_rate' as click_rate, stats ->> 'last_sub_date' as last_subscribe_date, stats ->> 'last_unsub_date' as last_unsubscribe_datefrom mailchimp_list;
select id, json_extract(stats, '$.member_count') as member_count, json_extract(stats, '$.total_contacts') as total_contacts, json_extract(stats, '$.unsubscribe_count') as unsubscribe_count, json_extract(stats, '$.cleaned_count') as cleaned_count, json_extract(stats, '$.member_count_since_send') as member_count_since_send, json_extract(stats, '$.unsubscribe_count_since_send') as unsubscribe_count_since_send, json_extract(stats, '$.cleaned_count_since_send') as cleaned_count_since_send, json_extract(stats, '$.campaign_count') as campaign_count, json_extract(stats, '$.campaign_last_sent') as campaign_last_sent, json_extract(stats, '$.merge_field_count') as merge_field_count, json_extract(stats, '$.avg_sub_rate') as avg_subscribe_rate, json_extract(stats, '$.avg_unsub_rate') as avg_unsubscribe_rate, json_extract(stats, '$.target_sub_rate') as target_subscribe_rate, json_extract(stats, '$.open_rate') as open_rate, json_extract(stats, '$.click_rate') as click_rate, json_extract(stats, '$.last_sub_date') as last_subscribe_date, json_extract(stats, '$.last_unsub_date') as last_unsubscribe_datefrom mailchimp_list;
Schema for mailchimp_list
Name | Type | Operators | Description |
---|---|---|---|
_ctx | jsonb | Steampipe context in JSON form. | |
account_id | text | =, !=, ~~, ~~*, !~~, !~~* | The Mailchimp account ID. |
beamer_address | text | The list's email beamer address. | |
campaign_defaults | jsonb | Default values for campaigns created for this list. | |
contact | jsonb | Contact information displayed in campaign footers to comply with international spam laws. | |
date_created | timestamp with time zone | >, >=, <, <=, = | The date and time that this list was created in ISO 8601 format. |
email_type_option | boolean | Whether the list supports multiple formats for emails. | |
id | text | = | A string that uniquely identifies this list. |
list_rating | bigint | An auto-generated activity score for the list (0-5). | |
modules | jsonb | Any list-specific modules installed for this list. | |
name | text | The name of the list. | |
notify_on_subscribe | text | The email address to send subscribe notifications to. | |
notify_on_unsubscribe | text | The email address to send unsubscribe notifications to. | |
permission_reminder | text | The permission reminder for the list. | |
sp_connection_name | text | =, !=, ~~, ~~*, !~~, !~~* | Steampipe connection name. |
sp_ctx | jsonb | Steampipe context in JSON form. | |
stats | jsonb | Stats for the list. Many of these are cached for at least five minutes. | |
subscribe_url_long | text | The full version of this list's subscribe form (host will vary). | |
subscribe_url_short | text | The full version of this list's subscribe form (host will vary). | |
title | text | The title of the resource. | |
use_archive_bar | boolean | Whether campaigns for this list use the Archive Bar in archives by default. | |
visibility | text | Legacy - visibility settings are no longer used Possible values: 'pub' or 'prv'. |
Export
This table is available as a standalone Exporter CLI. Steampipe exporters are stand-alone binaries that allow you to extract data using Steampipe plugins without a database.
You can download the tarball for your platform from the Releases page, but it is simplest to install them with the steampipe_export_installer.sh
script:
/bin/sh -c "$(curl -fsSL https://steampipe.io/install/export.sh)" -- mailchimp
You can pass the configuration to the command with the --config
argument:
steampipe_export_mailchimp --config '<your_config>' mailchimp_list