DEVELOPER DOCS

Public API

JSON endpoints for agent access signals across 1,000+ e-commerce brands. No auth required for public read endpoints. Pro subscribers get higher limits and export access. Use it from curl, your scripts, your agents.

Base URL

https://www.arcreport.ai

GET/api/matrix

Full signal index: every brand's latest scan with agent-access status, platform, CDN/WAF, and structured-data signals.

curl

curl https://www.arcreport.ai/api/matrix

response (abbreviated)

{
  "stats": {
    "totalBrands": 1006,
    "scannedBrands": 1006,
    "brandsBlocking": 36,
    "brandsFullyOpen": 970,
    "avgBlockedAgents": 0.1,
    "percentFullyOpen": 96
  },
  "brands": [
    {
      "id": 1,
      "slug": "nike",
      "name": "Nike",
      "url": "https://www.nike.com",
      "category": "fashion",
      "agentStatus": {
        "GPTBot": "restricted",
        "ChatGPT-User": "restricted",
        "ClaudeBot": "restricted",
        "Claude-Web": "allowed",
        ...
      },
      "platform": "custom",
      "cdn": "akamai",
      "waf": "akamai",
      ...
    }
  ]
}

GET/api/changelog

Recent signal changes detected across brands. Free tier returns recent entries. Pro subscribers get full 90-day history.

curl

curl https://www.arcreport.ai/api/changelog

response (abbreviated)

{
  "isPro": false,
  "entries": [
    {
      "id": 1585,
      "brandId": 693,
      "field": "robots.txt presence",
      "oldValue": "true",
      "newValue": "false",
      "detectedAt": "2026-03-30T11:31:05.684Z",
      "brandSlug": "h-e-b",
      "brandName": "H-E-B"
    }
  ]
}

GET/api/scan-health

Operational status of the daily scan pipeline. Includes latest run details, data freshness, and drift alerts.

curl

curl https://www.arcreport.ai/api/scan-health

response (abbreviated)

{
  "overallStatus": "green",
  "latestRun": {
    "id": 3,
    "status": "completed",
    "totalBrands": 1006,
    "completed": 1004,
    "failed": 2,
    "changesDetected": 127,
    "startedAt": "2026-04-04T22:33:53.707Z",
    "completedAt": "2026-04-04T22:41:12.019Z"
  },
  "dataFreshness": {
    "freshBrands": 1004,
    "totalBrands": 1006,
    "percentage": 99
  }
}

Agent Status Values

allowed: robots.txt explicitly permits the agent AND the site serves the agent a normal response.
blocked: robots.txt explicitly disallows the agent (policy block).
restricted: robots.txt allows the agent, but the WAF / CDN blocks or degrades the response (infra block).
no_rule: robots.txt has no explicit rule for this agent. Default varies by site.
inconclusive: the scan couldn't determine the status (timeout, network error).

Pro Endpoints

These require authentication (session cookie from login).

GET/api/export?type=matrix&format=csv

Export the full brand matrix or changelog as CSV or JSON. Params: type (matrix, changelog), format (csv, json).

GETPOSTDELETE/api/watchlist

Manage your brand watchlist. GET returns watched brands, POST adds a brand, DELETE removes one. Body: { brandId }.

Need more?

Pro ($149/mo) includes full history, daily alerts, watchlists, and data exports. See pricing or email hello@arcreport.ai for custom integrations.