Skip to main content

Changelog

On this page we inform you about changes to the Meltwater API.

7 April 2026 — Bring Your Own Content (BYOC) - New origin platform added - Telegram​

The BYOC API now supports telegram as an origin platform. You can submit documents with originPlatform: "telegram" and the following content types: post, comment, reply, repost, quoted.

3 March 2026 — Usage statistics per API token​

The Usage Data page in the Meltwater application now shows usage broken down by API token. Use the token selector dropdown at the top of the page to view usage for a specific token.

Additionally, the GET usage/me/metrics/{metric} and GET usage/me/requests API endpoints now accept an optional token_id query parameter to filter usage by API token.

12 January 2026 — Bring Your Own Content (BYOC) - Adding duplicate detection and monitoring imported data​

We've added support for duplicate detection when importing documents via the BYOC API for TikTok. This feature helps prevent the ingestion of duplicate content by checking for existing documents with the same unique identifiers before adding new entries.

For more information please read the BYOC Monitoring Imported Data guide.

26 November 2025 — Bring Your Own Content (BYOC) - New field added - user.imageUrl​

We have expanded the BYOC API schema to include a new optional field user.imageUrl in the document payload. This field allows you to specify a URL for the user's profile image associated with the document being submitted.

13 November 2025 — Bring Your Own Content (BYOC) - Explore+ Custom Fields​

We have added support for custom fields in the Bring Your Own Content (BYOC) API when using Explore+. This enhancement allows you to attach additional metadata to your documents, enabling more granular categorisation and analysis within Explore+.

For more information, see the Explore+ Custom Fields guide.

30 September 2025 — Bring Your Own Content (BYOC) - Frequently Asked Questions​

We have compiled a collection of the most frequently asked questions about the Bring Your Own Content (BYOC) API.

22 September 2025 — Bring Your Own Content (BYOC) - unique id within a batch​

Starting now, the id field must be unique within each batch of submitted documents. If duplicate IDs are detected, the entire batch will be rejected with a 400 Bad Request error.

This change improves the reliability of import progress tracking and makes it easier to spot unintended duplicates.

9 September 2025 — Bring Your Own Content (BYOC) - data monitoring​

We've added support for monitoring imported documents and their progress.

For more information please read the BYOC Monitoring Imported Data guide.

8 September 2025 — Bring Your Own Content (BYOC) - data management​

We've added support for deleting imported documents and updated the documentation on how to reliably identify documents for updates and deletions.

For more information please read the BYOC Managing Imported Data guide.

13 August 2025 — Bring Your Own Content (BYOC) - batch size increased to 500​

We have increased the batch size for the Bring Your Own Content (BYOC) API to 500 documents per request. This allows you to upload larger batches of your own content more efficiently, reducing the number of API calls needed for bulk uploads.

1 August 2025 — Bring Your Own Content (BYOC) API now available​

You can now bring your own content into the Meltwater platform using the new Bring Your Own Content (BYOC) API. This feature allows you to seamlessly integrate your own data with Meltwater's native data sources, enabling consistent enrichment, analytics, and discovery across all Meltwater products.

For more information please read the Bring Your Own Content API overview.

1 July 2025 — Explore+ API now available​

The Explore+ API is now available, providing access to Explore+ assets and analytics through the Meltwater API.

26 June 2025 — Search Earned Media Documents​

You can now search earned media documents using the Meltwater API, allowing you to fetch individual mentions matching your searches and filters.

23 April 2025 — Tagging Earned Media Documents​

You can now manage tags on earned media documents using the Meltwater API.

31 March 2025 — Applying Custom Categories to API Exports​

You can now apply custom categories to your API exports.

21 October 2024 — Facebook deprecated metrics​

Several Facebook metrics have been deprecated and are no longer available through the API.

25 July 2024 — Custom Earned Analytics - BETA​

Custom earned media analytics are now available in BETA, allowing you to build more flexible analytics queries.

31 May 2024 — Tag filtering on Owned Social​

You can now filter owned social posts by tags when using the top posts endpoint.

9 May 2024 — Additional Earned Media analytics options​

Additional dimensions and measures are now available for earned media analytics.

25 April 2024 — New output templates for export and streaming​

New output templates are now available for export and streaming responses.

3 January 2024 — Improved Combined Search Management​

Improvements have been made to combined search management, including the ability to expand combined searches.

5 December 2023 — Omnichannel analytics​

