API: List Fonts - Fonts.com Web Fonts

Description

This is the API which you use to browse our library of web fonts. Without optional filters you will get all fonts in the library, limited only by the starting font and number of fonts requested. The optional filters enable you to narrow the results. URLs of the fonts. subsetted to include the sample string, are provided so that you can display the font in its own typeface. We optionally include the @font-face rule for each font.

URL

http://api.fonts.com/rest/{format}/AllFonts/

{format}

xml or json

Method

GET

Required Header Parameters

authorization
Hashed authorization key
appkey
Your application’s key

Required Query String Parameters

None

Optional Query String Parameters

wfsClassId
Filter results by this classification ID
wfsDesignerId
Filter results by this designer ID
wfsFountryId
Filter results by this foundry ID
wfsLangId
Filter results by this language ID
wfsAlphabet
Filter results by fonts starting with this letter (‘a’ or ‘b’…or ‘z’)
wfsfree
Filter results by fonts which are free only (when set to 'true')
wfsKeyword
Keyword to be searched by
wfsFamilyGrouping
Group results by family (when set to 'true')
wfsCSS
Provide the @font-face rule for each font (when set to 1)
wfspstart
starting record requested (zero-based)
wfsplimit
# of records requested

Response variables

Message
If the response is successful then the “message” parameter of the response will be “Success” and if there is some error or failure then the “message” parameter will be the error message.
Font: FontID
Identifier of the font - Every font in the Fonts.com Web Fonts service has a unique FontID.
Font: FontName
Display name of the font
Font: FontPreviewTextLong
The long text string you can use to show a sample of the font
Font: FontFoundryName
The name of font foundry
Font: DesignFoundryID (if Family Grouping enabled)
The ID of the design foundry
Font: SourceFoundryID (if Family Grouping enabled)
The id of the source foundry
Font: FontCSSName
The font-family name of the font
Font: PsNames(if Family Grouping enabled)
The Postscript name of the font
Font: FontLanguage
The language supported by the font
Font: FontSize
The size of the font file
Font: FontTier
Indicates if the font is available with free or paid plans
- 0: the font is "free" (available with all plans)
- 1: the font is "paid" (available with Standard and Professional plans)
- NULL (no value): the font is private to the user
Font: IsDownloadable
- 0: the font is not downloadable
- 1: The font is downloadable in applications so enabled
Font: TTFURL(if Family Grouping NOT enabled)
The font’s TrueType® font file URL - TrueType fonts can be used in all major browsers except for the Microsoft Internet Explorer® browser.
Font: EOTURL (if Family Grouping NOT enabled)
The font’s Embedded OpenType Font file URL - EOT fonts are served exclusively to Internet Explorer browsers.
Font: SVGURL (if Family Grouping NOT enabled)
The font’s Scalable Vector Graphics font files URL - This format is compatible with Apple iPhone, iPad and iPod touch devices.
Font: WOFFURL (if Family Grouping NOT enabled)
The font’s Web Open Font Format file URL - It is compatible with Firefox 3.6 and up. The WOFF file format is expected to eventually be compatible with all major browsers.
Font: EnableSubsetting
Indicates that a font should be dynamically subsetted in the website. Fonts with very large characters sets such as fonts support Chinese, Japanese and Korean writing systems can also have very large file sizes. Because it may take a long time to download a large file, fonts supporting these languages will be marked as EnableSubsetted fonts. The value will be either T for true or F for False.
Font: Designer
The name of the font designer
Font: DesignerIDs (if Family Grouping enabled)
The ID of the font designer
Font: Classification
The font's classification name
Font: ClassificationIDs (if Family Grouping enabled)
The ID of the classification
Font: OtherLangaugeSupportOptions (if Family Grouping enabled)
More Font elements will be presented if this font has multiple versions, each supporting a different language set
TotalRecords (if Family Grouping NOT enabled)
Total number of records
TotalGroupRecords (if Family Grouping enabled)
Total number of group records
TotalFontRecords (if Family Grouping enabled)
Total number of font records
FontFace (if wfsCSS is set to 1)
The @font-face rules for all of the fonts returned
PageStart
starting record requested (zero-based)
PageLimit
# of records requested

XML Response

