Optimly Developer Documentation

Optimly MCP

Brand Sources

In short

Aggregate citations from an audit and classify sources as owned or third-party, with grounded-answer rates and accuracy comparisons.

brand_sources · Partner Program · Authentication required

Aggregate citations from an audit and classify sources as owned or third-party, with grounded-answer rates and accuracy comparisons.

When to use

Use to identify which domains shape AI answers and whether the brand's own site is being cited.

Access

Partner Program or approved access with read_brand permission

Parameters

ParameterTypeRequiredDescription
run_idstringNoAudit run; omit for latest.
group_bystringNoCitation grouping; default domain. Allowed values: url, domain.
brand_slugstringNoBrand selector for internal superadmin keys. Brand-scoped keys ignore it; OAuth users select an authorized brand with brand_id.

Example prompt

Which third-party domains most influence AI answers about us?

Example request

{
  "group_by": "domain"
}