Skip to main content
Open any Parse id returned by another call (one id kind per call): ans_ (up to 10 AI answer texts with brands marked ⟦…⟧, judgments, citations, comparisons), pg_ or URL (up to 20 with text, 100 without: stored copy, pageKind, brands listed, pitch check, robots verdicts; pass fields: [“contact”] for contacts at $0.05 per newly unlocked route, free on misses and 90d repeats), exp_ (export file page by cursor), or job_/cf_ (up to 25 async job statuses, costs, and results; wait: true holds until done). Excerpts free; full texts free for own content and 25 public texts/day ($0.005 each after).

Who may call it, and what it costs

Price. Free. A full text (format: "full") of an answer or a page needs credits: the workspace’s own answers and pages free, and public ones 25 a day free, then $0.005 each, shown in meta.costCredits. 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. An export’s rows were counted when the file was written. Every reply says what the call cost in meta.costCredits. The prices are on Spending, tracking and stopping.

Arguments

list of string
required
ids of one kind: ans_ (up to 10), pg_ or URLs (20 with text, 100 when fields leaves text out), one exp_, or job_/cf_ (up to 25) up to 100
list of string
the parts to return. Answers: the parts to return, besides each answer’s id, date, engine and question; default all five. Without text, ten answers fit one compact reply. Pages: the parts of each page to return (ids always stay); a part left out is not loaded. Default omits “contact” ($0). Pass fields: [“contact”] to unlock actionable contact routes ($0.05 each, free on misses, bare author names, and 90d repeats) up to 12
one of compact, full
full: whole text for up to 5 answers or 3 pages, free with credits within the day’s allowance
list of string
answers and pages: brd_ ids to mark, and on pages to answer for, besides the brands each names up to 20
boolean
false: leave out the one-sentence note (data.note)
string
an export, or a job with call: page.cursor of the last page
integer
an export: rows in the page min 1, max 500
integer
jobs: seconds to wait for the jobs to finish, at most 50: the call returns as soon as none is queued or running or a first run’s first look arrives, else when the time is up. Saves polling min 1, max 50
boolean
jobs: with one job_ id of an ask: the whole ask_ai_engines call that wrote it, its totals and its jobs 25 a page (cursor for the next); wait is not used
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

Read the text of answers and the brands each names, from ids a search returned. Over REST:
Over MCP, the assistant calls the tool by name with the same arguments:
More calls:
  • Read the whole text: free with credits, within the day’s full texts: {"ids":["ans_…"],"format":"full"}
  • Who to write to about a page, for up to 100 pages: {"ids":["pg_…"],"fields":["contact"]}
  • Read a page of the file an export wrote, through the service, with no fetch tool: {"ids":["exp_…"],"limit":200}
  • The status and results of an ask or a baseline, holding the call up to 30 seconds until it finishes: {"ids":["job_…"],"wait":30}
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.