Meltwater: Setup guide

Meltwater: Setup guide#

This guide explains how to collect data from Meltwater.

Introduction#

Meltwater is a media intelligence and social listening platform that helps you monitor, analyze, and manage news, social media, and other digital content related to your brand and industry.

Adverity flattens the nested objects returned by the Meltwater API, such as author, content, location, and metrics, into individual columns in your data extract.

Limitations#

Collecting data from Meltwater comes with the following limitations:

  • The Listening report type returns a maximum of 2,000,000 results, regardless of the value you enter in Display limit.

  • Date range limits for the Explore+ Listening report type depend on your organization’s Meltwater package.

Prerequisites#

Before you start collecting data from Meltwater, perform all of the following actions:

  • Have an active Meltwater account with access to the companies and searches you want to collect data from.

Creating a datastream to collect data from Meltwater#

The basics of creating a datastream to collect data from any data source are explained in our guide to Collecting data in Adverity. This guide contains information about the specific steps to create a datastream to fetch data from Meltwater.

Authorization: Allow Adverity to access Meltwater#

Before creating an authorization to give Adverity access to Meltwater, perform the following action:

  1. Create an API key on the Meltwater API page.

To set up a new authorization to fetch data from Meltwater, follow these steps:

  1. In the Authorization step of the datastream wizard, click Access Meltwater using your credentials.

  2. Click Next.

  3. In API Key, enter the API key you created.

  4. Click Authorize.

Configuration: Choose the data you want to collect from Meltwater#

To choose what data to collect and customize the Meltwater datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  2. In Companies, select the company for which to collect data. Adverity uses this selection to filter the searches available in the following steps and when creating the export in Meltwater.

  3. In Report type, select the type of data to collect from Meltwater. The fields you need to configure in the following steps differ according to the report type you select.

  4. If you selected the Listening report type:

    1. In Display limit, enter the maximum number of rows or documents to return. If you leave this field blank, Adverity collects up to 2,000,000 rows, which is also the maximum value you can enter.

    2. In Searches, select the searches for which to collect data. If you do not select any searches, Adverity collects data for all searches.

  5. If you selected the Explore+ Listening report type, in Searches, select the searches for which to collect data. If you do not select any searches, Adverity collects data for all searches.

  6. In Timezone, select the timezone to use for the datastream. The default is UTC.

As a result, your Meltwater datastream is created.

What’s next?#

Contents