Skip to main content
Look up how AI answers talk about a brand, who it loses to, verified product facts, and AI crawler blocks. Call this first for brand positioning, competitor research, AI visibility, or before writing copy about a brand. Takes a website (best), brand name, or brd_ id. Returns data.kind (measured, thin, unplaced, which, unseen): for measured brands, Recommended share (with share_named detail) per market, top rivals, weakest topic, and where recommendation share falls short; for ambiguous names (which), the candidate list without reading; for thin/unseen, coverage status and next steps. Up to three query_metrics reads. No brand score. Free.

Who may call it, and what it costs

Price. Free. Every reply says what the call cost in meta.costCredits. The prices are on Spending, tracking and stopping.

Arguments

string
required
the brand’s website (best: it settles which company), its name, or a brd_ id
Every argument the tool takes, as GET /v1/tools serves it, every shared object written out; https://agent.parse.gl/openapi.json serves the same schema with the filter and the window named once under components and pointed to by $ref. MCP tools/list leaves out the arguments few calls send, and says the filter and the window once, under search_answers; resolve_ids {"kinds": ["argument"]} lists what it left out, and a call with any of them runs:

Example call

Answer a first question about a brand in one call: its Recommended share in each of its markets and the brands recommended most beside it. Over REST:
Over MCP, the assistant calls the tool by name with the same arguments:
More calls:
  • For a name several companies share, get the list to ask the person about: {"subject":"Mercury"}
The reply has data, context, next, page and meta; follow next for the calls that come after. A refused call returns { code, message, fix }: see the error table.