Who may call it, and what it costs
Price. $0.01 a check, on ChatGPT, Google AI Mode or any other AI engine. A check is one question asked once on one AI engine or search surface from one place. Answers Parse already holds from the last 7 days that the workspace may read fill the runs they can, free;
fresh: true buys every run. A baseline (baseline) is about 20 questions × 2 engines = 40 checks, $0.40; recent answers are reused and not charged, and the first run of the workspace’s own Free brand is free. Runs when called, within the budget; quote: true prices it only and starts nothing. Every reply says what the call cost in meta.costCredits. The prices are on Spending, tracking and stopping.
Arguments
the exact words to ask, up to 1,000 (questions × places up to 1,000) (or baseline instead) up to 1000
the brand to measure: a brd_ id, or its site’s domain (a site Parse has never seen is read first)
list of one of default, answers, all_answers, memory, all_memory, search, all, chatgpt_search, google_ai_mode, perplexity, gemini, claude, chatgpt_memory, claude_memory, gemini_memory, parallel, youcom, tavily, exa, linkup
surface ids, and at most one preset: default (the counted engines and one search API), answers (1¢ answer engines: ChatGPT, Google AI Mode, Perplexity), all_answers (every answer engine, including 5¢ Gemini and Claude), memory (1¢ search-off model), all_memory (every search-off model, including 5¢ Gemini and Claude), search (every retrieval API whose rows may be returned), all (every surface but those withheld). exa, linkup return lists whose rows Parse may not pass on: no preset buys them, a call that names one does. Nothing given is default up to 20
questions only: where to ask from, up to 50: plc_ ids from resolve_ids, country codes (“DE”) or names, or place names (“Austin, Texas”); default the United States. An unknown or ambiguous place is refused, never asked from elsewhere. A surface that takes no place (a model with its search off, a search API) is asked once a question. Google AI Mode often returns nothing for a city-worded or US-default local ask (refunded, never charged); a country code answers up to 50
questions only: named (default): puts the place in the question so every engine answers for it; near_me: asks bare wording from Google locationCode (Google AI Mode only)
questions only: answers per answer engine per question, up to 100; default 1. A search API returns one list a question whatever this says min 1, max 100
questions only: true: buy every run. Left out, answers Parse already holds from the last 7 days that this workspace may read fill the runs they can, free, and only the rest are bought
baseline only: measure a brand again whose free first run is finished: this is a paid run. A plain call on such a brand returns the first run at no charge
baseline only: in a workspace with no brand yet, a call returns the price and the free claim first: true buys the run, for a brand that is not the person’s own. Otherwise not needed: the call runs when it fits
the same key with the same arguments returns the same job and charges nothing more; other arguments are refused. Left out, an identical call within the UTC hour is the same call; pass a key to buy it again
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
Price a question asked now on the default surfaces, and buy nothing. Over REST:- Ask a question now with Austin written into it, so every engine answers for Austin; fresh answers Parse holds for the placed words are reused for $0:
{"questions":["best plumber near me"],"places":["Austin, Texas"]} - Ask the bare words from the place’s Google location code, as someone there would (Google AI Mode only):
{"questions":["best plumber near me"],"places":["<plc_ id from resolve_ids>"],"placeMode":"near_me"} - Buy five new answers an engine today, reusing none Parse already holds:
{"questions":["best project management tool for agencies"],"runs":5,"fresh":true} - Price a baseline for a brand, and buy nothing:
{"baseline":"acme.com","quote":true} - Measure a brand now:
{"baseline":"acme.com"}
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.