<AllFonts>
  <FontFamily>
    <FontFamilyID>752115</FontFamilyID>
    <FontFamilyName>Ashley Crawford</FontFamilyName>
    <DisplayFontID>691852</DisplayFontID>
    <Font>
      <FontID>691852</FontID>
      <FontName>Ashley Crawford Light</FontName>
      <FontPreviewTextLong>Quick Brown Fox Jumped Over The Lazy Dog</FontPreviewTextLong>
      <FontFoundryName>Monotype Imaging</FontFoundryName>
      <DesignFoundryID>185289</DesignFoundryID>
      <SourceFoundryID>523654</SourceFoundryID>
      <FontCSSName>AshleyCrawfordW01-Light</FontCSSName>
      <PsNames>AshleyCrawfordW01-Light</PsNames>
      <FontLanguage>Latin 1</FontLanguage>
      <FontSize>23328-124970</FontSize>
      <FontTier>0</FontTier>
      <IsDownloadable>1</IsDownloadable>
      <EnableSubsetting>false</EnableSubsetting>
      <Designer>Ashley Havinden</Designer>
      <DesignerIDs>524689</DesignerIDs>
      <Classification></Classification>
      <ClassificationIDs></ClassificationIDs>
      <OtherLanguageSupportOptions />
    </Font>
    <Font>
      <FontID>691849</FontID>
      <FontName>Ashley Crawford Bold</FontName>
      <FontPreviewTextLong>Quick Brown Fox Jumped Over The Lazy Dog</FontPreviewTextLong>
      <FontFoundryName>Monotype Imaging</FontFoundryName>
      <DesignFoundryID>185289</DesignFoundryID>
      <SourceFoundryID>523654</SourceFoundryID>
      <FontCSSName>AshleyCrawfordW01-Bold</FontCSSName>
      <PsNames>AshleyCrawfordW01-Bold</PsNames>
      <FontLanguage>Latin 1</FontLanguage>
      <FontSize>22312-113420</FontSize>
      <FontTier>0</FontTier>
      <IsDownloadable>1</IsDownloadable>
      <EnableSubsetting>false</EnableSubsetting>
      <Designer>Ashley Havinden</Designer>
      <DesignerIDs>524689</DesignerIDs>
      <Classification></Classification>
      <ClassificationIDs></ClassificationIDs>
      <OtherLanguageSupportOptions />
    </Font>
    <Font>
      <FontID>691855</FontID>
      <FontName>Ashley Crawford Regular</FontName>
      <FontPreviewTextLong>Quick Brown Fox Jumped Over The Lazy Dog</FontPreviewTextLong>
      <FontFoundryName>Monotype Imaging</FontFoundryName>
      <DesignFoundryID>185289</DesignFoundryID>
      <SourceFoundryID>523654</SourceFoundryID>
      <FontCSSName>Ashley Crawford W01</FontCSSName>
      <PsNames>AshleyCrawfordW01</PsNames>
      <FontLanguage>Latin 1</FontLanguage>
      <FontSize>30744-169545</FontSize>
      <FontTier>0</FontTier>
      <IsDownloadable>1</IsDownloadable>
      <EnableSubsetting>false</EnableSubsetting>
      <Designer>Ashley Havinden</Designer>
      <DesignerIDs>524689</DesignerIDs>
      <Classification></Classification>
      <ClassificationIDs></ClassificationIDs>
      <OtherLanguageSupportOptions />
    </Font>
  </FontFamily>
  <FontFace><![CDATA[@font-face{font-family:"AshleyCrawfordW01-Light";src:url("http://api3.fonts.com/FontSampler.ashx?fctypeId=2&origId=13db203a-e865-4a3e-a961-56160ea634c6&fcId=a77a70ce-efd9-4f18-b859-42dcf7b8fc67&fontformat=W01&v=9") format("eot");}@font-face{font-family:"AshleyCrawfordW01-Light";src:url("http://api3.fonts.com/FontSampler.ashx?fctypeId=2&origId=13db203a-e865-4a3e-a961-56160ea634c6&fcId=a77a70ce-efd9-4f18-b859-42dcf7b8fc67&fontformat=W01&v=9");src:url("http://api3.fonts.com/FontSampler.ashx?fctypeId=3&origId=859c310f-e40c-469a-a39c-1fcd942ae399&fcId=a77a70ce-efd9-4f18-b859-42dcf7b8fc67&fontformat=W01&v=9") format("woff"),url("http://api3.fonts.com/FontSampler.ashx?fctypeId=1&origId=a77a70ce-efd9-4f18-b859-42dcf7b8fc67&fcId=a77a70ce-efd9-4f18-b859-42dcf7b8fc67&fontformat=W01&v=9") format("truetype"),url("http://api3.fonts.com/FontSampler.ashx?fctypeId=11&origId=bf5f89d0-7c6f-4c07-ad72-005a44e29795&fcId=a77a70ce-efd9-4f18-b859-42dcf7b8fc67&fontformat=W01&v=9") format("svg");}@font-face{font-family:"AshleyCrawfordW01-Bold";src:url("http://api3.fonts.com/FontSampler.ashx?fctypeId=2&origId=a4350f89-7cf5-4525-a746-84046618d8a1&fcId=6190cee0-89ec-460e-926d-0dfad0a01d13&fontformat=W01&v=9") format("eot");}@font-face{font-family:"AshleyCrawfordW01-Bold";src:url("http://api3.fonts.com/FontSampler.ashx?fctypeId=2&origId=a4350f89-7cf5-4525-a746-84046618d8a1&fcId=6190cee0-89ec-460e-926d-0dfad0a01d13&fontformat=W01&v=9");src:url("http://api3.fonts.com/FontSampler.ashx?fctypeId=3&origId=4865c4f9-293a-4635-bcc0-4c86f7705dd2&fcId=6190cee0-89ec-460e-926d-0dfad0a01d13&fontformat=W01&v=9") format("woff"),url("http://api3.fonts.com/FontSampler.ashx?fctypeId=1&origId=6190cee0-89ec-460e-926d-0dfad0a01d13&fcId=6190cee0-89ec-460e-926d-0dfad0a01d13&fontformat=W01&v=9") format("truetype"),url("http://api3.fonts.com/FontSampler.ashx?fctypeId=11&origId=b434d8cc-f74a-4354-a1bf-9e9429009cef&fcId=6190cee0-89ec-460e-926d-0dfad0a01d13&fontformat=W01&v=9") format("svg");}@font-face{font-family:"Ashley Crawford W01";src:url("http://api3.fonts.com/FontSampler.ashx?fctypeId=2&origId=5ffd11cb-a50f-4b39-bbaf-f69af03d6e68&fcId=02f2f11c-7313-4f6a-8aac-6134b91333e2&fontformat=W01&v=8") format("eot");}@font-face{font-family:"Ashley Crawford W01";src:url("http://api3.fonts.com/FontSampler.ashx?fctypeId=2&origId=5ffd11cb-a50f-4b39-bbaf-f69af03d6e68&fcId=02f2f11c-7313-4f6a-8aac-6134b91333e2&fontformat=W01&v=8");src:url("http://api3.fonts.com/FontSampler.ashx?fctypeId=3&origId=4849b8a5-0db3-4120-9f6c-f6ec910d771c&fcId=02f2f11c-7313-4f6a-8aac-6134b91333e2&fontformat=W01&v=8") format("woff"),url("http://api3.fonts.com/FontSampler.ashx?fctypeId=1&origId=02f2f11c-7313-4f6a-8aac-6134b91333e2&fcId=02f2f11c-7313-4f6a-8aac-6134b91333e2&fontformat=W01&v=8") format("truetype"),url("http://api3.fonts.com/FontSampler.ashx?fctypeId=11&origId=e8fcc82b-a6a1-4f6f-aec6-5505c7bde902&fcId=02f2f11c-7313-4f6a-8aac-6134b91333e2&fontformat=W01&v=8") format("svg");}]]></FontFace>
  <Message>Success</Message>
  <TotalGroupRecords>1</TotalGroupRecords>
  <TotalFontRecords>3</TotalFontRecords>
  <PageStart>0</PageStart>
  <PageLimit>10</PageLimit>
