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-related request, giving you full granularity over your models and datasets’ download data.
Your team is responsible for ingesting these logs and running computations on them. The export intentionally includes raw HTTP status codes and methods so you can classify HEAD, partial-content, redirect, and other request patterns based on your own analytics needs.
| Column | Description |
|---|---|
timestamp | Request timestamp |
status | HTTP status code (for example 200, 206, 302, 307, 304) |
method | HTTP method (for example GET, HEAD) |
repoName | Full repo name (e.g. nvidia/segformer-b0) |
repoType | Repository type: model, dataset, or space |
hashedUserId | Non-reversible hash of user ID (if authenticated) |
hashedIp | Non-reversible hash of IP address (if unauthenticated) |
country | Country ISO code |
region | Region or city name |
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