Sponsor research

Two directions. A show to its sponsors: arcmira.sponsors(channelId) ranks recurring sponsors by ad reads with first and last seen dates. A brand to the shows it sponsors: arcmira.recommendations(entityId, { kind: "sponsored" }) lists each ad read, which the program groups by show.

Run each program with arcmira_execute_read; arcmira_describe has the method reference.

When to use

• who sponsors a show, how many ad reads, since when, still active
• which shows a brand sponsors or advertises on, and how often
• sponsors two shows share (sponsors of each, then intersect by entity.id)

Pick the entity the user meant

Users give names; filters take ids only (ent_..., UC..., 11-character video ids), and a name where an id belongs throws id_required.

1. Resolve the exact name the user said, with their own words about it as context (a bare "Theo" has none).
2. best and suggested give the id. A suggested pick is an assumption: the answer names it, with suggested.evidence as the reason.
3. ask: several entities fit, and ask.options goes back to the user. No answer at all: the name is not in the index.