HTTP/2 302 server: nginx date: Wed, 23 Jul 2025 16:37:44 GMT content-type: text/plain; charset=utf-8 content-length: 0 x-archive-redirect-reason: found capture at 20081231055733 location: https://web.archive.org/web/20081231055733/https://github.com/guides/the-github-api server-timing: captures_list;dur=0.874525, exclusion.robots;dur=0.026036, exclusion.robots.policy;dur=0.012279, esindex;dur=0.016743, cdx.remote;dur=341.278085, LoadShardBlock;dur=1577.663137, PetaboxLoader3.datanode;dur=229.771800, PetaboxLoader3.resolve;dur=1221.598625 x-app-server: wwwb-app221 x-ts: 302 x-tr: 1962 server-timing: TR;dur=0,Tw;dur=0,Tc;dur=0 set-cookie: SERVER=wwwb-app221; path=/ x-location: All x-rl: 0 x-na: 0 x-page-cache: MISS server-timing: MISS x-nid: DigitalOcean referrer-policy: no-referrer-when-downgrade permissions-policy: interest-cohort=() HTTP/2 200 server: nginx date: Wed, 23 Jul 2025 16:37:48 GMT content-type: text/html; charset=utf-8 x-archive-orig-server: nginx/0.6.31 x-archive-orig-date: Wed, 31 Dec 2008 05:57:33 GMT x-archive-orig-connection: close x-archive-orig-status: 200 OK x-archive-orig-x-runtime: 250ms x-archive-orig-etag: "6f2e59687d8ee9bb3ce411e2ac409b3a" x-archive-orig-cache-control: private, max-age=0, must-revalidate x-archive-orig-content-length: 10148 x-archive-guessed-content-type: text/html x-archive-guessed-charset: utf-8 memento-datetime: Wed, 31 Dec 2008 05:57:33 GMT link: ; rel="original", ; rel="timemap"; type="application/link-format", ; rel="timegate", ; rel="first memento"; datetime="Sun, 16 Mar 2008 05:32:32 GMT", ; rel="prev memento"; datetime="Wed, 17 Dec 2008 14:15:44 GMT", ; rel="memento"; datetime="Wed, 31 Dec 2008 05:57:33 GMT", ; rel="next memento"; datetime="Wed, 04 Feb 2009 03:11:40 GMT", ; rel="last memento"; datetime="Fri, 07 Mar 2025 18:44:03 GMT" content-security-policy: default-src 'self' 'unsafe-eval' 'unsafe-inline' data: blob: archive.org web.archive.org web-static.archive.org wayback-api.archive.org athena.archive.org analytics.archive.org pragma.archivelab.org wwwb-events.archive.org x-archive-src: 51_7_20081231010949_crawl101-c/51_7_20081231055639_crawl103.arc.gz server-timing: captures_list;dur=0.496082, exclusion.robots;dur=0.020541, exclusion.robots.policy;dur=0.010192, esindex;dur=0.012204, cdx.remote;dur=120.267471, LoadShardBlock;dur=579.070622, PetaboxLoader3.datanode;dur=515.543194, PetaboxLoader3.resolve;dur=650.291413, load_resource;dur=2924.184389 x-app-server: wwwb-app221 x-ts: 200 x-tr: 3701 server-timing: TR;dur=0,Tw;dur=0,Tc;dur=0 x-location: All x-rl: 0 x-na: 0 x-page-cache: MISS server-timing: MISS x-nid: DigitalOcean referrer-policy: no-referrer-when-downgrade permissions-policy: interest-cohort=() content-encoding: gzip

We got nominated! Help us out and vote for GitHub as Best Bootstrapped Startup of 2008. (You can vote once a day.) [ hide ]

Home Pricing and Signup Repositories Guides Blog Login

Home | Edit | New

Guides: The GitHub API

We’re adding an API bit by bit. This page will serve as the documentation.

The basic url template:

https://github.com/api/version/format/username/repository/type/object

• Current version: v1
• Acceptable formats: json, xml, yaml
• Acceptable types: commits, commit

Grabbing all recent commits:

$ curl -i https://github.com/api/v1/xml/caged/gitnub/commits/master | less

Grabbing a single commit:

$ curl -i https://github.com/api/v1/json/defunkt/github-gem/commit/c26d4ce9807ecf57d3f9eefe19ae64e75bcaaa8b | less

Repository search:

$ curl -i https://github.com/api/v1/xml/search/merb | less

You can also grab a user’s info, including a list of his repositories:

$ curl -i https://github.com/api/v1/json/defunkt | less

With JSON requests, you can have the result passed to a callback method of your choice:

$ curl -i https://github.com/api/v1/json/defunkt?callback=myCallbackMethod | less

Projects using API

• GitHub Badge (see also initial blog post)
• Badjo
• YAGHB – Yet another github badge
• textmate gem—Command-line package manager for textmate
• github commit badge – GitHub commit badge, showing the most recent commits of chosen repos
• ‘gadgets’ project and ‘demo generator’ (see also initial blog post)
• GitHub Projects Wordpress Plug-in – Also at the official Wordpress plug-in directory
• github-repos – Tutorial and Example

Additional resources

• Token Authentication
• Making sense of the participation graph data ( explanation of the participation data )

Last edited by johnbender, about 1 month ago

Versions: CurrentVersion 27 by johnbenderVersion 26 by tristandunnVersion 25 by andyatkinsonVersion 24 by tekkubVersion 23 by tekkubVersion 22 by heipeiVersion 21 by zmackVersion 20 by zmackVersion 19 by subtleGradientVersion 18 by defunktVersion 17 by schleyfoxVersion 16 by zmackVersion 15 by drnicVersion 14 by drnicVersion 13 by defunktVersion 12 by defunktVersion 11 by defunktVersion 10 by mojomboVersion 9 by mojomboVersion 8 by mojomboVersion 7 by mojomboVersion 6 by defunktVersion 5 by defunktVersion 4 by defunktVersion 3 by defunktVersion 2 by defunktVersion 1 by defunkt

T-Shirts | Blog | Support | Git Training | Contact | Google Group | Status

GitHub is Logical Awesome | ©2008 | Terms of Service | Privacy Policy

Hosting provided by our
partners at Engine Yard

This feature is coming soon. Sit tight!