</AllFonts>

json Response

{
   "AllFonts":{
      "Font":[
         {
            "Classification":"Sans Serif,Technical",
            "Designer":"Linotype Design Studio",
            "EnableSubsetting":"false",
            "EOTURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=2&origId=f81026f1-d541-41a9-affc-ca2a013871f4&fcId=417fbaeb-4c38-4327-a855-6b4865fcd555&fontformat=W01&v=4",
            "FontCSSName":"Helvetica W01 Blk",
            "FontFoundryName":"Linotype",
            "FontID":"709857",
            "FontLanguage":"Latin 1",
            "FontName":"Helveticar Black",
            "FontPreviewTextLong":"Quick Brown Fox Jumped Over The Lazy Dog",
            "FontSize":"36232",
            "FontTier":"0",
            "SVGURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=11&origId=422289e3-fe15-4e5a-b159-45888740f8dc&fcId=417fbaeb-4c38-4327-a855-6b4865fcd555&fontformat=W01&v=4",
            "TTFURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=1&origId=417fbaeb-4c38-4327-a855-6b4865fcd555&fcId=417fbaeb-4c38-4327-a855-6b4865fcd555&fontformat=W01&v=4",
            "WOFFURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=3&origId=712aac8d-557b-4a5d-bb6a-40ac69765042&fcId=417fbaeb-4c38-4327-a855-6b4865fcd555&fontformat=W01&v=4"
         },
         {
            "Classification":"Sans Serif,Technical",
            "Designer":"Linotype Design Studio",
            "EnableSubsetting":"false",
            "EOTURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=2&origId=3607e1fa-3c64-4517-8996-d732d0c14a05&fcId=1119736b-8e3a-4efc-a90c-c0d13e27081e&fontformat=W02&v=3",
            "FontCSSName":"Helvetica W02 Blk",
            "FontFoundryName":"Linotype",
            "FontID":"739479",
            "FontLanguage":"Latin Ext 1",
            "FontName":"Helveticar Black",
            "FontPreviewTextLong":"The quick brown fox jumps \/ Prílis zlutoucky",
            "FontSize":"56596",
            "FontTier":"0",
            "SVGURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=11&origId=b5dc5e4c-b76e-490f-9699-87852910524d&fcId=1119736b-8e3a-4efc-a90c-c0d13e27081e&fontformat=W02&v=3",
            "TTFURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=1&origId=1119736b-8e3a-4efc-a90c-c0d13e27081e&fcId=1119736b-8e3a-4efc-a90c-c0d13e27081e&fontformat=W02&v=3",
            "WOFFURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=3&origId=aa71f04c-c694-4c1b-b841-c7ca7fff868e&fcId=1119736b-8e3a-4efc-a90c-c0d13e27081e&fontformat=W02&v=3"
         },
         {
            "Classification":"Sans Serif,Technical",
            "Designer":"Linotype Design Studio",
            "EnableSubsetting":"false",
            "EOTURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=2&origId=71382082-494e-41bb-abc8-e8a0fcb2374a&fcId=7dc7721f-3e3f-4be1-9eab-74cced36e438&fontformat=W01&v=4",
            "FontCSSName":"Helvetica W01 Blk Obl",
            "FontFoundryName":"Linotype",
            "FontID":"709866",
            "FontLanguage":"Latin 1",
            "FontName":"Helveticar Black Oblique",
            "FontPreviewTextLong":"Quick Brown Fox Jumped Over The Lazy Dog",
            "FontSize":"36500",
            "FontTier":"0",
            "SVGURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=11&origId=d5ab6fd7-be42-4e89-91a2-fd53fe2a7155&fcId=7dc7721f-3e3f-4be1-9eab-74cced36e438&fontformat=W01&v=4",
            "TTFURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=1&origId=7dc7721f-3e3f-4be1-9eab-74cced36e438&fcId=7dc7721f-3e3f-4be1-9eab-74cced36e438&fontformat=W01&v=4",
            "WOFFURL":"http:\/\/api3.fonts.com\/FontSampler.ashx?fctypeId=3&origId=e80cc55d-63d4-47e3-90e1-8b9a4e5e97b8&fcId=7dc7721f-3e3f-4be1-9eab-74cced36e438&fontformat=W01&v=4"
         }
      ],
      "Message":"Success",
      "PageLimit":"3",
      "PageStart":"0",
      "TotalRecords":"305"
   }
}

@font-face exmaple

Make sure after "EOTURL" their is a "#" symbol. Place this code in your CSS file.

      @font-face
      {
        font-family: "[font name]";
        src: url("[your EOTURL url]#") format("eot");
      }
      @font-face
      {
        font-family: "[font name]";
        src: url("[your EOTURL url]#");
        src: url("[your WOFFURL url]") format("woff"),
             url("[your TTFURL url]") format("truetype"),
             url("[your SVGURL url]") format("svg");
      }

fonts.com

Fonts: List Fonts

Description

URL

{format}

Method

Required Header Parameters

Required Query String Parameters

Optional Query String Parameters

Response variables

XML Response

json Response

@font-face exmaple

Integration Support

Account

Domains

Filters

Filter Values

Fonts

Projects

Publish

Selectors

Stylesheet