API Access and Integrations

Scope offers two programmatic surfaces and dashboard exports. Both programmatic surfaces use the same API key, the same scopes, and the same check ledger.

Start here: developer docs (MCP) and REST API. Same key, same tools.

Data Export

All Scope plans include data export capabilities.

Exporting Your AI Visibility Data

1. Navigate to the business you want to export data for
2. Click Export in the top-right corner of your dashboard
3. Select the data type:
   • Score History: Your AI Visibility Score over time (CSV)
   • Prompt Results: Individual prompt responses with platform, date, and result (CSV)
   • Competitor Comparison: Your score vs. competitors over time (CSV)
   • Recommendations: Your current optimization action list (PDF or CSV)
4. Choose the date range
5. Click Export — the file downloads to your computer

Create an API key

Keys are created in the app, not on the docs site.

1. Open Settings → API keys
2. Create a key (Growth). The full sk_scope_… secret is shown once.
3. Use that key as Authorization: Bearer on REST or MCP.

A new key defaults to every grantable scope and every business. Lock it to selected businesses or turn features off later. A selected-business key cannot add new sites.

Starter can connect an agent in read-only mode from Settings → Agents. Creating restricted keys and running checks requires Growth.

REST API

HTTP mirror of the same tools as MCP. Reads are free. Actions quote check cost before they spend.

• Base URL: https://scope.online/v1
• Docs: scope.online/docs/api
• OpenAPI: scope.online/v1/openapi.json

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://scope.online/v1/whoami

Reads are GET /v1/{tool} with query parameters. Actions are POST /v1/{tool} with a JSON body. Examples: GET /v1/list_businesses, GET /v1/get_visibility_report?business_id=…, POST /v1/run_scan.

Do not invent a second endpoint list here. The tool catalog lives at scope.online/docs/tools.

MCP for agents

Claude, ChatGPT, Cursor, and other MCP clients connect at https://scope.online/mcp with the same Bearer key (or OAuth). Install from Settings → Agents. Docs: scope.online/docs.

Common integration use cases

Scripts and BI dashboards

Pull scores and citations on a schedule with curl or any HTTP client. Point Looker, Databox, or a warehouse loader at GET /v1/get_visibility_report.

Weekly Slack notifications

A small script can call GET /v1/whoami and GET /v1/get_visibility_report, then post to a Slack webhook.

Agency / CRM sync

Agencies can issue one key per client (lock it to selected businesses) and pull scores into HubSpot or Salesforce.

What we do not ship yet

There is no native Zapier or Make app, no developer sandbox with simulated data, and no api.scope.online hostname. Until those exist, use REST, MCP, or dashboard export.

Q: Can I add businesses from the API? A: Yes, with an all-businesses key that has business:create. Call POST /v1/add_business. Selected-business keys cannot add sites.

Q: Do REST and MCP share rate limits and checks? A: Yes. One account pool, one key, one ledger.