Skip to main content
GET
Get library usage metrics

Authorizations

Authorization
string
header
required

Get your API key at context7.com/dashboard. Treat your API key like a password and store it securely.

Query Parameters

libraryId
string
required

Context7-compatible library ID — the URL path of the library on context7.com. Use /owner/repo for GitHub repositories, or /<source>/<id> for other sources (websites, llms.txt, GitLab/Bitbucket, etc.). Optionally suffix with /<version> or @<version> to pin a specific version. See Library ID format.

Required string length: 1 - 500
Pattern: ^/[^/]+/[^/]+([/@][^/]+)?$
days
integer
default:30

Number of days of daily history to return (1-365). Defaults to 30.

Required range: 1 <= x <= 365

Response

Library usage metrics

Library usage metrics response

total
object
required

Cumulative request counts for a library, broken down by request surface

daily
object[]
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.

mcpClients
object
required

MCP client usage breakdown by day

topics
object[]
required

Lifetime topic distribution, ordered by count descending

countries
object[]
required

Lifetime country distribution (ISO-2 codes), ordered by count descending