{"openapi":"3.1.0","info":{"title":"Fonts API","version":"1.0.0","description":"The Google Fonts catalogue as an API — 1,900+ open-source font families with everything you need to pick and embed a typeface. Look up a family (e.g. Roboto → category, available weights, variable-font axes, subsets and a ready-to-use CSS embed URL); search by name, category (Sans Serif, Serif, Display, Handwriting, Monospace), subset, weight or variable-font support; or list the most popular families. Each record carries the weights/styles, variable axes (wght, wdth, …), language subsets, designers, popularity rank and a Google Fonts CSS2 embed URL. Ideal for design tools, website builders, font pickers and theming systems.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/fonts-api","description":"oanor gateway"}],"tags":[{"name":"Fonts"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/font":{"get":{"operationId":"get_v1_font","tags":["Fonts"],"summary":"A single font family (weights, axes, subsets, CSS url)","description":"","parameters":[{"name":"family","in":"query","required":true,"description":"Font family name, e.g. Roboto","schema":{"type":"string"},"example":"Roboto"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"axes":[{"max":100,"min":75,"tag":"wdth","default":100},{"max":900,"min":100,"tag":"wght","default":400}],"family":"Roboto","italic":true,"stroke":"Sans Serif","css_url":"https://fonts.googleapis.com/css2?family=Roboto:wght@100;200;300;400;500;600;700;800;900&display=swap","subsets":["menu","cyrillic","cyrillic-ext","greek","greek-ext","latin","latin-ext","math","symbols","vietnamese"],"weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","trending":1033,"variable":true,"designers":["Christian Robertson","ParaType","Font Bureau"],"date_added":"2013-01-08","popularity":2,"open_source":true,"last_modified":"2026-02-19","classifications":[]},"meta":{"timestamp":"2026-05-31T04:30:17.060Z","request_id":"205e11c4-975e-45bc-9c99-3163d1c9eaa5"},"status":"ok","message":"Font retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/popular":{"get":{"operationId":"get_v1_popular","tags":["Fonts"],"summary":"Most popular families","description":"","parameters":[{"name":"category","in":"query","required":false,"description":"Restrict to a category","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 25)","schema":{"type":"string"},"example":"25"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":25,"results":[{"family":"Roboto","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Roboto:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":true,"popularity":2},{"family":"Open Sans","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Open+Sans:wght@300;400;500;600;700;800&display=swap","weights":[300,400,500,600,700,800],"category":"Sans Serif","variable":true,"popularity":3},{"family":"Google Sans","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Google+Sans:wght@400;500;600;700&display=swap","weights":[400,500,600,700],"category":"Sans Serif","variable":true,"popularity":4},{"family":"Inter","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Inter:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":true,"popularity":5},{"family":"Montserrat","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Montserrat:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":true,"popularity":6},{"family":"Poppins","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Poppins:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":false,"popularity":8},{"family":"Noto Sans JP","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Noto+Sans+JP:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":true,"popularity":9},{"family":"Lato","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Lato:wght@100;300;400;700;900&display=swap","weights":[100,300,400,700,900],"category":"Sans Serif","variable":false,"popularity":10},{"family":"Arimo","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Arimo:wght@400;500;600;700&display=swap","weights":[400,500,600,700],"category":"Sans Serif","variable":true,"popularity":12},{"family":"Roboto Condensed","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Roboto+Condensed:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":true,"popularity":14},{"family":"Roboto Mono","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Roboto+Mono:wght@100;200;300;400;500;600;700&display=swap","weights":[100,200,300,400,500,600,700],"category":"Monospace","variable":true,"popularity":16},{"family":"Oswald","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Oswald:wght@200;300;400;500;600;700&display=swap","weights":[200,300,400,500,600,700],"category":"Sans Serif","variable":true,"popularity":18},{"family":"Noto Sans","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Noto+Sans:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":true,"popularity":19},{"family":"Raleway","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Raleway:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":true,"popularity":22},{"family":"Nunito","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Nunito:wght@200;300;400;500;600;700;800;900;1000&display=swap","weights":[200,300,400,500,600,700,800,900,1000],"category":"Sans Serif","variable":true,"popularity":23},{"family":"DM Sans","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=DM+Sans:wght@100;200;300;400;500;600;700;800;900;1000&display=swap","weights":[100,200,300,400,500,600,700,800,900,1000],"category":"Sans Serif","variable":true,"popularity":24},{"family":"Playfair Display","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Playfair+Display:wght@400;500;600;700;800;900&display=swap","weights":[400,500,600,700,800,900],"category":"Serif","variable":true,"popularity":25},{"family":"Nunito Sans","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Nunito+Sans:wght@200;300;400;500;600;700;800;900;1000&display=swap","weights":[200,300,400,500,600,700,800,900,1000],"category":"Sans Serif","variable":true,"popularity":26},{"family":"Rubik","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Rubik:wght@300;400;500;600;700;800;900&display=swap","weights":[300,400,500,600,700,800,900],"category":"Sans Serif","variable":true,"popularity":27},{"family":"Archivo Black","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Archivo+Black:wght@400&display=swap","weights":[400],"category":"Sans Serif","variable":false,"popularity":28},{"family":"Roboto Slab","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Roboto+Slab:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Serif","variable":true,"popularity":29},{"family":"Noto Sans KR","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":true,"popularity":30},{"family":"Ubuntu","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Ubuntu:wght@300;400;500;700&display=swap","weights":[300,400,500,700],"category":"Sans Serif","variable":false,"popularity":33},{"family":"Merriweather","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Merriweather:wght@300;400;500;600;700;800;900&display=swap","weights":[300,400,500,600,700,800,900],"category":"Serif","variable":true,"popularity":34},{"family":"Kanit","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Kanit:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Sans Serif","variable":false,"popularity":35}]},"meta":{"timestamp":"2026-05-31T04:30:17.135Z","request_id":"44c7d8e3-51db-4a31-a75e-6ae33a0ba10c"},"status":"ok","message":"Popular fonts listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Fonts"],"summary":"Search by name with category / subset / weight / variable filters","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name / designer search, e.g. mono","schema":{"type":"string"}},{"name":"category","in":"query","required":false,"description":"Sans Serif | Serif | Display | Handwriting | Monospace","schema":{"type":"string"},"example":"Serif"},{"name":"subset","in":"query","required":false,"description":"Language subset, e.g. latin, cyrillic, greek","schema":{"type":"string"}},{"name":"weight","in":"query","required":false,"description":"Only families offering this weight, e.g. 700","schema":{"type":"string"}},{"name":"variable","in":"query","required":false,"description":"true = variable fonts only","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Results per page (1-100, default 20)","schema":{"type":"string"},"example":"20"},{"name":"offset","in":"query","required":false,"description":"Pagination offset","schema":{"type":"string"},"example":"0"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"limit":20,"total":348,"offset":0,"filters":{"category":"serif"},"results":[{"family":"Abhaya Libre","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Abhaya+Libre:wght@400;500;600;700;800&display=swap","weights":[400,500,600,700,800],"category":"Serif","variable":false,"popularity":396},{"family":"Abyssinica SIL","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Abyssinica+SIL:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":1068},{"family":"Adamina","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Adamina:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":511},{"family":"Alegreya","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Alegreya:wght@400;500;600;700;800;900&display=swap","weights":[400,500,600,700,800,900],"category":"Serif","variable":true,"popularity":271},{"family":"Alegreya SC","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Alegreya+SC:wght@400;500;700;800;900&display=swap","weights":[400,500,700,800,900],"category":"Serif","variable":false,"popularity":716},{"family":"Aleo","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Aleo:wght@100;200;300;400;500;600;700;800;900&display=swap","weights":[100,200,300,400,500,600,700,800,900],"category":"Serif","variable":true,"popularity":298},{"family":"Alice","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Alice:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":386},{"family":"Alike","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Alike:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":871},{"family":"Alike Angular","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Alike+Angular:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":1058},{"family":"Alkalami","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Alkalami:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":1272},{"family":"Almendra","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Almendra:wght@400;700&display=swap","weights":[400,700],"category":"Serif","variable":false,"popularity":731},{"family":"Almendra SC","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Almendra+SC:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":1402},{"family":"Alyamama","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Alyamama:wght@300;400;500;600;700;800;900&display=swap","weights":[300,400,500,600,700,800,900],"category":"Serif","variable":true,"popularity":1851},{"family":"Amethysta","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Amethysta:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":954},{"family":"Amiri","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Amiri:wght@400;700&display=swap","weights":[400,700],"category":"Serif","variable":false,"popularity":220},{"family":"Amiri Quran","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Amiri+Quran:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":1423},{"family":"Ancizar Serif","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Ancizar+Serif:wght@300;400;500;600;700;800;900&display=swap","weights":[300,400,500,600,700,800,900],"category":"Serif","variable":true,"popularity":1547},{"family":"Andada Pro","italic":true,"css_url":"https://fonts.googleapis.com/css2?family=Andada+Pro:wght@400;500;600;700;800&display=swap","weights":[400,500,600,700,800],"category":"Serif","variable":true,"popularity":431},{"family":"Annapurna SIL","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Annapurna+SIL:wght@400;700&display=swap","weights":[400,700],"category":"Serif","variable":false,"popularity":1758},{"family":"Antic Didone","italic":false,"css_url":"https://fonts.googleapis.com/css2?family=Antic+Didone:wght@400&display=swap","weights":[400],"category":"Serif","variable":false,"popularity":603}]},"meta":{"timestamp":"2026-05-31T04:30:17.213Z","request_id":"b741a033-0abd-4b50-a887-6195b1ef2347"},"status":"ok","message":"Fonts listed","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Totals, categories & subsets","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"popularity/trending are 1-based ranks (1 = most popular). css_url embeds the family via Google Fonts CSS2.","total":1934,"fields":["family","category","stroke","classifications","subsets","weights","italic","variable","axes","designers","popularity","trending","date_added","last_modified","open_source","css_url"],"source":"Google Fonts (official catalogue metadata)","subsets":["adlam","ahom","anatolian-hieroglyphs","arabic","armenian","avestan","balinese","bamum","bassa-vah","batak","bengali","beria-erfe","bhaiksuki","brahmi","braille","buginese","buhid","canadian-aboriginal","carian","caucasian-albanian","chakma","cham","cherokee","chinese-hongkong","chinese-simplified","chinese-traditional","chorasmian","coptic","cuneiform","cypriot","cypro-minoan","cyrillic","cyrillic-ext","deseret","devanagari","dives-akuru","dogra","duployan","egyptian-hieroglyphs","elbasan","elymaic","emoji","ethiopic","georgian","glagolitic","gothic","grantha","greek","greek-ext","gujarati","gunjala-gondi","gurmukhi","hanifi-rohingya","hanunoo","hatran","hebrew","imperial-aramaic","indic-siyaq-numbers","inscriptional-pahlavi","inscriptional-parthian","japanese","javanese","kaithi","kana-extended","kannada","kawi","kayah-li","kharoshthi","khitan-small-script","khmer","khojki","khudawadi","kirat-rai","korean","lao","latin","latin-ext","lepcha","limbu","linear-a","linear-b","lisu","lycian","lydian","mahajani","makasar","malayalam","mandaic","manichaean","marchen","masaram-gondi","math","mayan-numerals","medefaidrin","meetei-mayek","mende-kikakui","menu","meroitic","meroitic-cursive","meroitic-hieroglyphs","miao","modi","mongolian","mro","multani","music","myanmar","nabataean","nag-mundari","nandinagari","new-tai-lue","newa","nko","nushu","nyiakeng-puachue-hmong","ogham","ol-chiki","old-hungarian","old-italic","old-north-arabian","old-permic","old-persian","old-sogdian","old-south-arabian","old-turkic","old-uyghur","oriya","osage","osmanya","ottoman-siyaq-numbers","pahawh-hmong","palmyrene","pau-cin-hau","phags-pa","phoenician","psalter-pahlavi","rejang","runic","samaritan","saurashtra","sharada","shavian","siddham","signwriting","sinhala","sogdian","sora-sompeng","soyombo","sundanese","sunuwar","syloti-nagri","symbols","symbols2","syriac","tagalog","tagbanwa","tai-le","tai-tham","tai-viet","takri","tamil","tamil-supplement","tangsa","tangut","telugu","thaana","thai","tibetan","tifinagh","tirhuta","todhri","toto","ugaritic","vai","vietnamese","vithkuqi","wancho","warang-citi","yezidi","yi","zanabazar-square","znamenny"],"variable":552,"categories":[{"count":715,"category":"Sans Serif"},{"count":465,"category":"Display"},{"count":356,"category":"Handwriting"},{"count":348,"category":"Serif"},{"count":50,"category":"Monospace"}]},"meta":{"timestamp":"2026-05-31T04:30:17.286Z","request_id":"0ebdcfc7-e5a2-4549-a01a-095a425dfaba"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":5000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":500,"monthly_call_quota":60000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1500,"monthly_call_quota":300000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3700,"monthly_call_quota":1500000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/fonts-api"}