Omnichannel analytics are now available, allowing you to analyse data across multiple channels.

31 October 2023 — Enhanced Owned Social API with Additional Sources and Metrics​

The Owned Social API has been enhanced with additional sources and metrics.

26 October 2023 — Sampling on the Export API​

Sampling is now available on the Export API, allowing you to work with representative subsets of your data.

28 July 2023 — New sources, Kakaotalk and LineVoom added to the Meltwater API​

Kakaotalk and LineVoom are now available as sources for exports, analytics, and streaming.

9 June 2023 — Notification of Support Link Change​

The Meltwater support link has been updated.

3 April 2023 — Notification of Completed Migration​

The migration of MI category searches to Explore category searches is now complete. See the API Changes 2023 guide for more details.

8 March 2023 — Exports - Views data returned in export results​

Views data is now returned in export results.

12 January 2023 — Notification of upcoming breaking changes​

Notification of breaking changes scheduled for 3rd April 2023. See the API Changes 2023 guide for full details.

18 March 2022 — Improved Language Detection​

Language detection has been improved across all content types.

25 February 2022 — New Owned Social Analytics features​

New owned social analytics features have been added, including additional metrics and analysis types.

4 November 2021 — Changes to YouTube data availability​

Changes have been made to the availability of YouTube data in line with compliance requirements.

4 November 2021 — API credentials are now managed in the Meltwater application​

API credentials can now be managed directly in the Meltwater application.

21 October 2021 — Exports - New document hashtags field​

A new document_hashtags field has been added to export results.

23 September 2021 — Changes to accessing usage statistics​

Changes have been made to how usage statistics can be accessed via the API.

17 September 2021 — Support for creating and updating Explore category searches​

Full support for creating and updating Explore category searches is now available.

7 September 2021 — New source Little Red Book has been added to the Meltwater API​

Little Red Book (Xiaohongshu) is now available as a source for exports, analytics, and streaming.

31 August 2021 — New sources, Douyin and WeChat added to the Exports API​

Douyin and WeChat are now available as sources for exports.

20 August 2021 — New sources, Douyin and WeChat added to the Meltwater Analytics API​

Douyin and WeChat are now available as sources for analytics.

10 August 2021 — New sources, Twitch, TikTok and Pinterest added to the Meltwater API​

Twitch, TikTok and Pinterest are now available as sources across exports, analytics, and streaming.

7 July 2021 — Opening Text for Facebook and Instagram sources​

Opening text is now available for Facebook and Instagram content.

8 February 2021 — Support for Facebook and Instagram in exports and analytics​

Facebook and Instagram are now available as sources for exports and analytics.

1 February 2021 — Analytics - Expanding top languages and top country codes​

The top languages and top country codes analytics endpoints now support a broader range of language codes and countries.

4 December 2020 — Exports - Additional fields for export results​

Additional fields have been added to export results.

13 November 2020 — Analytics API - Multi-company support and Author Count Analysis​

Multi-company support and Author Count analysis are now available in the Analytics API.

2 November 2020 — New analytics endpoints - top keyphrases, top locations, top entities​

New analytics endpoints are now available for top keyphrases, top locations, and top entities analysis.

21 September 2020 — Upcoming changes to Twitter & YouTube data​

Notification of upcoming changes to Twitter and YouTube data fields. See the Compliance Changes page for full details.

7 September 2020 — Announcing API version 3​

Announcing the launch of Meltwater API version 3, consolidating the Export API and Analytics API into a single consistent API. See the Migration to V3 guide for details.

27 February 2020 — Removing data_url for INCOMPLETE one-time exports​

The data_url field is no longer returned for INCOMPLETE one-time exports.

12 December 2019 — Adding Social Echo for Reddit​

Social Echo is now available for Reddit documents.

26 November 2019 — Searches from Explore now fully available in the Export API​

Searches created in the Explore interface are now fully available for use with the Export API.

12 November 2019 — Adding new reach fields to editorial documents​

New reach fields have been added to editorial (news) documents.

20 September 2019 — Removing country from /companies endpoint​

The country field has been removed from the /companies endpoint.

11 February 2019 — Simplified setup for exports based on tags​

The setup process for creating exports based on tags has been simplified.

9 January 2019 — Added two fields document_earned_traffic and document_hidden​

Two new fields have been added to export results: document_earned_traffic and document_hidden.

8 January 2019 — Support for exports based on tags​

You can now create exports based on tags, in addition to searches.