> ## Documentation Index > Fetch the complete documentation index at: https://docs.otterly.ai/llms.txt > Use this file to discover all available pages before exploring further. # List pages visited by AI agents for a brand report > Per-URL breakdown of AI agent traffic, busiest page first. Pages are segmented per domain: the same path on the report's main domain and on a domain variation are two separate items. URLs are normalized at ingest — query strings are stripped and the path is domain-relative. ## OpenAPI ````yaml https://data.otterly.ai/v1/openapi.json get /v1/reports/brand/{reportId}/agent-analytics/pages openapi: 3.0.0 info: title: Otterly Public API version: 1.0.0 servers: - url: https://data.otterly.ai security: [] tags: - name: Engines - name: Workspaces - name: Tags - name: Prompts - name: Brand Reports - name: Audits - name: Accounts paths: /v1/reports/brand/{reportId}/agent-analytics/pages: get: tags: - Brand Reports summary: List pages visited by AI agents for a brand report description: >- Per-URL breakdown of AI agent traffic, busiest page first. Pages are segmented per domain: the same path on the report's main domain and on a domain variation are two separate items. URLs are normalized at ingest — query strings are stripped and the path is domain-relative. parameters: - schema: type: string minLength: 1 example: 01HX7K2YV9D3M8N0G6Q5R4S3T2 description: Brand report identifier. required: true description: Brand report identifier. name: reportId in: path - schema: type: string description: >- Optional. Start of the window (inclusive), `YYYY-MM-DD`. Omit it to get the 13 days before `endDate`; omit both dates for the last 14 days (UTC), matching the dashboard. example: '2026-08-07' required: false description: >- Optional. Start of the window (inclusive), `YYYY-MM-DD`. Omit it to get the 13 days before `endDate`; omit both dates for the last 14 days (UTC), matching the dashboard. name: startDate in: query - schema: type: string description: >- Optional. End of the window (inclusive), `YYYY-MM-DD`. Defaults to today (UTC). example: '2026-08-20' required: false description: >- Optional. End of the window (inclusive), `YYYY-MM-DD`. Defaults to today (UTC). name: endDate in: query - schema: type: string enum: - chatgpt - claude - copilot - perplexity - google - other description: >- Optional. Restrict results to a single engine. Omit for all engines. Pass `other` to match every AI crawler outside the named engines. example: chatgpt required: false description: >- Optional. Restrict results to a single engine. Omit for all engines. Pass `other` to match every AI crawler outside the named engines. name: engine in: query - schema: type: string maxLength: 200 description: >- Optional. Case-insensitive substring match on the page URL, up to 200 characters. Matched literally — `%` and `_` are not wildcards. required: false description: >- Optional. Case-insensitive substring match on the page URL, up to 200 characters. Matched literally — `%` and `_` are not wildcards. name: search in: query - schema: type: integer description: >- Optional. Zero-based offset for pagination; must be a multiple of `limit`. Defaults to 0. required: false description: >- Optional. Zero-based offset for pagination; must be a multiple of `limit`. Defaults to 0. name: offset in: query - schema: type: integer description: >- Optional. Maximum number of items to return, up to 100. Defaults to 25. required: false description: >- Optional. Maximum number of items to return, up to 100. Defaults to 25. name: limit in: query responses: '200': description: A page of visited URLs for the brand report. content: application/json: schema: $ref: '#/components/schemas/PublicApiAgentAnalyticsPagesList' '400': description: Validation failed. content: application/json: schema: $ref: '#/components/schemas/PublicApiValidationErrorResponse' '401': description: Unauthorized. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponse' '403': description: Forbidden. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponse' '404': description: Report not found. content: application/json: schema: $ref: '#/components/schemas/PublicApiErrorResponse' security: - BearerAuth: [] components: schemas: PublicApiAgentAnalyticsPagesList: type: object properties: availability: type: string enum: - not_connected - connected_no_data - connected_with_data description: >- Whether these numbers can be trusted. `not_connected` means no logs connector is active for this report — metrics are `null`, NOT zero, because nothing is being measured. `connected_no_data` means a connector is active but matched no visits in this window, so the zeros are real. `connected_with_data` means the payload is populated. example: connected_with_data startDate: type: string description: Start of the resolved window (inclusive), `YYYY-MM-DD`. endDate: type: string description: End of the resolved window (inclusive), `YYYY-MM-DD`. domains: type: array items: type: string description: >- The report's own domains the query spanned — its main domain plus its domain variations. Normalized (lowercased, `www.` and port stripped). items: type: array items: $ref: '#/components/schemas/PublicApiAgentAnalyticsPage' paging: $ref: '#/components/schemas/PublicApiOffsetPagingWithTotal' required: - availability - startDate - endDate - domains - items - paging example: availability: connected_with_data startDate: '2026-08-07' endDate: '2026-08-20' domains: - adidas.com - blog.adidas.com items: - url: /us/running domain: adidas.com urlHash: 7394a2bb766646caa82a16a34a250b2449664fc51e5d76fada32505090d45f1c totalVisits: 4320 engines: - engine: chatgpt visits: 2882 - engine: google visits: 1438 paging: limit: 25 offset: 0 totalCount: 412 PublicApiValidationErrorResponse: type: object properties: message: type: string target: type: string errors: type: array items: type: object properties: path: type: string message: type: string code: type: string required: - path - message - code required: - message - target - errors example: message: Validation failed target: query errors: - path: country message: Required code: invalid_type PublicApiErrorResponse: type: object properties: message: type: string required: - message example: message: Report not found PublicApiAgentAnalyticsPage: type: object properties: url: type: string description: Domain-relative path, normalized at ingest (query string stripped). domain: type: string description: >- Which of the report's domains this page belongs to. Pages are per-domain: the same path on two domains is two items. urlHash: type: string description: Stable identifier for the page within a domain. totalVisits: type: integer minimum: 0 engines: type: array items: type: object properties: engine: type: string enum: - chatgpt - claude - copilot - perplexity - google - other description: >- AI engine an agent visit is attributed to. `other` covers every AI crawler that is not one of the named engines (for example Amazon, Meta, xAI, ByteDance, Common Crawl). example: chatgpt visits: type: integer minimum: 0 required: - engine - visits description: >- Per-engine split of this page's visits, highest first. Sums to `totalVisits`. required: - url - domain - urlHash - totalVisits - engines example: url: /us/running domain: adidas.com urlHash: 7394a2bb766646caa82a16a34a250b2449664fc51e5d76fada32505090d45f1c totalVisits: 4320 engines: - engine: chatgpt visits: 2882 - engine: google visits: 1438 PublicApiOffsetPagingWithTotal: type: object properties: limit: type: integer minimum: 1 offset: type: integer minimum: 0 totalCount: type: integer minimum: 0 required: - limit - offset - totalCount example: limit: 25 offset: 0 totalCount: 137 securitySchemes: BearerAuth: type: http scheme: bearer description: >- Provide your API key as a Bearer token: `Authorization: Bearer YOUR_API_KEY`. ````