Typekit API output formats

This is documentation for Typekit’s original API. This API is still supported, but we encourage you to try the newer Typekit Platform API.

All Typekit API data is available in JSON, XML and YAML formats. The JSON format is optionally available wrapped in a callback.

You can request a particular format using the :format url parameter. For example, we can request the library list in XML format:

$ curl -s https://typekit.com/api/v1/xml/libraries
    <name>Trial Library</name>
    <name>Personal Library</name>
    <name>Full Library</name>

JSON with callbacks

The JSON format is optionally available wrapped in a javascript callback function (also known as "JSONP")

To specify a callback, use the callback parameter.

This option is intended to be used by Javascript running in a browser and behaves differently to other output formats:

For example, we can get a list of font families using jQuery:

$.getJSON("http://typekit.com/api/v1/json/libraries/full?callback=?", function(data){
  alert('There are ' + data.library.pagination.count + ' font families in the full Typekit library');

A more detailed example of using the Typekit API from Javascript is available from GitHub.

Structure of output

We won't remove properties from or otherwise change the structure of the API's output without introducing a new API version, but we may add properties to various endpoints in the future, and the order of properties is never predetermined. Therefore, when parsing API output you should never depend on a specific order of properties, and you should always be prepared to encounter unexpected properties.