Optimly Developer Documentation

Optimly MCP

Add Media Coverage

In short

Add one earned-media article URL to your brand's Media Coverage intake. Optimly normalizes the URL, enriches missing article details, and saves it for citation matching. This is a distinct ingestion flow, not a BrandVault section update.

coverage_add · Partner Program · Authentication required

Add one earned-media article URL to your brand's Media Coverage intake. Optimly normalizes the URL, enriches missing article details, and saves it for citation matching. This is a distinct ingestion flow, not a BrandVault section update.

When to use

Use when the brand earns a new article or mention worth tracking for AI citation matching.

Access

Enterprise with BrandVault management permission

Parameters

ParameterTypeRequiredDescription
urlstringYesPublic http or https URL for the earned-media article.
titlestringNoOptional known article title. Optimly identifies it when omitted.
publicationstringNoOptional known publication name. Optimly identifies it when omitted.
published_atstringNoOptional publication date or ISO 8601 timestamp.
brand_iduuidNoAuthorized brand ID. Required when more than one brand is available.

Example prompt

Track this TechCrunch article about us in Media Coverage.

Side effects and safety

Idempotent ingestion; reports added or already_tracked.