Get a page (or brand-wide) report
How a page is performing, projected to the `metrics` you ask for. Each one is a separate upstream read, so ask for what you need: - `score`: quality and citability grades plus the ranked priority fixes - `performance`: Search Console clicks/impressions/CTR/position and AI-assistant referral clicks by provider - `traffic`: visitor sessions and conversions from the signals mart - `conversions`: per-definition conversion counts - `anatomy`: which components get clicked and how far visitors scroll Every performance block carries a `state`: only `ok` means the numbers are real. `no_data`, `unconfigured` and `error` return null metrics. Report the state, never substitute zero. `traffic`, `conversions` and `anatomy` are sampling-weighted estimates and honour `window`. `performance` is snapshot-shaped: it reports the window the capture covered, which `window` does not change. Omit `urlPath` for a brand-wide roll-up.
Authorization
tenantApiKeyAuth In: header
Path Parameters
Query Parameters
Comma-separated projections. Legal values: score, performance, traffic, conversions, anatomy. Defaults to score,performance.
How much to return. concise (the default) omits long-form text: briefs, outlines, evidence, passage excerpts, per-dimension breakdowns. detailed includes it and costs several times the tokens.
"concise"Value in
- "concise"
- "detailed"
Page route. Omit for a brand-wide roll-up.
Rolling window ending today.
"28d"Value in
- "28d"
- "7d"
- "90d"
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/public/brands/string/reports/pages/"{ "brandSlug": "orbital-labs", "scope": { "urlPath": "/pricing" }, "window": "28d", "score": { "overall": 71, "letterGrade": "C-", "citability": { "overall": 50, "grade": "C" } }, "performance": { "search": { "state": "unconfigured", "windowDays": null, "effectiveThrough": null, "metrics": null }, "llmReferrals": { "state": "no_data", "windowDays": null, "effectiveThrough": null, "metrics": null } }}Last updated on
Get one page by route
Full detail for one page: meta, indexability, draft vs published version, approval state and the translation group. `approvalState` is one of `unsupported`, `no_approval`, `no_diff`, `has_diff`. `has_diff` means the draft has moved since a reviewer approved it, and `unsupported` means the page never entered the approval workflow. A translation entry with a `staleReason` means the source copy moved after Iterant produced that locale. `responseFormat=detailed` adds `outline`, the page's section components in order.
List agent tasks
Tasks this brand has run, newest first. A `build_page` task reports the state of the page build it wraps, so its `status` is always what the opportunity itself says. A task that has been running for more than two hours with no word from the agent is reported as `failed`.