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 Bring Your Own Content (BYOC) API

Upload your own content into the Meltwater Platform.

Meltwater Bring Your Own Content (BYOC) API is one of 14 APIs that Meltwater publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Bring Your Own Content (BYOC). 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 4 operations across 4 paths, and defines 22 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.

4 operations 4 paths 22 schemas 3 GET1 POST

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 Bring Your Own Content (BYOC) 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 4

Across 4 paths, the API surfaces 4 operations — 3 GET, 1 POST. Each is listed below with its method, path, parameters, and response codes.

Bring Your Own Content (BYOC) 4

Upload your own content into the Meltwater Platform.

POST
/v3/imports/documents
Ingest BYOC documents
handleByocDocuments 2 params body → 200400401500
GET
/v3/imports/batches
List import batches
8 params → 200400401500
GET
/v3/imports/batches/{batch_id}
Get import batch
3 params → 200400401404500
GET
/v3/imports/import_tags/{import_tag}
Get import tag
3 params → 200400401404500

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are ByocDocument (15 properties), ByocMetrics (8 properties), ByocUser (6 properties), ByocAttachment (6 properties). Each schema is shown below with its type and property counts.

ByocListBatchesResult
object
4 properties
ByocCoordinates
object
Coordinates of the location
2 properties 2 required
ByocImportsDocumentsResult
object
2 properties
ByocContent
object
Content details of the document
4 properties
ByocParent
object
Parent document details
3 properties
ByocIngestionBatch
object
5 properties
ByocLocation
object
Location details of the user
3 properties
Location
object
Location
4 properties 4 required
ByocDocument
object
15 properties 5 required
ByocResultAPIError
object
1 property
ByocResultAPIValidationError
object
Bad Request
1 property
ByocProduct
object
Product details
1 property 1 required
ByocMetrics
object
Metrics associated with the document
8 properties
ByocCustomField
object
Custom fields associated with the document
2 properties 2 required
ByocIngestionBatchStatistics
object
4 properties
ByocImportsDocumentsRequest
object
1 property 1 required
ByocSource
object
Source details of the document
3 properties 2 required
ByocAttachment
object
List of attachments associated with the document
6 properties 3 required
ByocGetBatchesResult
object
5 properties
ByocUser
object
User / author / speaker / presenter details associated with the document
6 properties
ByocGetImportTagsResult
object
4 properties
ByocIngestionSubGroup
object
2 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

meltwater-bring-your-own-content-byoc-api-openapi.yml Raw ↑

Other APIs Meltwater publishes across the network.

Meltwater Account Management 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 Search Management 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 Bring Your Own Content (BYOC) 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.