{"openapi":"3.1.0","info":{"title":"Devicons API","version":"1.0.0","summary":"Free, read-only JSON API for developer icons and SVG logos.","description":"Search 1,300+ developer, brand, framework, and tooling logos, read icon metadata and SVG URLs, and browse categories. No key required. SVG files are MIT licensed; logos are trademarks of their owners.","license":{"name":"MIT","identifier":"MIT"}},"externalDocs":{"description":"API documentation","url":"https://devicons.io/docs/api/"},"servers":[{"url":"https://devicons.io/api/v1"}],"paths":{"/icons.json":{"get":{"operationId":"listIcons","summary":"List all active icons","responses":{"200":{"description":"All active icons, sorted by name","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IconList"}}}}}}},"/icons/{slug}.json":{"get":{"operationId":"getIcon","summary":"Get one icon with variants and component names","parameters":[{"name":"slug","in":"path","required":true,"description":"Icon slug","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._-]*$"},"example":"react"}],"responses":{"200":{"description":"Icon detail","content":{"application/json":{"schema":{"$ref":"#/components/schemas/IconDetail"}}}},"404":{"description":"Unknown slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/categories.json":{"get":{"operationId":"listCategories","summary":"List icon categories","responses":{"200":{"description":"Categories, largest first","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Category"}}}}}}}},"/categories/{slug}.json":{"get":{"operationId":"getCategory","summary":"Get the icons in one category","parameters":[{"name":"slug","in":"path","required":true,"description":"Category slug","schema":{"type":"string","pattern":"^[a-z0-9][a-z0-9._-]*$"},"example":"database"}],"responses":{"200":{"description":"Category with its icons, most recognizable first","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CategoryDetail"}}}},"404":{"description":"Unknown slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}},"/search":{"get":{"operationId":"searchIcons","summary":"Search icons by name, alias, tag, or description","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":1,"maxLength":100},"example":"react"},{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},{"name":"category","in":"query","description":"Only return icons in this category slug","schema":{"type":"string"}}],"responses":{"200":{"description":"Ranked results","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiError"}}}}}}}},"components":{"schemas":{"IconSummary":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"popular":{"type":"boolean"},"url":{"type":"string"},"svg":{"type":"string"}},"required":["slug","name","tags","popular","url","svg"],"additionalProperties":false},"IconDetail":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"popular":{"type":"boolean"},"url":{"type":"string"},"svg":{"type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"aliases":{"type":"array","items":{"type":"string"}},"website":{"anyOf":[{"type":"string"},{"type":"null"}]},"license":{"anyOf":[{"type":"string"},{"type":"null"}]},"brandGuidelines":{"anyOf":[{"type":"string"},{"type":"null"}]},"mainColor":{"anyOf":[{"type":"string"},{"type":"null"}]},"badInDark":{"type":"boolean"},"badInLight":{"type":"boolean"},"deprecated":{"type":"boolean"},"recommended":{"type":"boolean"},"variants":{"type":"array","items":{"type":"object","properties":{"file":{"type":"string"},"label":{"type":"string"},"svg":{"type":"string"},"mono":{"type":"string"}},"required":["file","label","svg","mono"],"additionalProperties":false}},"components":{"type":"object","properties":{"react":{"type":"object","properties":{"package":{"type":"string"},"mono":{"type":"string"},"name":{"type":"string"}},"required":["package","mono","name"],"additionalProperties":false},"vue":{"type":"object","properties":{"package":{"type":"string"},"mono":{"type":"string"},"name":{"type":"string"}},"required":["package","mono","name"],"additionalProperties":false},"svelte":{"type":"object","properties":{"package":{"type":"string"},"mono":{"type":"string"},"name":{"type":"string"}},"required":["package","mono","name"],"additionalProperties":false}},"required":["react","vue","svelte"],"additionalProperties":false}},"required":["slug","name","tags","popular","url","svg","description","aliases","website","license","brandGuidelines","mainColor","badInDark","badInLight","deprecated","recommended","variants","components"],"additionalProperties":false},"IconList":{"type":"object","properties":{"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"icons":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"popular":{"type":"boolean"},"url":{"type":"string"},"svg":{"type":"string"}},"required":["slug","name","tags","popular","url","svg"],"additionalProperties":false}}},"required":["count","icons"],"additionalProperties":false},"Category":{"type":"object","properties":{"slug":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"url":{"type":"string"}},"required":["slug","label","count","url"],"additionalProperties":false},"CategoryDetail":{"type":"object","properties":{"slug":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"url":{"type":"string"},"icons":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"popular":{"type":"boolean"},"url":{"type":"string"},"svg":{"type":"string"}},"required":["slug","name","tags","popular","url","svg"],"additionalProperties":false}}},"required":["slug","label","count","url","icons"],"additionalProperties":false},"SearchResult":{"type":"object","properties":{"query":{"type":"string"},"count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"results":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}},"popular":{"type":"boolean"},"url":{"type":"string"},"svg":{"type":"string"}},"required":["slug","name","tags","popular","url","svg"],"additionalProperties":false}}},"required":["query","count","total","results"],"additionalProperties":false},"ApiError":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","enum":["not_found","invalid_param","method_not_allowed","rate_limited","internal"]},"message":{"type":"string"}},"required":["code","message"],"additionalProperties":false}},"required":["error"],"additionalProperties":false}}}}