Skip to main content
Read how AI answers actually describe, compare, or recommend brands — use when diagnosing messaging gaps, positioning, or why competitors win. Returns compact rows with ans_ ids to open with read_item. Use view: “diff” for brand/citation changes across up to 5 questions or 1 topic. When signed in, rows: “mentions” returns brand sentences and rows: “comparisons” returns head-to-head claims and winners (for aggregate win rates use query_metrics). Older than 90d public answers: $0.001 each once (history). Free.

Who may call it, and what it costs

Price. Free over the last 90 days. A public answer older than 90 days costs $0.001 the first time the workspace counts or lists it, and is the workspace’s after, shown in meta.costCredits. A list charges the past answers a page delivers; match totals stay free, and a total that counts past answers not bought is rounded (totalAbout). view: "diff" counts, and takes history as query_metrics does. Every reply says what the call cost in meta.costCredits. The prices are on Spending, tracking and stopping.

Arguments

one of answers, mentions, comparisons
answers (default): one row an answer; mentions: one row a sentence about a brand; comparisons: one row a head-to-head comparison (who wins them, counted: query_metrics’ comparisons measures)
object
which answers count; window is a separate argument, not part of filter
list of string
brd_ ids; with brandRule, which answers count up to 20
one of named, recommended, first, not_named, not_recommended, warned
default named; not_recommended keeps judged answers recommending none of the filter brands; warned filters to answers flagged with facet mention.advised_against
one of any, all
with several brands; default any
list of string
up to 50
list of string
Industry or category markets. For countries use country, and for cities use place. up to 50
list of string
up to 100
list of string
surface ids (resolve_ids with kinds: [“surface”] lists them); without engine or surfaceClass, the counted engines up to 10
list of one of counted, wider, memory, search, imported
classes of engines to cover; default counted up to 5
"all" or list of string
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
list of string
ISO country codes the question was asked from; an answer asked with no place set counts as US up to 20
list of string
domains or site: ids of cited sites up to 50
list of string
pg_ ids of cited pages up to 50
string
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
object
a facet with “filter” in its usableIn list
one of tracked, public, own, all, index
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; index: the answers parse.gl’s public pages count, which a logged-out call always reads
object
default the last 28 days; “last” or from/to
one of 7d, 28d, 90d, 365d, all
date
inclusive
date
inclusive
one of auto, all, free
view: “diff” only: answers past 90 days, $0.001 each once: auto (default) a sample worth up to a quarter of the month’s budget, at most $5; all, every answer within the budget; free, none, with each sample’s cost
one of relevance, date, position
answers only: relevance (with filter.text; default then), date (default), position (with filter.brand)
one of rows, diff
answers only: diff: for ≤5 questions or one topic, brands and pages that came and went per 28-day step
one of for, against
mentions only: claims for or against the brand
list of one of none, conditional, fallback, budget_only, inferior_comparison, risk_warning, weak_praise
mentions only up to 7
list of one of price, audience, fit, standing, ease, deployment, integrations, support, performance, security, scope, features, other
comparisons only up to 13
list of string
comparisons only: brd_ ids on the other side up to 10
"self" or "other" or string
comparisons only: “self” (the filter brand), “other”, or a brd_ id
string
mentions and comparisons only: keywords over the sentence, its context and the claims (a comparison: its claim and what it is about): words, “phrases”, AND/OR/NOT, prefix*
object
mentions and comparisons only: other evidence the same answer must hold (all, any), each clause with its own unit
list of object
up to 5
list of object
up to 5
one of company, product
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)
integer
default 25; the token cap wins min 1, max 200
string
one of compact, full
compact (≈6k tokens, default) or full (≤20k)
list of string
columns to keep in each row up to 40
boolean
false: leave out the one-sentence note (data.note)
boolean
list of string
brd_ ids to mark in text up to 20
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

Find the answers that recommend a brand in a market. Over REST:
Over MCP, the assistant calls the tool by name with the same arguments:
More calls:
  • The sentences in answers that argue against a brand: {"rows":"mentions","filter":{"brand":["brd_21e2e46d-5498-46bc-bd54-791c1acd74e7"],"market":["mkt_6956b477-23eb-43da-99ad-c3e612482b08"]},"claimSide":"against","limit":10}
  • Head-to-head comparisons of a brand on price, with who comes out ahead: {"rows":"comparisons","filter":{"brand":["brd_21e2e46d-5498-46bc-bd54-791c1acd74e7"]},"axis":["price"]}
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.