Hugging Face Hub APIs

This document catalogs various API endpoints for the Hugging Face Hub that I've explored. Some of these endpoints are not officially documented in the Hugging Face API reference but can be useful for various applications. Note that since some of these endpoints are undocumented, they may change without notice.

User Endpoints

User overview:

https://huggingface.co/api/users/<user>/overview
      

User likes:

https://huggingface.co/api/users/<user>/likes
      

User activity:

https://huggingface.co/api/recent-activity?limit=<limit, default: 60>&activityType=<discussion|upvote|like>&feedType=<user|organization>&skip=0&entity=<username>
      

Follow user:

https://huggingface.co/api/users/<user>/follow
      

User followers:

https://huggingface.co/api/users/<user>/followers
      

User following:

https://huggingface.co/api/users/<user>/following
      

Check if a username is available:

https://huggingface.co/api/username-check?username=<username>
      

List user repos:

https://huggingface.co/models-json?p=0&sort=modified&author=<username>
      

Organization

Some routes in the User section also work for organizations. List organization members:

https://huggingface.co/api/organizations/<org>/members
      

Repository

Model overview:

https://huggingface.co/api/<model|dataset|space>s/<username>/<repo>
      

List model discussions:

https://huggingface.co/api/<model|dataset|space>s/<username>/<repo>/discussions
      

View specific discussion:

https://huggingface.co/api/<model|dataset|space>s/<username>/<repo>/discussions/<discussion_id>