Welcome to your go-to guide on the Meltwater API!
The Meltwater API is an additional tool available to be added to your Meltwater subscription.
If you are an existing API customer, and you have a technical question about your current API setup, please reach out using the API support portal.
What is the Meltwater API?
The Meltwater API enables customers to integrate insights from media and social data across their business.
'Connect the dots' with other business data
Analyze your online data alongside internal business data. Measure how media and social engagement impacts your bottom line.
Streamline your reporting processes
Automate & consolidate reporting on media and social activity. Remove manual processes and human error from your reporting.
Realize additional value from media & social data
Trigger workflows from business signals, make media & social part of your sales intelligence, the possibilities are endless.
Meltwater API features
The Meltwater API allows you to bring content and analytics from the Meltwater platform into your tools and workflows.
Export media articles and social mentions that match your Meltwater searches and tags.
Set up scheduled exports for regular reporting tasks.
Run historic one-off exports for research and planning projects.
Export larger volumes of data than available through the Meltwater application.
Fetch metrics and analytics
Fetch analysis and metrics for your Meltwater searches.
Analyze trends and topics.
Study high volume topics, without needing to fetch large numbers of documents.
Connect with your internal tools
Bring your exported data and analytics into any tool that understands CSV or JSON data formats.
Use Meltwater's off-the-shelf BI tool connectors to build reports on media and social data.
Build automated solutions
Develop in-house custom solutions that integrate Meltwater data into your workflows.
Programmatically manage searches, content exports, and analysis requests.
Automate your processes and remove human error.
How does the API work?
To help you understand more about how the API works check out the steps below:
First, reference the Developer QuickStart page.
Note that you need access to the “Data Streams” feature in your API package to use this feature. This is an add-on and not included in the base API packages.
To stream earned media using the API, you need to provide a Saved Search ID, and a destination URL for where you would like data pushed to.
When you create a new data stream the platform will listen for any new documents coming into the platform that match your search. Any matches will immediately be pushed to your destination URL. These matches (documents) will contain a number of fields such as the URL, title, content, sentiment, and so on.
The fields available for documents depend on the source of the document. See the Exports Formats and Fields page for full details.
The quickest way to get familiar with data streaming is by reading the Data Streams - Quickstart Guide.
Getting access to the Meltwater API
The Meltwater API is an additional tool available to be added to your Meltwater subscription. Your account manager will work closely with you during your API initial setup.
We offer a range of API packages, depending on your needs. Pricing is based upon:
The number of content exports you'd like to run each month
The volume of mentions/documents you expect to export per month
The number of analytics calls you'd like to run per day
The option to access real-time streaming of listening data via Data Streams
For more technical details on the API features, take a look at our developer site.
Data use and restrictions
Data use is intended as an add-on for Media/Social Intelligence use-cases.
Data is intended for internal use, not commercial software products.
News: We do not provide article text.
We provide title, ingress/summary. Factiva (Dow Jones) content is not provided due to content restrictions. We do not bypass paywalls.
Social: Terms of Service Compliance for Twitter
We cannot provide the Tweet Text. ‘Hit Sentence’ will be empty as it would provide the text. We provide a Tweet ID that customers can use to ‘rehydrate’ text using the Twitter API themselves.
Other market restrictions
Due to our contracts with our data providers, there may be other restrictions on the data we can provide in your market. Your account manager will explain these restrictions.
Need more help? Feel free to reach out to us via Live Chat or check out our Customer Community.
Find answers and get help from Meltwater Support and Community Experts.