How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Meltwater Listening Search Management API

Manage Saved Searches

Meltwater Listening Search Management API is one of 14 APIs that Meltwater publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Listening Search Management. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a getting-started guide, a changelog, rate-limit docs, and an API reference.

This API exposes 13 operations across 9 paths, and defines 38 schemas. It is described by OpenAPI 3.0.3, at version 1.0.

Requests are made against a single base URL, https://api.meltwater.com.

13 operations 9 paths 38 schemas 2 DELETE6 GET4 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0
Base URL
https://api.meltwater.com
Authentication
API Key
Resource Areas
1

Authentication & Security 1

Meltwater Listening Search Management API declares 1 security scheme for authenticating requests. An API key is passed in the header as apikey (apikey). By default, every request must be authenticated.

Paths & Operations 13

Across 9 paths, the API surfaces 13 operations — 2 DELETE, 6 GET, 4 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Listening Search Management 13

Manage Saved Searches

GET
/v3/searches
Get a list of all your searches
list_searches 3 params → 200400401403409422500503
POST
/v3/searches
Create a search
create_search 1 param body → 201400401403409422500503
GET
/v3/searches/{id}
Get an individual search
get_search 3 params → 200404400401403409422500
PUT
/v3/searches/{id}
Update an individual search
update_search 2 params body → 200404400401403409422500
DELETE
/v3/searches/{id}
Delete an individual search
delete_search 2 params → 204404400401403409422500
GET
/v3/searches/{id}/count
Get an approximate count of results for the search over a particular period
search_count 4 params → 200404400401403409422500
GET
/v3/tags
Get a list of all your tags
list_tags 1 param → 200400401403409422500503
POST
/v3/tags
Create a new tag
1 param body → 201400401500
DELETE
/v3/tags/{tag_id}
Delete an existing tag.
2 params → 204400401500
POST
/v3/documents/add_tags
Add tags to documents
add_tags 1 param body → 202400401500
POST
/v3/documents/remove_tags
Remove tags from documents
remove_tags 1 param body → 202400401500
GET
/v3/filter_sets
Get a list of all search filter sets
list_filter_sets 2 params → 200400401403409422500503
GET
/v3/custom_categories
Get a list of all search custom categories
list_custom_categories 1 param → 200401500503

Schemas 38

The contract defines 38 schemas that model the data the API accepts and returns. The most detailed are KeywordQuery (5 properties), SearchV2 (4 properties), CombinedQuery (4 properties), ErrorDetails (3 properties). Each schema is shown below with its type and property counts.

Count
object
Number of results for the search
1 property 1 required
CreateTagResponse
object
1 property
SearchRequestV2
object
Search
3 properties 2 required
Tag
object
Tag
2 properties 2 required
TagList
object
Tag List
1 property
DocumentTagsPayload
object
2 properties 2 required
SingleSearch
object
Search Resource
1 property 1 required
ValidationMetadata
object
Metadata for the error
2 properties 1 required
MWAPIErrorDetails
object
3 properties
SingleSearchRequest
object
Search Resource
1 property 1 required
FilterSetList
object
1 property
ServiceUnavailable
object
Service Unavailable
1 property
InternalServerErrorResponse
object
Internal Server error
1 property
CreateTagResponseConfig
object
2 properties
CreateTagConfig
object
1 property
UnprocessableEntityCompanyId
object
Invalid company id
1 property
Query
Query associated with a search
FilterSet
The optional Filter Set to apply to this search
Error
object
1 property
CombinedQuery
object
4 properties
CustomCategory
object
3 properties
SearchListResponse
object
Search List Response
1 property 1 required
EmbeddedFilterSet
object
MWAPIError
object
1 property
ValidationError
object
2 properties
CreateTagRequest
object
1 property
CustomCategoriesList
object
2 properties
ErrorDetails
object
3 properties 3 required
SearchCountResponse
object
Number of results for the search
1 property 1 required
InvalidPermissionsResponse
object
Invalid Permissions
1 property
KeywordQuery
object
5 properties 1 required
DocModTag
object
2 properties
MissingResourceResponse
object
Unknown resource
1 property
BooleanQuery
object
3 properties 2 required
SearchV2
object
Search
4 properties 2 required
Errors
object
Errors
2 properties 1 required
SavedFilterSet
object
3 properties 1 required
UnauthorizedResponse
object
Unauthorized request
1 property

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

meltwater-listening-search-management-api-openapi.yml Raw ↑

Other APIs Meltwater publishes across the network.

Meltwater Account Management API
Meltwater Bring Your Own Content (BYOC) API
Meltwater Explore+ Analytics API
Meltwater Explore+ Assets API
Meltwater Explore+ Search API
Meltwater Listening Analytics API
Meltwater Listening Exports API
Meltwater Listening Search API
Meltwater Listening Streaming API
Meltwater Mira API API
Meltwater Owned Analytics API
Meltwater API v4
Where this information came from

This is an independent, third-party profile of Meltwater Listening Search Management API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.