Who may call it, and what it costs
Price. A tracked question costs its checks, $0.01 each, until stopped: asked daily on both counted engines, 1 question × 2 engines × 30 days = 60 checks, $0.60 a month; asked weekly, 1 question × 2 engines × 4.3 weeks = about 9 checks, about $0.09 a month. A check is one question asked once on one AI engine or search surface from one place. Brands, topics and pages are free watches.
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
brd_, top_, qst_ or pg_ ids, page URLs, or questions in their exact words, up to 1,000 (questions × places up to 1,000) up to 1000
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
for questions: surface ids, and at most one preset (answers, memory, search, all, default), as ask_ai_engines takes them. Nothing given is the counted engines (ChatGPT and Google AI Mode) up to 20
for questions, where each is asked from, up to 50: plc_ ids, country codes (“DE”) or names, or place names (“Austin, Texas”), as ask_ai_engines takes them; default the United States. Each place is its own tracked question, a check a place each time it is asked, so the quote shows the monthly cost per place and in all. A surface that takes no place (a model with its search off, a search API) is asked once a question, not once a place. Google AI Mode often returns nothing for a city-worded or US-default local ask (a check that fails is not charged) up to 50
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)
Adopt a gol_ id from get_brief, free. Propose with brand, topic or questions, target (a share such as 0.3) and by (YYYY-MM-DD). For a measured outcome, use goal.outcome with kind fix_misconception and contradiction (a check_brand misconception id), or kind win_comparison with rival (brd_ id) and axis. Parse freezes the measured questions. quote: true checks measurability. Include targets to track for an active goal.
with own: true only after the person said yes to tracking their own business; without it own previews and writes nothing
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
Ask a question on the counted engines every day from now on. Over REST:- Price a question tracked from two places, each its own tracked question, and start nothing:
{"targets":["best plumber near me"],"places":["Austin, Texas","Dallas, Texas"],"language":"en","quote":true} - Stop tracking an item; its history stays:
{"stop":["trk_…"]} - Say what tracking the person’s own business would do, and write nothing:
{"own":"acme.com"} - Track it as the workspace’s brand, after the person said yes:
{"own":"acme.com","confirm":true}
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.