Meltwater
Search and analyze Meltwater media intelligence data, manage Listening and Explore+ assets, import content, run Mira AI, and monitor exports, mentions, hooks, and owned-social activity.
Tools
| Name | Description |
|---|---|
list_companiesList Meltwater companies available to the API token. | List Meltwater companies available to the API token. |
list_workspacesList Meltwater workspaces available to the API token. | List Meltwater workspaces available to the API token. |
list_tokensList Meltwater API tokens visible to the current token. | List Meltwater API tokens visible to the current token. |
get_usage_requestsGet request usage statistics for the current Meltwater token. | Get request usage statistics for the current Meltwater token. |
get_usage_metricGet Meltwater quota usage for exports, streaming, search, or imports. | Get Meltwater quota usage for exports, streaming, search, or imports. |
list_saved_searchesList Meltwater Listening saved searches. | List Meltwater Listening saved searches. |
create_saved_searchCreate a Meltwater Listening saved search using the v3 search schema. | Create a Meltwater Listening saved search using the v3 search schema. |
get_saved_searchFetch a Meltwater saved search by ID. | Fetch a Meltwater saved search by ID. |
update_saved_searchUpdate a Meltwater saved search by ID. | Update a Meltwater saved search by ID. |
delete_saved_searchDelete a Meltwater saved search by ID. | Delete a Meltwater saved search by ID. |
count_saved_search_mentionsCount mentions for a Meltwater saved search over an optional date range. | Count mentions for a Meltwater saved search over an optional date range. |
search_saved_search_mentionsSearch earned media/social mentions for a saved search with Meltwater v3 Listening filters. | Search earned media/social mentions for a saved search with Meltwater v3 Listening filters. |
list_filter_setsList Meltwater Listening filter sets. | List Meltwater Listening filter sets. |
list_custom_categoriesList Meltwater custom categories for Listening filters and exports. | List Meltwater custom categories for Listening filters and exports. |
list_tagsList Meltwater tags. | List Meltwater tags. |
create_tagCreate a Meltwater tag. | Create a Meltwater tag. |
delete_tagDelete a Meltwater tag by ID. | Delete a Meltwater tag by ID. |
list_one_time_exportsList Meltwater one-time Listening exports. | List Meltwater one-time Listening exports. |
create_one_time_exportCreate a one-time Meltwater Listening export. | Create a one-time Meltwater Listening export. |
get_one_time_exportFetch a one-time Meltwater export by ID. | Fetch a one-time Meltwater export by ID. |
delete_one_time_exportDelete a one-time Meltwater export by ID. | Delete a one-time Meltwater export by ID. |
list_recurring_exportsList Meltwater recurring Listening exports. | List Meltwater recurring Listening exports. |
create_recurring_exportCreate a recurring Meltwater Listening export. | Create a recurring Meltwater Listening export. |
get_recurring_exportFetch a recurring Meltwater export by ID, including previous runs when available. | Fetch a recurring Meltwater export by ID, including previous runs when available. |
delete_recurring_exportDelete a recurring Meltwater export by ID. | Delete a recurring Meltwater export by ID. |
fetch_export_data_urlFetch a signed Meltwater export data_url as text or JSON. Useful after an export reaches FINISHED. | Fetch a signed Meltwater export data_url as text or JSON. Useful after an export reaches FINISHED. |
get_analytics_summaryGet summary analytics for a Meltwater saved search. | Get summary analytics for a Meltwater saved search. |
get_top_tagsGet top tag analytics for a saved search. | Get top tag analytics for a saved search. |
get_top_locationsGet top location analytics for a saved search. | Get top location analytics for a saved search. |
get_top_sharedGet top shared documents for a saved search. | Get top shared documents for a saved search. |
get_top_entitiesGet top entity analytics for a saved search. | Get top entity analytics for a saved search. |
get_top_sourcesGet top source analytics for a saved search. | Get top source analytics for a saved search. |
get_top_keyphrasesGet top keyphrase analytics for a saved search. | Get top keyphrase analytics for a saved search. |
get_top_mentionsGet top mention analytics for a saved search. | Get top mention analytics for a saved search. |
get_top_topicsGet top topic analytics for a saved search. | Get top topic analytics for a saved search. |
get_top_shared_linksGet top shared-link analytics for a saved search. | Get top shared-link analytics for a saved search. |
get_analytics_catalogList dimensions, measures, and analytic types supported by Meltwater custom analytics. | List dimensions, measures, and analytic types supported by Meltwater custom analytics. |
run_custom_analyticsRun a Meltwater custom analytics request for a saved search. | Run a Meltwater custom analytics request for a saved search. |
get_document_count_analyticsRun a document_count custom analytics request. | Run a document_count custom analytics request. |
get_top_terms_analyticsRun a top_terms custom analytics request for a dimension. | Run a top_terms custom analytics request for a dimension. |
get_count_unique_analyticsRun a count_unique custom analytics request for a dimension. | Run a count_unique custom analytics request for a dimension. |
get_measure_statistics_analyticsRun a measure_statistics custom analytics request. | Run a measure_statistics custom analytics request. |
get_date_histogram_analyticsRun a date_histogram custom analytics request. | Run a date_histogram custom analytics request. |
import_documentsIngest Bring Your Own Content documents into Meltwater imports. | Ingest Bring Your Own Content documents into Meltwater imports. |
list_import_batchesList Meltwater BYOC import batches. | List Meltwater BYOC import batches. |
get_import_batchFetch a Meltwater BYOC import batch by batch ID. | Fetch a Meltwater BYOC import batch by batch ID. |
get_import_tagFetch Meltwater import-tag status and statistics. | Fetch Meltwater import-tag status and statistics. |
list_owned_accountsList owned social accounts connected in Meltwater. | List owned social accounts connected in Meltwater. |
list_owned_supported_metricsList owned-social sources and metrics supported by Meltwater. | List owned-social sources and metrics supported by Meltwater. |
get_owned_numeric_metricsGet numeric owned-social metrics for Facebook, Instagram, LinkedIn, X/Twitter, or TikTok accounts. | Get numeric owned-social metrics for Facebook, Instagram, LinkedIn, X/Twitter, or TikTok accounts. |
get_owned_breakdown_metricsGet owned-social breakdown metrics for Facebook or Instagram accounts. | Get owned-social breakdown metrics for Facebook or Instagram accounts. |
get_owned_nested_breakdown_metricsGet owned-social nested breakdown metrics for Facebook or Instagram accounts. | Get owned-social nested breakdown metrics for Facebook or Instagram accounts. |
get_owned_heatmap_metricsGet owned-social heatmap metrics for Facebook or Instagram accounts. | Get owned-social heatmap metrics for Facebook or Instagram accounts. |
get_owned_top_postsGet top owned-social posts by selected metrics. | Get top owned-social posts by selected metrics. |
list_hooksList Meltwater Data Stream hooks. Push delivery verification is tracked as a platform raw-body webhook gap. | List Meltwater Data Stream hooks. Push delivery verification is tracked as a platform raw-body webhook gap. |
create_hookCreate a Meltwater Data Stream hook for a saved search target URL. This manages the provider hook but does not make Weavz claim verified push delivery. | Create a Meltwater Data Stream hook for a saved search target URL. This manages the provider hook but does not make Weavz claim verified push delivery. |
get_hookFetch a Meltwater Data Stream hook by ID. | Fetch a Meltwater Data Stream hook by ID. |
delete_hookDelete a Meltwater Data Stream hook by ID. | Delete a Meltwater Data Stream hook by ID. |
list_explore_searchesList Explore+ private-index searches. | List Explore+ private-index searches. |
list_explore_search_foldersList Explore+ search folders. | List Explore+ search folders. |
get_explore_searchFetch an Explore+ search by ID. | Fetch an Explore+ search by ID. |
create_explore_searchCreate an Explore+ search asset. | Create an Explore+ search asset. |
update_explore_searchUpdate an Explore+ search asset. | Update an Explore+ search asset. |
delete_explore_searchDelete an Explore+ search asset. | Delete an Explore+ search asset. |
search_explore_private_indexSearch earned data in an Explore+ private index. | Search earned data in an Explore+ private index. |
run_explore_custom_analyticsRun a custom analytics request against an Explore+ private index. | Run a custom analytics request against an Explore+ private index. |
get_explore_analytics_catalogList Explore+ custom analytics dimensions, measures, and types. | List Explore+ custom analytics dimensions, measures, and types. |
list_explore_custom_fieldsList Explore+ custom fields. | List Explore+ custom fields. |
list_explore_custom_field_foldersList Explore+ custom field folders. | List Explore+ custom field folders. |
get_explore_custom_fieldFetch an Explore+ custom field by ID. | Fetch an Explore+ custom field by ID. |
create_explore_custom_fieldCreate an Explore+ custom field. | Create an Explore+ custom field. |
update_explore_custom_fieldUpdate an Explore+ custom field. | Update an Explore+ custom field. |
delete_explore_custom_fieldDelete an Explore+ custom field. | Delete an Explore+ custom field. |
create_explore_custom_field_valueCreate a value for an Explore+ custom field. | Create a value for an Explore+ custom field. |
get_explore_custom_field_valueFetch an Explore+ custom field value. | Fetch an Explore+ custom field value. |
update_explore_custom_field_valueUpdate an Explore+ custom field value. | Update an Explore+ custom field value. |
delete_explore_custom_field_valueDelete an Explore+ custom field value. | Delete an Explore+ custom field value. |
create_explore_assignment_ruleCreate an assignment rule for an Explore+ custom field value. | Create an assignment rule for an Explore+ custom field value. |
get_explore_assignment_ruleFetch an Explore+ assignment rule. | Fetch an Explore+ assignment rule. |
update_explore_assignment_ruleUpdate an Explore+ assignment rule. | Update an Explore+ assignment rule. |
delete_explore_assignment_ruleDelete an Explore+ assignment rule. | Delete an Explore+ assignment rule. |
list_v4_content_exportsList Meltwater v4 content exports. v4 is currently used for newer Explore+ export features. | List Meltwater v4 content exports. v4 is currently used for newer Explore+ export features. |
create_v4_content_exportCreate a Meltwater v4 content export. This beta/newer surface is intentionally body-JSON first. | Create a Meltwater v4 content export. This beta/newer surface is intentionally body-JSON first. |
get_v4_content_exportFetch a Meltwater v4 content export by ID. | Fetch a Meltwater v4 content export by ID. |
delete_v4_content_exportDelete a Meltwater v4 content export by ID. | Delete a Meltwater v4 content export by ID. |
list_mira_projectsList Meltwater Mira projects available to the current user/token. | List Meltwater Mira projects available to the current user/token. |
mira_chatSend a non-streaming prompt to Meltwater Mira, optionally in an existing thread/project. | Send a non-streaming prompt to Meltwater Mira, optionally in an existing thread/project. |
mira_responsesSend non-streaming multi-message input to Meltwater Mira responses. | Send non-streaming multi-message input to Meltwater Mira responses. |
custom_api_callMake a bounded Meltwater API call under https://api.meltwater.com/v3 or /v4 using the configured API token. | Make a bounded Meltwater API call under https://api.meltwater.com/v3 or /v4 using the configured API token. |
Triggers
| Name | Description |
|---|---|
new_listening_mentionTriggers when a saved-search mention appears after the initial baseline. | Triggers when a saved-search mention appears after the initial baseline. |
new_explore_mentionTriggers when an Explore+ private-index document appears after the initial baseline. | Triggers when an Explore+ private-index document appears after the initial baseline. |
one_time_export_finishedTriggers when a one-time Meltwater export transitions to FINISHED after the initial baseline. | Triggers when a one-time Meltwater export transitions to FINISHED after the initial baseline. |
recurring_export_run_finishedTriggers when a new finished recurring-export run appears after the initial baseline. | Triggers when a new finished recurring-export run appears after the initial baseline. |
new_owned_top_postTriggers when a new owned-social top post appears after the initial baseline. | Triggers when a new owned-social top post appears after the initial baseline. |
hook_status_changedTriggers when a Meltwater Data Stream hook status changes after the initial baseline. | Triggers when a Meltwater Data Stream hook status changes after the initial baseline. |
import_batch_finishedTriggers when a new finished BYOC import batch appears after the initial baseline. | Triggers when a new finished BYOC import batch appears after the initial baseline. |
Quick Start
import { WeavzClient } from '@weavz-io/sdk'
const weavz = new WeavzClient({ apiKey: 'wvz_...' })
const result = await weavz.actions.execute('meltwater', 'list_companies', {
workspaceId: '550e8400-e29b-41d4-a716-446655440000',
integrationAlias: 'meltwater',
input: { /* ... */ },
})Related Integrations
Works well with
Frequently Asked Questions
How do I connect Meltwater to my app?
Use Weavz Hosted Connect for API Key authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.
What tools does Meltwater support?
Meltwater supports 89 tools including List Companies, List Workspaces, List API Tokens, Get Request Usage, Get Usage Metric, and more.
Can I use Meltwater with AI agents?
Yes. Add Meltwater to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.
How do I connect Meltwater to ChatGPT or Claude?
Open the Weavz connector setup, sign in, choose a workspace, and add Meltwater as an approved app. ChatGPT, Claude, and other remote MCP clients can then call the scoped Meltwater tools exposed by that workspace.
Does Meltwater work with Claude Code, Cursor, Codex, and local agents?
Yes. Remote and local MCP clients can connect to a Weavz MCP endpoint for the workspace. Local coding agents can also use the Weavz CLI to inspect apps, discover actions, run approved Meltwater work, and execute Code Mode workflows from a terminal.
What can I ask an AI agent to do with Meltwater?
Meltwater exposes 89 tools, including List Companies, List Workspaces, List API Tokens, Get Request Usage, Get Usage Metric, and more. Use Weavz to keep credentials scoped, require approval for sensitive work, and audit what the agent did.
Can Meltwater be used in stateful agent workflows?
Yes. Agents can combine Meltwater tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.
What authentication does Meltwater use?
Meltwater uses API Key. Weavz stores credentials securely and uses them for authorized action execution.
How much does the Meltwater integration cost?
The Meltwater integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.
What triggers does Meltwater support?
Meltwater supports 7 triggers including New Listening Mention, New Explore+ Mention, One-Time Export Finished, Recurring Export Run Finished, New Owned Top Post, and more.
Connect Meltwater in minutes
Get 20,000 free action executions every month. No credit card required.