Sign in
Proxy Logs

Get the top pages accessed by a specific AI agent over a time window.

Changed on

Returns page paths ranked by request count, scoped to a single canonical agent name (e.g. ChatGPT-User). Use GET /proxy-logs/ai-agents/known to list all valid agent names. Unknown agent names return an empty items array.

get/proxy-logs/stats/ai-agent-pages

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/proxy-logs/stats/ai-agent-pages
  • Auth: HTTP bearer

Query parameters

agentstring required

Canonical agent name to filter by (e.g. ChatGPT-User, ClaudeBot). Must be a name returned by GET /proxy-logs/ai-agents/known.

project_idinteger nullable

Filter by project ID.

environment_idinteger nullable

Filter by environment ID.

start_timestring nullable

Start time (ISO 8601). Defaults to end_time - 7d.

end_timestring nullable

End time (ISO 8601). Defaults to now.

limitinteger nullable

Maximum rows to return. Capped at 100 server-side.

Response

Pages breakdown for the requested agent

agentstring required

The agent name this breakdown is scoped to.

end_timestring required
start_timestring required

Example response

{
  "items": [
    {
      "last_seen": "2026-05-29T12:00:00Z"
    }
  ]
}

Changes

  • 4b228ebed583Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

  • 1dc3e6788214Revision changes
    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status