API + MCP
Use The Same Report Engine From The
Web, API, and MCP
Create reports programmatically, poll status, and read the same saved report object your team sees on the website.
Access model
Account + card
API access is account-linked. Create an account, add a card, then issue one API key for direct API and MCP access.
One report object
Website sessions, API calls, and agent sessions read from the same saved report state.
Straightforward flow
Create a report, poll for status, then read preview or full results from the same object.
Available endpoints
POST
/api/v1/reportsCreate a new report or reuse one that already exists.
GET
/api/v1/reports/:idGet the latest report status and sections.
GET
/api/v1/reports/:id/resultRead the full report result payload.
Example Response
{
"success": true,
"report": {
"jobId": "383c5318-5e81-45a8-9df8-579d10442f72",
"stage": "snapshot_ready",
"status": "completed",
"targetUrl": "https://rbeckner.com",
"isSnapshotReady": true,
"preview": {
"sectionKeys": ["hero_summary", "top_findings"]
},
"paidUnlock": {
"unlockEligible": true,
"unlocked": false
}
},
"pollAfterMs": 0
}