# Get page views (/api/analytics/views)

<!-- agent-signals: reading_time_min: 3 · est_tokens: 1682 · updated: 2026-07-30 -->
Related: [Get feedback](/api/analytics/feedback.md), [Get feedback by page](/api/analytics/feedback-by-page.md), [Get assistant conversations](/api/analytics/assistant-conversations.md), [Get assistant caller stats](/api/analytics/assistant-caller-stats.md), [Get search queries](/api/analytics/searches.md), [Get unique visitors](/api/analytics/visitors.md)

## Usage [#usage]

Use this endpoint to export page view analytics. Results include both site-wide totals and per-page breakdowns, split by human and AI traffic.

Paginate through results using offset-based pagination. Increment `offset` by `limit` while `hasMore` is true.

## Filtering [#filtering]

Filter view data by date range using `dateFrom` and `dateTo` parameters.

## Rate limits [#rate-limits]

This endpoint allows 100 requests per organization per hour. All analytics endpoints share this limit.

`GET /v1/analytics/{projectId}/views`

Returns per-path and site-wide content view event counts, split by human and AI traffic.

Authenticate with an admin API key.

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "schema": {
        "type": "string",
        "description": "Your project ID. Can be copied from the [API keys](https://app.mintlify.com/settings/organization/api-keys) page in your dashboard."
      },
      "required": true,
      "name": "projectId",
      "in": "path"
    },
    {
      "schema": {
        "type": "string",
        "description": "Date in ISO 8601 or YYYY-MM-DD format",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateFrom",
      "in": "query"
    },
    {
      "schema": {
        "type": "string",
        "description": "Date in ISO 8601 or YYYY-MM-DD format. `dateTo` is an exclusive upper limit. Results include dates before, but not on, the specified date.",
        "example": "2024-01-01"
      },
      "required": false,
      "name": "dateTo",
      "in": "query"
    },
    {
      "schema": {
        "type": "integer",
        "minimum": 1,
        "maximum": 250,
        "default": 50,
        "description": "Max results per page (1-250, default 50). Increment offset by limit while hasMore is true to paginate."
      },
      "required": false,
      "name": "limit",
      "in": "query"
    },
    {
      "schema": {
        "type": "integer",
        "minimum": 0,
        "default": 0,
        "description": "Number of rows to skip. Use offset = (page - 1) * limit for page-based access."
      },
      "required": false,
      "name": "offset",
      "in": "query"
    }
  ],
  "responses": {
    "200": {
      "description": "Site-wide and per-path content view event counts",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "totals": {
                "type": "object",
                "properties": {
                  "human": {
                    "type": "number",
                    "description": "Site-wide content view events from human traffic."
                  },
                  "ai": {
                    "type": "number",
                    "description": "Site-wide content view events from AI bot traffic."
                  },
                  "total": {
                    "type": "number",
                    "description": "Site-wide content view events."
                  }
                },
                "required": [
                  "human",
                  "ai",
                  "total"
                ]
              },
              "views": {
                "type": "array",
                "description": "Per-page view counts.",
                "items": {
                  "type": "object",
                  "properties": {
                    "path": {
                      "type": "string",
                      "description": "The documentation page path."
                    },
                    "human": {
                      "type": "number",
                      "description": "Content view events on this path from human traffic."
                    },
                    "ai": {
                      "type": "number",
                      "description": "Content view events on this path from AI bot traffic."
                    },
                    "total": {
                      "type": "number",
                      "description": "Total content view events on this path."
                    }
                  },
                  "required": [
                    "path",
                    "human",
                    "ai",
                    "total"
                  ]
                }
              },
              "hasMore": {
                "type": "boolean",
                "description": "Whether additional results are available beyond this page."
              }
            },
            "required": [
              "totals",
              "views",
              "hasMore"
            ]
          }
        }
      }
    },
    "400": {
      "description": "Invalid query parameters",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message describing what went wrong."
              },
              "details": {
                "type": "array",
                "description": "Additional details about the error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description of a specific validation or processing error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    },
    "500": {
      "description": "Server error",
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Error message describing what went wrong."
              },
              "details": {
                "type": "array",
                "description": "Additional details about the error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "message": {
                      "type": "string",
                      "description": "Description of a specific validation or processing error."
                    }
                  },
                  "required": [
                    "message"
                  ]
                }
              }
            },
            "required": [
              "error"
            ]
          }
        }
      }
    }
  }
}
```