> ## Documentation Index > Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt > Use this file to discover all available pages before exploring further. # Get crawler analytics > Retrieve retained AI crawler activity, delivery coverage, and page-level observations for a brand. Retrieve AI crawler activity observed through the brand's configured log integration. The endpoint returns daily aggregates and page-level observations. It never returns raw log events or human traffic. All occurrence totals, crawler breakdowns, and page rankings use the public set of supported observable AI-specific User-Agent identities. The ingestion registry can recognize additional identities for classification and compatibility, but the endpoint excludes them from its public analytics output. Classification matches the received User-Agent token; it does not verify source IP or reverse DNS. This endpoint requires an active Business, Enterprise, or Agency Business plan, or an explicit Crawler Analytics feature override for the team. Results are observational: check `coverage` before interpreting counts or comparing periods. Bearer token. Example: `Bearer qw-api-xxx` ## Path parameters Unique identifier of the brand. ## Query parameters Inclusive analytic-day preset in the integration's IANA time zone: `24h` is the current analytic day, `7d` is that day plus the preceding six, and `30d` is that day plus the preceding 29. `24h` is not a rolling 24-hour window. Page-state filter: `all`, `new`, `hot`, or `neglected`. One-based page number. Maximum: `10000`. Page size. Maximum: `100`. ## Page-state semantics * `new`: the first retained page observation falls within the last 7 days, including the boundary (`firstSeenAt >= now - 7 days`). * `hot`: the page is in the top decile by supported-crawler occurrences over the current 7 analytic days, has activity on at least 2 of those days, and is not neglected. * `neglected`: the most recent retained page observation is strictly older than the 30-day boundary. `new` and `hot` can coexist. `neglected` is exclusive. The hot window is independent of the requested `range`. ## Response Indicates whether the request succeeded. Brand `id`, `name`, and `domain`. Whether the integration is active, not disabled, and has at least one active non-revoked key. Current integration lifecycle, or `null` when no integration exists. Current integration health, or `null` when no integration exists. Requested and effective dates, observed and verified bucket counts, truncation state, and the `asOf` timestamp. Whether the selected range contains at least one supported public occurrence. `observed` when supported observations exist without a known gap; `not_measured` when none exist and no gap is known; `incomplete_ingestion` for a quota limit or provider gap, with or without observations. Bit flags: `1` delivery unverified, `2` quota limited, and `4` provider gap. `exact`; `at_least_once` when repackaged retries can duplicate observations; or `capped` when a count exceeds safe numeric precision. `verified` when every elapsed bucket is verified; `incomplete` for a known gap or profile change; otherwise `unverified`. Observed occurrences from the supported public crawler set in the effective range. A number is returned only when at least one supported public rollup has a positive request count; otherwise the value is `null`, not a measured zero. With incomplete ingestion, a numeric value can still be partial. Occurrences associated with a retained page identity. Requests that returned a redirect. Requests that returned `404`. Other observed error responses. Daily totals, crawler breakdowns, error totals, and coverage metadata. Totals by crawler in the supported public set, including its display name, bot type, and error breakdown. Stable page identity. Observed path or an internal pseudonym. When `true`, do not reconstruct or link to a URL from `path`. First observed timestamp. Most recent observed timestamp. Retained lifetime occurrence count. Computed states. `new` and `hot` can coexist; `neglected` is exclusive. Occurrences in the selected range. Occurrence count keyed by crawler name. Distinct observed crawlers. HTTP status-group totals. Live-search, training, and other crawler totals. Page-by-crawler daily rollups retain 30 analytic days. Durable page identities preserve first seen, last seen, and lifetime count beyond that window. Query strings and fragments are removed; sensitive-looking or overlong paths can be replaced with an integration-scoped one-way pseudonym. One-based `page`, `limit`, `totalItems`, `totalPages`, and `hasMore`. Always `false`. Raw log events are not exposed by this endpoint. Always `false`. ## Synthetic request ```bash theme={null} curl "https://www.qwairy.co/api/v1/brands/cm1234567890abcdef/crawler-analytics?range=7d&state=hot&limit=25" \ -H "Authorization: Bearer qw-api-your-token-here" ``` ## Interpret missing or incomplete data * Treat `totalOccurrences: null` as not measured. Do not convert it to zero. * Check `coverage.dataStatus`, `countPrecision`, and `deliveryContinuity` before comparing periods. * Use `range.startDate` and `range.endDate` for the effective comparison window. * Do not build a public URL from a page where `isPseudonymized` is `true`. ## Errors | Status | Meaning | | ------ | --------------------------------------------------------------------------------------- | | `400` | Invalid range, state, or pagination value | | `401` | Missing or invalid API token | | `403` | The team has neither an eligible active plan nor an explicit Crawler Analytics override | | `404` | Brand not found or not accessible to the token's team | | `429` | Rate limit exceeded; honor `Retry-After` | See [Crawler Analytics](/documentation/measure/crawler-analytics) for setup and the product interface, and [Rate limits](/developers/rate-limits) for retry behavior.