Kanorio
Kanorio Developers

API reference

Analytics

Content Delivery API: POST /analytics/pageview, POST /analytics/bot-hit

Base URL https://{site}/api/v1ErrorsPagination

Record an anonymous pageview from an external storefront (per-IP rate-limited)

POST/analytics/pageview
betaNo auth

Request body

  • pathstringrequired

    Relative path starting with /

  • referrerstring
  • titlestring
  • uaCategory"desktop" | "mobile" | "tablet" | "bot"

Response 200

  • uaCategorystring

Errors

  • INVALID_BODY 400
  • INVALID_PATH 400
curl -X POST "https://{site}/api/v1/analytics/pageview" \
  -H "Content-Type: application/json" \
  -d '{}'

Record an AI crawler visit from an external storefront edge middleware (per-IP rate-limited)

POST/analytics/bot-hit
betaNo auth

Request body

  • botTokenstring

    Recognized crawler token (e.g. GPTBot, ClaudeBot, PerplexityBot)

  • pathstringrequired

    Relative path starting with /

  • userAgentstring

Errors

  • INVALID_BODY 400
  • INVALID_PATH 400
  • UNKNOWN_BOT 400
curl -X POST "https://{site}/api/v1/analytics/bot-hit" \
  -H "Content-Type: application/json" \
  -d '{}'