---
title: "Get library usage metrics"
method: GET
path: "/v2/libs/metrics"
tags: ["Metrics"]
---

# Get library usage metrics

`GET /v2/libs/metrics`

Retrieve full usage metrics for a library: cumulative and daily request counters broken down by surface (web page, text docs, MCP, CLI), MCP client daily unique-user breakdown, and lifetime topic and country distributions. The API key must belong to a member of the teamspace that owns the library — claim ownership from the library's admin page on context7.com.

## Query parameters

- `libraryId` string, required
- `days` integer

## Response `200`

Library usage metrics

- LibraryMetricsResponse — Library usage metrics response
  - `total` ProjectStats, required — Cumulative request counts for a library, broken down by request surface
    - `page` integer, required — Requests served to the context7.com web UI
    - `txt` integer, required — Plain-text documentation requests
    - `mcp` integer, required — Requests served via the Context7 MCP server
    - `cli` integer, required — Requests served to the Context7 CLI
  - `daily` DailyStatsPoint[], required — Per-day request counts (deltas, not cumulative), ordered from oldest to newest. Days with zero activity are omitted. Up to `days` points — fewer if the library has less history or had idle days in the window.
    - `date` string, date, required — UTC date in `YYYY-MM-DD` format
    - `page` integer, required — Requests served to the context7.com web UI on this date
    - `txt` integer, required — Plain-text documentation requests on this date
    - `mcp` integer, required — Requests served via the Context7 MCP server on this date
    - `cli` integer, required — Requests served to the Context7 CLI on this date
    - `total` integer, required — Sum of all request surfaces on this date (`page + txt + mcp + cli`)
  - `mcpClients` McpClientMetrics, required — MCP client usage breakdown by day
    - `dailyData` McpDailyClientData[], required — Per-day MCP client unique-user breakdown, ordered from oldest to newest
      - `date` string, date, required — UTC date in `YYYY-MM-DD` format
      - `uniqueUsersByClient` object, required — Unique user count per MCP client identifier (e.g., `cursor`, `claude-code`, `codex`)
      - `totalUniqueUsers` integer, required — Total unique users across all clients for this library on this date
  - `topics` TopicCount[], required — Lifetime topic distribution, ordered by count descending
    - `topic` string, required — Normalized, lowercased topic string
    - `count` integer, required — Number of requests that referenced this topic
  - `countries` CountryCount[], required — Lifetime country distribution (ISO-2 codes), ordered by count descending
    - `country` string, required — ISO 3166-1 alpha-2 country code
    - `count` integer, required — Number of requests originating from this country

## Other responses

- `400` — Bad Request - Invalid input parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions or plan restrictions
- `404` — Not Found - Resource doesn't exist
- `500` — Internal Server Error

---

[API](https://skmtc.dev/context7/apis/context7-public-api.md) · [All operations](https://skmtc.dev/context7/apis/context7-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/context7/context7-public-api/revisions/5e85fc74bff0/schema)