Optimly Developer Documentation

Optimly MCP

Publication Expand

In short

Find lookalike publications the brand does not yet win, labeling candidates by discovery source and verification level.

brand_publication_expand · Partner Program · Authentication required

Find lookalike publications the brand does not yet win, labeling candidates by discovery source and verification level.

When to use

Use after Publication Match to expand an evidence-backed outreach list.

Access

Partner Program or approved access with read_brand permission

Parameters

ParameterTypeRequiredDescription
run_idstringNoPins the brand's winning-angle audit.
brand_slugstringNoBrand selector for internal superadmin keys. Brand-scoped keys ignore it; OAuth users select an authorized brand with brand_id.
winning_publicationsobject[]Nopublications[] from brand_publication_match.
max_candidatesnumberNoDefault 20, maximum 50.
min_authoritynumberNoOpenPageRank floor.
force_websearchbooleanNoAlways run grounded web-search expansion.
peer_limitnumberNoMaximum peer brands, default 10.

Example prompt

Expand our winning-publication list with similar verified targets.

Example request

{
  "max_candidates": 20,
  "force_websearch": true
}