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
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)
default named; not_recommended keeps judged answers recommending none of the filter brands; warned filters to answers flagged with facet mention.advised_against
Industry or category markets. For countries use country, and for cities use place. up to 50
surface ids (resolve_ids with kinds: [“surface”] lists them); 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; index: the answers parse.gl’s public pages count, which a logged-out call always reads
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
answers only: relevance (with filter.text; default then), date (default), position (with filter.brand)
answers only: diff: for ≤5 questions or one topic, brands and pages that came and went per 28-day step
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
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*
mentions and comparisons only: other evidence the same answer must hold (all, any), each clause with its own unit
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)
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:- 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"]}
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.