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:

http://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

JSONP

The GitHub Jobs API supports JSONP.

Appending ?callback=myFunction to any API request will wrap the response in a function call to myFunction. This is useful when making requests to the GitHub Jobs API using JavaScript.

If you're using jQuery, this means you should use jQuery.getJSON or set dataType to 'jsonp' when using jQuery.ajax.

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

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

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