Meltwater

Meltwater Listening Analytics API

Analyse multiple types of Meltwater data, run volume time series, top tags and sentiment counts.

GitHub OpenAPI
Business capability
Market Intelligence Management BC-400.30

Operations 12

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v3/analytics/{searchId} Summarize analytics for a saved search · A summary of analytics for a Saved Search #
Ask an LLM
“How much coverage did my saved search get over a time range in Meltwater?”
“Can I get an overall analytics summary limited to one country or language?”
Tell an agent
Summarize analytics for saved search {searchId} from {start} to {end} in {tz}.
Give me the analytics summary for search {searchId} between {start} and {end} ({tz}), only {language} documents from {country}.
GET /v3/analytics/{searchId}/top_tags Rank the top tags and hashtags in a saved search · The top tags that occur in a Saved Search #
Ask an LLM
“Which hashtags show up most in the results of my saved search?”
“Can I get more than the default top 10 tags for a search?”
Tell an agent
Show the top tags for saved search {searchId} from {start} to {end} in {tz}.
List the top {size} hashtags in {source} results for search {searchId} between {start} and {end} ({tz}).
GET /v3/analytics/{searchId}/top_locations Rank the top locations in a saved search · The top locations that occur in a Saved Search #
Ask an LLM
“Where geographically is my saved search being talked about most?”
“Can I break down search coverage by city or state instead of country?”
Tell an agent
Rank the top {level}-level locations for saved search {searchId} from {start} to {end} in {tz}.
Show the top {size} cities mentioned in search {searchId} between {start} and {end} ({tz}), level {level}.
GET /v3/analytics/{searchId}/top_shared Rank the most shared documents in a saved search · The top shared documents that occur in a Saved Search #
Ask an LLM
“Which posts matching my saved search were shared the most?”
“Can I rank the most shared documents by retweets instead of another share metric?”
Tell an agent
Show the most shared documents for saved search {searchId} from {start} to {end} in {tz}, ranked by {sort_by}.
Get the top {size} documents by {sort_by} for search {searchId} between {start} and {end} ({tz}).
GET /v3/analytics/{searchId}/top_entities Rank the top named entities in a saved search · The top named entities that occur in a Saved Search #
Ask an LLM
“Which people, brands and organizations are named most in my saved search?”
“Can I see the top named entities only in negative coverage?”
Tell an agent
List the top named entities for saved search {searchId} from {start} to {end} in {tz}.
Show the top named entities in {sentiment} documents for search {searchId} between {start} and {end} ({tz}).
GET /v3/analytics/{searchId}/top_sources Rank the top sources and authors in a saved search · The top sources that occur in a Saved Search #
Ask an LLM
“Which outlets or authors produce the most results for my saved search?”
“Can I leave out low-authority sources when ranking who covers us?”
Tell an agent
Rank the top sources for saved search {searchId} from {start} to {end} in {tz}.
Show the top authors for search {searchId} between {start} and {end} ({tz}) with authority score at least {min_authority}.
GET /v3/analytics/{searchId}/top_keyphrases Rank the top keyphrases in a saved search · The top keyphrases that occur in a Saved Search #
Ask an LLM
“What phrases keep coming up in coverage matched by my saved search?”
“Can I pull the top keyphrases from positive coverage only?”
Tell an agent
List the top keyphrases for saved search {searchId} from {start} to {end} in {tz}.
Show the top {size} keyphrases in {sentiment} documents for search {searchId} between {start} and {end} ({tz}).
GET /v3/analytics/{searchId}/top_mentions Rank the top @mentions in a saved search · The top mentions that occur in a Saved Search #
Ask an LLM
“Which accounts get @mentioned most in my saved search results?”
“Is it possible to see the top mentions from just one source?”
Tell an agent
List the top @mentions for saved search {searchId} from {start} to {end} in {tz}.
Show the top {size} mentioned accounts in {source} for search {searchId} between {start} and {end} ({tz}).
GET /v3/analytics/{searchId}/top_topics Rank the top topics and subtopics in a saved search · The top topics that occur in a Saved Search #
Ask an LLM
“What topics and subtopics dominate my saved search coverage?”
“Can I get a ranked topic breakdown for a single week of a search?”
Tell an agent
Rank the top topics and subtopics for saved search {searchId} from {start} to {end} in {tz}.
Show the top {size} topics in {source} documents for search {searchId} between {start} and {end} ({tz}).
POST /v3/analytics/{searchId}/custom Run a custom analytics query on a saved search · Create a custom analytics request #
Ask an LLM
“Can I build my own analytics breakdown for a saved search instead of the fixed top lists?”
“How do I chart mentions of a saved search filtered by sentiment and country?”
Tell an agent
Run custom analytic {analytic} on saved search {searchId} from {start_date} to {end_date} in {tz}.
Build a custom analysis of saved search {searchId} for {sentiments} mentions in {countries}, {start_date} to {end_date}, tz {tz}.
GET /v3/analytics/custom/catalog List options for custom listening analytics · Fetch the latest custom analytics options #
Ask an LLM
“Which dimensions and measures can I use in a custom analytics request on a saved search?”
“What analytic types are available for custom listening analytics right now?”
Tell an agent
Fetch the catalog of dimensions, measures and analytic types for custom listening analytics.
Show me what I can put in a custom analytics request for my saved searches.

Documentation

📖
Documentation
https://developer.meltwater.com/docs/
📖
GettingStarted
https://developer.meltwater.com/docs/meltwater-api/getting-started/overview/
📖
RateLimits
https://developer.meltwater.com/docs/meltwater-api/getting-started/usage-limits/
📖
APIReference
https://developer.meltwater.com/api-reference/api-reference-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/meltwater/refs/heads/main/openapi/meltwater-listening-analytics-api-openapi.yml

Other Resources

🔗
Endpoints
https://developer.meltwater.com/docs/meltwater-api/reference/endpoints/
🔗
ChangeLog
https://developer.meltwater.com/docs/meltwater-api/help/changelog/
🔗
Concepts
https://developer.meltwater.com/docs/meltwater-api/guides/concepts/
🔗
HowToGuides
https://developer.meltwater.com/docs/meltwater-api/guides/
🔗
Overlay
https://raw.githubusercontent.com/api-evangelist/meltwater/refs/heads/main/overlays/meltwater-listening-analytics-api-overlay.yaml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/meltwater:meltwater-listening-analytics-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

meltwater-listening-analytics-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Meltwater Listening Analytics API
  description: The Meltwater Public API
  contact:
    name: Meltwater Support
    url: https://developer.meltwater.com/
    email: support@api.meltwater.com
  version: '1.0'
servers:
- url: https://api.meltwater.com
security:
- apikey: []
tags:


# --- truncated at 32 KB (105 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/meltwater/refs/heads/main/openapi/meltwater-listening-analytics-api-openapi.yml