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
default named; warned: the answer advises against the brand by the caution-insight rule (warnsAgainst: the judge’s advised_against at least 0.65 and the brand not only a cited source; list_facets: mention.advised_against). It misses most warnings (recall 0.34) and is NOT the app’s Answers page rule, which reads the judged treatment warned_against (list_facets: mention.treatment)
surface ids (list_facets: engine); without engine or surfaceClass, the counted engines up to 10
classes of engines to cover; default counted up to 5
plc_ ids (resolve_ids finds them): the place a question is about, with the places under each (a region holds its cities). “all”: every place, in place of a local subject’s area. A country code here reads as filter.country for one release
ISO country codes the question was asked from; an answer asked with no place set counts as US up to 20
Full-text search over answer text: keywords, “exact phrases”, AND/OR/NOT, NEAR/n, prefix*. A call reads at most the first 100,000 matches (20,000 in search_answers) before the brand filter and the rest apply: a brand filter does not narrow it, so a common word over a long window can miss a brand’s answers; narrow by window, topic, market or engine
default all: public plus this workspace’s own; own: only the answers this workspace bought; tracked: its own answers and those about the questions, topics and brands it watches with the track tool (not the brands it added in the app); public: public answers only
list of one of none, conditional, fallback, budget_only, inferior_comparison, risk_warning, weak_praise
up to 7
list of one of price, audience, fit, standing, ease, deployment, integrations, support, performance, security, scope, features, other
up to 13
keywords over the sentence, its context and the claims (a comparison: its claim and what it is about): words, “phrases”, AND/OR/NOT, prefix*
how brands count: company (default; a company and its products are one brand) or product (each brand on its own, so a product’s numbers leave out its siblings)
tools/list 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:
Example call
The sentences in answers that argue against a brand. Over REST: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.