The GitHub Jobs API

The GitHub Jobs API allows you to search, and view jobs with JSON over HTTP.

To get the JSON representation of any search result or job listing, append .json to the URL you'd use on the HTML GitHub Jobs site.

For example, when searching for Python jobs near New York on the site I am taken to this url:

https://jobs.github.com/positions?description=python&location=new+york

To get the JSON representation of those jobs I just use positions.json:

https://jobs.github.com/positions.json?description=python&location=new+york

Pagination

The API also supports pagination. /positions.json, for example, will only return 50 positions at a time. You can paginate results by adding a page parameter to your queries.

Pagination starts by default at 0.

Examples

• https://jobs.github.com/positions.json?description=ruby&page=1
• https://jobs.github.com/positions.json?page=1&search=code

---

GET /positions.json

Search for jobs by term, location, full time vs part time, or any combination of the three. All parameters are optional.

Parameters

• description — A search term, such as "ruby" or "java". This parameter is aliased to search.
• location — A city name, zip code, or other location search term.
• lat — A specific latitude. If used, you must also send long and must not send location.
• long — A specific longitude. If used, you must also send lat and must not send location.
• full_time — If you want to limit results to full time positions set this parameter to 'true'.

Examples

• https://jobs.github.com/positions.json?description=python&full_time=true&location=sf
• https://jobs.github.com/positions.json?search=node
• https://jobs.github.com/positions.json?lat=37.3229978&long=-122.0321823

---

GET /positions/ID.json

Retrieve the JSON representation of a single job posting.

Parameters

• markdown — Set to 'true' to get the description and how_to_apply fields as Markdown.

Examples

• https://jobs.github.com/positions/21516.json
• https://jobs.github.com/positions/21516.json?markdown=true