GitHub API
GitHub REST API for repository management, user information, and code search
Quick start
Tools (8)
GETget-current-user
Returns profile information for the currently authenticated user including login, name, email, and other account details. Use this to verify authentication and get user context.
GET /user
GETget-repository
Returns detailed information about a specific repository including description, language, stars, forks, and metadata. Use this to understand repository characteristics before performing other operations.
GET /repos/{owner}/{repo}
Parameters
owner
|
string required |
repo
|
string required |
GETget-file-content
Returns the contents of a file or directory in a repository. For files, returns base64-encoded content that needs to be decoded. For directories, returns an array of file/directory objects.
GET /repos/{owner}/{repo}/contents/{path}
Parameters
owner
|
string required |
repo
|
string required |
path
|
string required |
ref
|
string |
GETlist-issues
Returns a list of issues for the specified repository. Includes both open and closed issues based on state parameter. Use this to track bugs, feature requests, and project tasks.
GET /repos/{owner}/{repo}/issues
Parameters
owner
|
string required |
repo
|
string required |
state
|
string |
per_page
|
integer |
POSTcreate-issue
Creates a new issue in the specified repository. This operation adds a new item to the project's issue tracker and may trigger notifications to repository watchers. Requires push access to the repository.
POST /repos/{owner}/{repo}/issues
Parameters
owner
|
string required |
repo
|
string required |
title
|
string required |
body
|
string |
labels
|
array |
GETsearch-repositories
Searches for repositories matching the specified query terms. Returns repositories sorted by relevance, stars, forks, or update time. Use this to discover repositories related to specific topics or technologies.
GET /search/repositories
Parameters
q
|
string required |
sort
|
string |
per_page
|
integer |
GETsearch-code
Searches for code snippets, files, or specific text within repository contents. Limited to files under 384 KB and repositories with fewer than 500,000 files. Use this to find code examples or specific implementations.
GET /search/code
Parameters
q
|
string required |
per_page
|
integer |
GETget-user
Returns public profile information for any GitHub user including their repositories count, followers, following, and bio. Use this to get context about repository owners or contributors.
GET /users/{username}
Parameters
username
|
string required |