Hub documentation
Publisher Analytics
Publisher Analytics
This feature is part of the Team & Enterprise plans.
Publisher Analytics Dashboard
Track all your repository activity with a detailed downloads overview that shows total downloads for all the Models and Datasets published by your organization. Toggle between “All Time” and “Last Month” views to gain insights across your repositories over different periods.
Per-repo breakdown
Explore the metrics of individual repositories with the per-repository drill-down table. Utilize the built-in search feature to quickly locate specific repositories. Each row also features a time-series graph that illustrates the trend of downloads over time.
Export Publisher Analytics as CSV
Download a comprehensive CSV file containing analytics for all your repositories, including model and dataset download activity.
You can also access this data programmatically via the following API endpoint:
curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
"https://huggingface.co/organizations/YOUR_ORG_NAME/settings/publisher-analytics/download-breakdown" \
--output breakdown.csvResponse Structure
The CSV file is made of daily download records for each of your models and datasets.
repoType,repoName,total,timestamp,downloads
model,huggingface/CodeBERTa-small-v1,4362460,2021-01-22T00:00:00.000Z,4
model,huggingface/CodeBERTa-small-v1,4362460,2021-01-23T00:00:00.000Z,7
model,huggingface/CodeBERTa-small-v1,4362460,2021-01-24T00:00:00.000Z,2
dataset,huggingface/documentation-images,2167284,2021-11-27T00:00:00.000Z,3
dataset,huggingface/documentation-images,2167284,2021-11-28T00:00:00.000Z,18
dataset,huggingface/documentation-images,2167284,2021-11-29T00:00:00.000Z,7Repository Object Structure
Each record in the CSV contains:
repoType: The type of repository (e.g., “model”, “dataset”)repoName: Full repository name including organization (e.g., “huggingface/documentation-images”)total: Cumulative number of downloads for this repositorytimestamp: ISO 8601 formatted date (UTC)downloads: Number of downloads for that day
Records are ordered chronologically and provide a daily granular view of download activity for each repository.
Download figures are not deduplicated by user. If you need unique download counts, refer to the next section.
Unique downloaders and more granular logs
This feature is an add-on for the Enterprise Plus plan.
As an advanced feature, Hugging Face can export anonymized, request-level access logs for all of the models and datasets published by your organization. Each line represents a single download request (including HEAD and partial requests), giving you full granularity over your models and datasets’ download data.
Your team is responsible for ingesting these logs and running computations on them — for example, to deduplicate downloads to get unique downloader counts.
| Column | Description |
|---|---|
timestamp | Request timestamp |
requestType | Type of download request (GET, HEAD, partial/range) |
repoName | Full repo name (e.g. nvidia/segformer-b0) |
repoType | model or dataset |
hashedUserId | Non-reversible hash of user ID (if authenticated) |
hashedIp | Non-reversible hash of IP address (if unauthenticated) |
country | Country ISO code |
region | Region name |
isInternal | Whether the request comes from an HF internal service |
As it requires setting up a custom data export pipeline on our side (custom Elastic index, etc), this is only available as an add-on to Enterprise Plus.
Update on GitHub