Skip to main content
This page is mainly for developers. If you use OpenRush through an AI agent, you usually do not need to read raw responses. Every OpenRush tool returns the same top-level envelope. Agents can switch between SEO, SERP, audit, keyword, page, and dataset tools without learning a new response wrapper.

Fields

Facts

Facts are standalone claims. Each fact has a namespaced type, a subject, and public provenance.

Provenance

Provenance tells an agent how fresh and trustworthy a fact is. It does not expose upstream supplier names, vendor task IDs, or wholesale costs.

Deltas

deltas holds what changed since a previous observation, as <domain>.delta facts such as seo.delta, audit.delta, or gsc.delta. They appear in two places:
  • Monitor responses. create_monitor, update_monitor with run_now, and get_monitor_history return the changes of the latest check vs the check before it. See Use Monitors.
  • Repeat tool calls. When monitors are enabled and your account asks the same question again (for example inspect_domain for the same domain and market, at least 6 hours later), the response adds up to 5 meaningful changes vs your previous look or a monitor’s last check with matching settings. coverage.scope_note says which one they compare with. This covers the tools monitors run.
Owned-data reports (Search Console, Analytics, Google Ads) also keep their own period-over-period *_delta fields inside data and facts.

Resources and datasets

When a tool has more rows than should be inlined, it returns an openrush:// resource. Pass that URI to /v1/tools/export_dataset.
If a valid dataset URI has expired, the endpoint returns a 200 envelope with data.available=false, an explanatory note, and a next_actions entry to regenerate the dataset.