Katib API

🔐 Authentication

All endpoints require a username parameter.

GitHub Personal Access Token via Authorization: Bearer TOKEN header prevents API rate limiting.

GitHub PAT Setup: GitHub Settings → Developer settings → Personal access tokens → Generate new token

No special permissions needed - used only to avoid hitting GitHub's API rate limits

📡 API Endpoints

GET /commits/latest

Get the most recent commit with full details including parent commits and language breakdown

Parameter	Type	Required	Description
username	string	Yes	GitHub username

GET /v2/commits/latest

Get recent commits list with aggregated statistics and complete language analysis

Parameter	Type	Required	Description
username	string	Yes	GitHub username
limit	integer	No	Number of commits (default: 10)

GET /streak

Get GitHub contribution streak information including current and highest streaks

Parameter	Type	Required	Description
username	string	Yes	GitHub username

💻 Usage Examples

Basic Usage

curl "https://katib.jasoncameron.dev/commits/latest?username=jasonlovesdoggo"
curl "https://katib.jasoncameron.dev/v2/commits/latest?username=torvalds&limit=5"

With Authentication

curl -H "Authorization: Bearer ghp_your_token_here" \
     "https://katib.jasoncameron.dev/commits/latest?username=octocat"

curl -H "Authorization: Bearer ghp_your_token_here" \
     "https://katib.jasoncameron.dev/streak?username=torvalds"