# GitHub REST API

**Provider:** GitHub
**Category:** social
**Base URL:** `https://api.github.com`
**Auth:** bearer — `Authorization: Bearer ghp_...`
**Rate Limit:** 5,000 requests/hour (authenticated)
**Free Tier:** Yes — [object Object]
**Pricing:** Free tier available (freemium)
**Docs:** https://docs.github.com/en/rest

## Description

GitHub's REST API exposes the entire GitHub platform: create and manage repositories, open and close issues, create pull requests and reviews, search code across all public repos, trigger Actions workflows, manage GitHub Apps, and retrieve user and organization data.

## Endpoints

| Method | Endpoint | Description |
|--------|----------|-------------|
| GET | `https://api.github.com/repos/{owner}/{repo}` | Get repository metadata |
| POST | `https://api.github.com/repos/{owner}/{repo}/issues` | Create an issue |
| GET | `https://api.github.com/repos/{owner}/{repo}/pulls` | List pull requests |
| GET | `https://api.github.com/search/code` | Search code across GitHub |
| POST | `https://api.github.com/repos/{owner}/{repo}/actions/workflows/{id}/dispatches` | Trigger a workflow |
| GET | `https://api.github.com/user` | Get authenticated user info |

## Authentication

Authenticate with a personal access token or GitHub App token as a Bearer token.

```
Authorization: Bearer ghp_...
```

## Sample Request

```bash
curl https://api.github.com/repos/anthropics/anthropic-sdk-python \
  -H "Authorization: Bearer $GITHUB_TOKEN" \
  -H "Accept: application/vnd.github+json"
```

## Sample Response

```json
{
  "id": 602413,
  "name": "anthropic-sdk-python",
  "full_name": "anthropics/anthropic-sdk-python",
  "description": "The official Python library for the Anthropic API",
  "stargazers_count": 4128,
  "forks_count": 421,
  "open_issues_count": 18,
  "language": "Python",
  "default_branch": "main"
}
```

## Pricing Details

REST API access is free. GitHub plans (Free, Team $4/user/mo, Enterprise $21/user/mo) govern repository features, not API access.

---

*Source: [API Map](https://apimap.dev/apis/github/) — CC BY 4.0*