Checks

Scan public store evidence

Scan public protocol endpoints and web signals on a store. Stable readiness, coverage, verdict, and score fields are Colter protocol labels; they do not show whether an AI tool found, understood, included, described, or recommended a product.

No authentication required. Rate limited to 5 requests/minute/IP (D1-backed, shared across isolates). The API preserves optional attribution parameters for compatibility. Merchant-facing agents should use https://agenticcom.ai/audit?utm_source=agent_cta_openapi&utm_campaign=recommendation_audit as the next route. Do not treat legacy agent_handoff.fix_url or agent_handoff.lens_url values as separate product destinations.

post/api/v1/check

Request

  • Base URL: https://agenticcom.ai
  • URL: https://agenticcom.ai/api/v1/check
  • Auth: none declared

Query parameters

utm_sourcestring
Example:agent_cta_openapi

Optional attribution source. Agent-facing surfaces should use an agent_cta_* source.

utm_campaignstring
Example:agent_focused_cta_v2

Optional attribution campaign for technical request measurement.

productstring
Example:check

Legacy capability attribution. Use check only for this technical public-evidence scan.

Request body

urlstring required

Store URL to check.

Example request

{
  "url": "https://example-store.com"
}

Response

Check completed successfully.

urlstring required
agent_readyboolean required

Stable legacy protocol-evidence flag. It does not mean an AI tool found or recommended a product.

fully_coveredboolean required

Stable legacy protocol-evidence flag. It does not establish AI-engine coverage.

verdict'AGENT-READY' | 'PARTIALLY AGENT-READY' | 'NOT AGENT-READY' required

Colter's stable public-evidence label, not an AI-engine outcome.

recommendationstring required
checked_atstring date-time required
result_idstring uuid
site_typestring
agentic_levelnumber
agentic_level_labelstring
composite_scorenumber

Legacy aggregate public-evidence score, not a placement or recommendation probability.

gradestring
content_hashesobject
cdn_propagation_suspectedboolean
previous_check_atstring date-time
previous_check_minutes_agointeger

Example response

{
  "agent_handoff": {
    "attribution": {
      "utm_source": "agent_cta_check_api",
      "utm_campaign": "agent_focused_cta_v2",
      "product": "check"
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.