> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/hugging-face/repos-repotype-owner-name-commits>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/hugging-face/repos-repotype-owner-name-commits.mdx>

---

# Hugging Face Commits API

A repository's commit history, page by page, with the message, date and authors of each commit.

`GET /v1/hugging-face/repos/{repoType}/{owner}/{name}/commits` returns `repo`, `totalCount`, the `commits` page and a numbered `page` block. Each commit has `sha`, `title`, `message`, `committedAt` and `authors` with `username` and `avatarUrl`.

`revision` selects a branch, tag or commit, `limit` accepts up to 50 and `page` is 1-based. `lookupStatus` is `found`, `not_found` or `restricted`; `restricted` means the repository exists but its history is gated.

## Request

- **Endpoint:** `GET /v1/hugging-face/repos/{repoType}/{owner}/{name}/commits`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by repository
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/hugging-face/repos/repotype/owner/name/commits/get)
- **Platform page:** [/platforms/hugging-face](https://www.socialfetch.dev/platforms/hugging-face)

## FAQ

### What does lookupStatus=restricted mean?

The repository exists but its history is not public. That is different from not_found, where no such repository is visible.

### Can I read commits on a branch?

Yes. Pass revision as the branch name, tag or commit id. The default is the repository's default branch.

### How many commits are on a page?

limit accepts 1 to 50 and defaults to 50. Use the page number to read older commits.

### How much does a commit page cost?

Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
