> ## Documentation Index
> Fetch the complete documentation index at: https://promptwatch.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Crawler Activity Trends

> Get crawler activity trends over time. If `crawlers` is omitted, the server uses all known AI crawler types so the series includes every crawler with data in the range. Projects with no recorded crawler logs return empty dates and series.



## OpenAPI

````yaml /v1/openapi.json get /analytics/crawlers/trend
openapi: 3.0.0
info:
  title: Promptwatch API
  description: API for customer integrations with Promptwatch monitoring platform
  version: 1.0.1
  contact:
    name: Promptwatch Support
    email: team@promptwatch.com
    url: https://promptwatch.com
  license:
    name: Commercial
    url: https://promptwatch.com/terms-and-conditions
servers:
  - url: https://server.promptwatch.com/api/v1
    description: Promptwatch API
security: []
tags:
  - name: Authentication
    description: API key validation and authentication
  - name: Models
    description: Available LLM models
  - name: Monitors
    description: Monitor management and data
  - name: Visibility
    description: Visibility data and insights
  - name: Citations
    description: Citation analytics and source tracking
  - name: Prompts
    description: Prompt management and operations
  - name: Analytics
    description: Analytics data and insights
  - name: Share of Voice
    description: Share of voice analytics showing brand mentions vs total responses
  - name: Responses
    description: Response analytics including mentions, competitors, and sentiment
paths:
  /analytics/crawlers/trend:
    get:
      tags:
        - Analytics
      summary: Crawler Activity Trends
      description: >-
        Get crawler activity trends over time. If `crawlers` is omitted, the
        server uses all known AI crawler types so the series includes every
        crawler with data in the range. Projects with no recorded crawler logs
        return empty dates and series.
      operationId: getCrawlerActivityTrendsV1
      parameters:
        - schema:
            type: string
            format: date
          in: query
          name: startDate
          required: false
          description: Start date for analytics data (YYYY-MM-DD)
        - schema:
            type: string
            format: date
          in: query
          name: endDate
          required: false
          description: End date for analytics data (YYYY-MM-DD)
        - schema:
            type: array
            items:
              type: string
          in: query
          name: crawlers
          required: false
          description: >-
            Filter by specific crawler keys. If omitted, crawler activity trend
            includes all known AI crawler types (server-side default to the full
            key set).
        - schema:
            type: string
          in: query
          name: timezone
          required: false
          description: IANA timezone for date bucketing (e.g., 'America/Los_Angeles')
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  dates:
                    type: array
                    items:
                      type: string
                      description: Date values
                    description: Array of dates for the time series
                  series:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: Crawler name
                        data:
                          type: array
                          items:
                            type: number
                          description: Hit counts for each date
                      required:
                        - name
                        - data
                      additionalProperties: false
                    description: Time series data for each crawler
                required:
                  - dates
                  - series
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error type
                  message:
                    type: string
                    description: Error message
                  details:
                    type: object
                    description: Additional error details
                    additionalProperties: true
                required:
                  - error
                  - message
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: Error type
                  message:
                    type: string
                    description: Error message
                  details:
                    type: object
                    description: Additional error details
                    additionalProperties: true
                required:
                  - error
                  - message
                additionalProperties: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key for authentication. Get yours from the Promptwatch dashboard
        under Settings > API Keys.

````