ARC public API
Import this document from /openapi.json or /.well-known/openapi.json. No API key. Use getStoreCard to look up one store's saved card, canAgentCheckout to read…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Import this document from /openapi.json or /.well-known/openapi.json. No API key. Use getStoreCard to look up one store's saved card, canAgentCheckout to read a stored checkout check (it does not fetch the store; 404 if none is stored), runAgentCheckout to fetch a fresh check, askArc to read the Index, datasetManifest for the open dataset files, and reportCheckout to record one checkout attempt. The same document is at /.well-known/openapi.json. Setup for Claude, ChatGPT, Gemini, Cursor and generic agents: /docs/connect.
Any agent can ask whether a brand gets chosen and whether agents can reach checkout. The answer has two lanes: buy.agent_catalog is a live HTTP check of Shopify catalog tools and a valid UCP profile, and buy.browser is the browser cart. The catalog check is not a browser session and not any third-party agent product, and it does not change the score; browser cart results come from ARC browser shoppers A–E. agents_can_buy is true when either lane reached checkout or the cart (ARC stops before payment; it is not a completed order). What Grok tells shoppers is a real model call via API, checked against the store's pages, not the consumer Grok app. Rivals are omitted when that read does not exist. ARC is not affiliated with Meta, Spear Street Technology, SpaceXAI, OpenAI, or the OpenClaw Foundation. A missing score is not a zero.
Endpoints 38
Check a store
- GETLatest saved product data from the page’s structured data
/api/agent-checkout/product-data?host=stringFree DB read. Includes public Google checkout readiness from saved evidence; not Google approval. Merchant Center feed eligibility cannot be checked from… - GETRead the stored checkout check without fetching the store
/api/agent-checkout?url=stringReturns the stored checkout check for a public http or https homepage or product URL, including one older than 24 hours. Does not fetch the store. 404 when… - POSTRun a new checkout check
/api/agent-checkoutPOST JSON {"url":"https://store.example"} with Content-Type: application/json (other content types get 415; a url query is ignored). Returns the stored check,… - GETSaved pre-checkout answer for a product or store URL
/api/precheck?url=stringFree read of data ARC already holds: the public directory, saved agent rails, store answers and directory check history. When those have no row, the… - POSTSaved pre-checkout answers for up to 100 stores
/api/precheck/bulkThe GET /api/precheck read for up to 100 store domains or URLs. Saved checks only: does not fetch any store and does not start a scan. Each domain takes one… - POSTAgent Readiness Grades for up to 200 stores (bulk report for agencies)
/api/bulk-gradesEach store's Agent Readiness Grade (method v2), checked date, failed audits, top fix and links to its store page and fix generator, plus a summary: grade… - GETValidate a store's UCP profile against the published UCP schema
/api/ucp/validate?url=stringFetches https://<host>/.well-known/ucp (follows up to three redirects, 6 s timeout) and validates it against the published UCP 2026-08-25 JSON Schema… - POSTValidate pasted UCP profile JSON, or a URL
/api/ucp/validateSend {"profile": {...}} to validate JSON without fetching anything, or {"url": "allbirds.com"}. - GETStarter fixes for a store's failed Agent Readiness Grade audits
/api/fix?store=stringFree saved-data read; never fetches or changes the store. For each failed audit ARC can safely write, a starter: robots.txt allow rules (from ARC's saved…
Read the data
- GETFree agent facts for any store (Jev typed decisions)
/api/agent-factsNo login. Returns stored TypeSafe Jev facts from HTTP scrapes. Not a browser session and not any third-party agent product. download=1 returns a JSON… - GETFind stores where an AI agent can reach checkout for running shoes or another need
/api/agent-checkout/storesNo login. Reads real HTTP checkout-positive results within thirty days. Best current Agent Readiness Grade first, expired after current of the same letter,… - GETHow many pre-checkout answers ARC has served
/api/precheck/statsTotal rows counted in precheck_daily. The count is per host and UTC day. It stores no IP address and no user agent. Requests from ARC's own clients are not… - GETAgent commerce adoption counts by category and platform
/api/agent-checkout/adoptionCounts and rates from ARC's saved HTTP checks: valid UCP profiles, agent catalogs, storefront WebMCP, Checkout WebMCP (Shopify measured denominator; unknown… - GETWhat changed between the two most recent open-data snapshots, and adoption trends
/api/changes.jsonBuilt from store_answers.csv in the dated folders under /data when the site is built. Stores that newly serve or lost a valid UCP profile, started or stopped… - GETLatest weekly US share of stores that returned a UCP checkout link
/api/weekly/agent-checkout.jsonOne frozen figure per week from the State of agent checkout post. pct is count/n rounded to 1 decimal. The body includes n, the snapshot date, the dataset… - GETImmutable weekly US agent-checkout figure for one edition date
/api/weekly/agent-checkout/:editionThe URL is /api/weekly/agent-checkout/YYYY-MM-DD.json, for example /api/weekly/agent-checkout/2026-10-13.json. The edition date is the post date. Bytes do not… - GETProtocol Matrix: UCP, ACP, PAP, WebMCP, MCP and payments, stage by stage
/api/protocolsHow many checked stores declare, validate, answer and return a checkout link on each protocol, with evidence labels (Measured, Inferred, Not measured). Saved… - GETOpen agent leaderboard on ARC-100
/api/leaderboardCart success over the fixed ARC-100 v1 test set (100 real stores, stopped before payment) for ARC browser shoppers A–E, the UCP path and the storefront MCP… - GETLook up one store's saved public card
/api/store?host=stringUse this to look up a store ARC already knows. Pass host as a hostname, such as allbirds.com. Returns the saved public card: checks, brand claim and links.… - GETOne store page as JSON or Markdown
/api/stores/page/:domainPublic URLs: /stores/{domain}.json and /stores/{domain}.md (rewritten here). The same facts the /stores/{domain} page shows, from the same saved row: verdict,… - GETOne store's verification record: claimed, served, date and method
/api/stores/record/:domainPublic URL: /store/{domain}.json (rewritten here), the record URL of the arcreport.ai/verification Poppy extension (schema: /schemas/verification-1.json).… - GETData behind the /insights research pages, as JSON or CSV
/api/insights/:fileindex.json lists every insight page with its JSON and CSV URLs. CC-BY-4.0, attribution ARC (arcreport.ai). - GETMethod version and changelog
/api/methodology/changelog - GETLatest open dataset manifest (CSV and Parquet)
/data/latest/manifest.jsonUse this to find the current open dataset. Returns snapshot_version, generated_at, method_version, license, stores_checked and the file list (CSV and… - GETEvery immutable dataset snapshot version
/data/versions.json - GETFree embeddable SVG badge. It says 'ARC checkout check passed' only for a measured checkout link, with the evidence label (Measured, Inferred or Not measured) and check date. Not a score and not a live agent session. Cached about an hour. Never starts a check.
/badge/:host.svg - GETEmbeddable SVG badge with a store's ARC result (same as /badge/{host}.svg)
/store/:host/badge.svg - GETPublic checkout outcomes for one store, labelled by source
/api/outcomes?store_domain=stringAgent-reported, ARC-tested (up to payment), and Verified purchase. A missing tier is not a mark against the store. Raw reports stay private. Spec:… - GETAsk which stores agents can reach checkout on, or read one brand
/api/askUse this to read the public ARC Index. Pass q, url, brand, or category. Shopper words such as running shoes map to Index categories. The JSON includes… - POSTRead the Index or check checkout via MCP
/api/askJSON body with url, brand, category, or q. A JSON-RPC 2.0 body speaks MCP on this same URL: initialize, tools/list and tools/call. Tools: before_checkout,…
Contribute
- GETSubmission format, schema URL and a full example body
/api/leaderboard/submit - POSTSubmit your agent's ARC-100 run
/api/leaderboard/submitFormat arc-leaderboard-submission/v1 (see /leaderboard/spec and /data/arc-100/v1/submission.schema.json). Runs must stop before payment. Listed as unverified… - GETAudit state of a submission (rule arc-audit/v2)
/api/leaderboard/audit?id=stringNever the submitted outcomes. Before a verdict: the sample size, the rule, the share of the run ARC can audit now and sha256 of the seed (seed_commitment).… - POSTAdd stores to ARC's free open directory
/api/stores/submitOne store as url, or up to 50 as hosts. Each host is validated (live HTTPS, not parked, not redirecting to another brand). Accepted stores are queued for… - POSTReport how far an agent got at checkout
/api/outcomesUse this to record one checkout attempt. Send JSON with store_domain, agent_family, agent_name, timestamp, furthest_step (product, cart, checkout, payment, or…
Discovery
- GETMCP server card for the no-login /api/ask server
/api/ask/server-card - GETMCP server card for /api/mcp. check_store, find_stores, and product_data_check need no login. A new scan needs OAuth.
/api/mcp/server-card - GETBoth MCP servers and every public tool, with docs links
/.well-known/mcp.json
API details
- Base URL
https://www.arcreport.ai- Authentication
- None declared in the description
- Operations
- 38 operations on 33 pathsGET 30POST 8
- Main resources
- Read the data 21Check a store 9Contribute 5Discovery 4
- Response formats
application/jsonapplication/mcp-server-card+jsonimage/svg+xmltext/csv- Description format
- OpenAPI 3.1.0, API version
1.1.0 - Links
- Documentation · OpenAPI document · Support
- Listed from
- Arcreport's published OpenAPI description
How to test the ARC public API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the ARC public API collection, without the publisher's secrets.
- Add your credentialsOpen the collection's variables or an environment and enter your API key or token, if the API needs one.
- Send a requestPick an endpoint, for example “Latest saved product data from the page’s structured data” (GET /api/agent-checkout/product-data?host=string), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the ARC public API?
Import this document from /openapi.json or /.well-known/openapi.json. No API key. Use getStoreCard to look up one store's saved card, canAgentCheckout to read… It is listed under E-commerce and has 38 endpoints.
Who publishes the ARC public API?
It is listed from Arcreport's public API description (an OpenAPI document), not published by Arcreport on Swastik Codes. Anyone who controls arcreport.ai can claim the profile by adding a DNS TXT record.
What is the base URL of the ARC public API?
Requests go to https://www.arcreport.ai. Endpoint paths are added to this base URL.
How do I authenticate with the ARC public API?
Its OpenAPI description does not declare an authentication scheme. Some endpoints may be open; check the provider's documentation before relying on that.
How many endpoints does the ARC public API have?
38 operations on 33 paths (30 GET, 8 POST). The largest groups are Read the data, Check a store, Contribute, Discovery.
Is forking the ARC public API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.