gitee.com APIgitee.com ↗
Access Gitee repository metadata, user profiles, commit history, file contents, and search results via 7 structured API endpoints.
curl -X GET 'https://api.parse.bot/scraper/07f5a5e4-6e57-4928-b7ae-67bf6023e7d8/get_repository?repo=git&owner=git-mirrors' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch full details of a single repository by owner and repo name. Returns comprehensive metadata including stars, forks, language, project labels, and namespace information.
| Param | Type | Description |
|---|---|---|
| reporequired | string | Repository name path. |
| ownerrequired | string | Repository owner (user or organization) path. |
{
"type": "object",
"fields": {
"id": "integer repository ID",
"name": "string display name",
"language": "string primary programming language or null",
"full_name": "string owner/repo path",
"namespace": "object with id, type, name, path fields",
"description": "string repository description",
"forks_count": "integer fork count",
"project_labels": "array of label objects with id, name, ident fields",
"stargazers_count": "integer star count"
},
"sample": {
"data": {
"id": 6549348,
"name": "vn.py",
"language": "Python",
"full_name": "vnpy/vnpy",
"namespace": {
"id": 1925923,
"name": "vn.py官方",
"path": "vnpy",
"type": "group"
},
"description": "基于Python的开源量化交易平台开发框架",
"forks_count": 1509,
"project_labels": [
{
"id": 7,
"name": "Python",
"ident": "Python"
}
],
"stargazers_count": 3118
},
"status": "success"
}
}About the gitee.com API
This API covers 7 endpoints for exploring Gitee, China's largest Git hosting platform. It returns repository metadata, user profiles, commit histories, and directory contents. The search_repositories endpoint accepts a keyword query and returns paginated hits with star counts, languages, and descriptions. Repository-specific endpoints like get_repository expose fields including project_labels, namespace, stargazers_count, and forks_count in a single call.
Repository Data
The get_repository endpoint takes owner and repo path parameters and returns a full metadata object: integer id, full_name, language, description, stargazers_count, forks_count, a namespace object with id, type, name, and path fields, and a project_labels array where each label carries id, name, and ident fields. The companion get_repository_type endpoint returns classification-specific fields: gvp (Gitee Very Valuable Project boolean), recommend, outsourced, namespace_type, and a flat array of label name strings.
Search and User Listings
search_repositories accepts a query string plus optional page and per_page parameters. The response wraps results in a hits object that contains a total sub-object (with value and relation) and an array of hit objects carrying _id, _score, and fields. The took integer at the root tells you server-side search time in milliseconds. list_user_repos lists public repositories for a username with the same pagination controls, returning an array of repository objects that include full_name, language, stargazers_count, forks_count, and description.
Commits and File Trees
list_repo_commits returns a paginated array of commit objects for any owner/repo pair. Each entry includes sha, url, a nested commit object with author, committer, and message fields, plus top-level author, committer, and parents fields. list_repo_contents lists files and directories at a given path (root if omitted), returning objects with type (dir or file), name, path, sha, url, html_url, and download_url.
User Profiles
get_user accepts a username and returns a public profile: integer id, login, name, bio, avatar_url, followers, following, and public_repos counts. This is sufficient to build user-level summaries without additional calls.
- Aggregate trending Gitee repositories by star count using
search_repositorieswith keyword queries - Compare GVP and recommendation status across repositories using
get_repository_type - Build a commit activity timeline for a project via
list_repo_commitspagination - Catalog a user's public portfolio by combining
get_userprofile data withlist_user_reposresults - Inventory source files and directory structure of a repository using
list_repo_contentswith a path parameter - Filter repositories by programming language using the
languagefield returned byget_repository - Identify project category labels across a namespace using
project_labelsfromget_repository
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Gitee have an official developer API?+
What does `get_repository_type` return that `get_repository` does not?+
get_repository_type returns the gvp boolean (Gitee Very Valuable Project designation), recommend, outsourced, and namespace_type fields, and a flat array of label name strings. get_repository returns richer repository metadata — stars, forks, full namespace object, description — but does not include the GVP or recommendation flags.Does `search_repositories` support filtering by language or label?+
query string and optional page/per_page parameters. Language or label filtering is not exposed as separate parameters — the full-text query drives results. You can fork this API on Parse and revise it to add language or label filter parameters if Gitee's search supports them.Does the API cover issues, pull requests, or repository stars lists?+
Are there pagination limits on `list_repo_commits` or `list_repo_contents`?+
list_repo_commits accepts page as an optional integer to step through results. list_repo_contents does not support pagination — it returns all entries at the specified path in a single response. For very large directories this means the response may be long, but no page parameter is available for that endpoint.