Updated on

Oct 19, 2023


Meltwater is the leading media monitoring & social analytics platform dedicated to helping businesses monitor, understand, and influence the world around them.

Schema information

The schema information shows all report types you can use to extract data from Meltwater.

Setup guide

Follow our setup guide to connect Meltwater to Improvado.

Step 1. Click the Data Sources in the left navigation bar.
Categories on the Data sources page group all available platforms. Use a search to find the required one.

Step 2. Click on the Meltwater tile.

Step 3. To authorize your account you need to fill in the required fields below following steps 3.1 - 3.3:

  • API Key
  • Timezone - it is better to use the Joda time zone (Canonical ID).

{% docs-informer info %}

Be careful with the amount of data requested because reports spend a lot of API units: 1 unit per 1 search id in 1 report per 1 week for 1 source.

{% docs-informer-end %}

Step 3.1. Provide us with a list of Search IDs via Service Desk.

  1. Raise a Service Desk ticket and provide a list of Search IDs by following the instructions below.
    We will manually add the items you provided to each order. Otherwise, no records will be extracted from the API.
  2. Fill in the ticket’s Summary field with this text: ```Add Search IDs to Meltwater extraction orders```.
  3. List necessary Search IDs (comma-separated) in Description using this template:
    ```<account_name> - <report_type> - <id_1,id_2,...,id_n>```.

{% docs-informer info title="Important" %}

Ensure that extraction orders you specified should be already set up before the ticket is created.
You can learn more about extraction orders here.

{% docs-informer-end %}

  1. You can see an example of a correctly filled-out ticket form below:

Step 3.2. Generate Meltwater API Key.

  1. Go to Account > Meltwater API in the application's left-hand navigation.
  2. Click Generate API token.
  3. Enter a name for the token and click OK.
  4. Once the token is generated, copy it.

Step 3.3. Enter copied values into the Improvado authorization form.

Also, you can find the additional information here API Credentials - Meltwater Developer Portal.

Step 4. After the connection process is completed successfully, Meltwater connection will appear in your Connected sources list.

Step 5. When the connection status is Active, and the account status column shows a number of accounts, you can move on to data extraction.

Step 6. To extract data from the connected sources, check the instruction on how to set up data extraction.


No items found.


Troubleshooting guides

Check out troubleshooting guides for


You can find information about the latest API changes in the official Release notes.

Frequently asked questions

No items found.
☶ On this page
Related articles
No items found.
No items found.


Improvado team is always happy to help with any other questions you might have! Send us an email.

Contact your Customer Success Manager or raise a request in Improvado Service Desk.