Optimly Developer Documentation

Optimly MCP

Bulk Add Media Coverage

In short

Bulk-add 1 to 25 earned-media article URLs to your brand's Media Coverage intake. Optimly enriches missing details, deduplicates normalized URLs, and returns added, already_tracked, or failed for every item.

coverage_add_many · Partner Program · Authentication required

Bulk-add 1 to 25 earned-media article URLs to your brand's Media Coverage intake. Optimly enriches missing details, deduplicates normalized URLs, and returns added, already_tracked, or failed for every item.

When to use

Use after converting pasted links, spreadsheet rows, or a CSV to structured items; do not pass raw CSV text.

Access

Enterprise with BrandVault management permission

Parameters

ParameterTypeRequiredDescription
itemsobject[]Yes1 to 25 article items with url and optional title, publication, and published_at.
brand_iduuidNoAuthorized brand ID. Required when more than one brand is available.

Example prompt

Add these twelve press links to our Media Coverage tracking.

Side effects and safety

A failed article does not roll back successful items.