{"openapi":"3.1.0","info":{"title":"LoadLogo API","description":"Logo API for developers. Fetch logos, brand profiles, stock tickers, and crypto tokens via simple URLs. Two servers: img.loadlogo.com returns images, api.loadlogo.com returns JSON data.","version":"1.0.0","contact":{"url":"https://loadlogo.com"}},"servers":[{"url":"https://img.loadlogo.com","description":"Image CDN — returns image binaries"},{"url":"https://api.loadlogo.com","description":"API — returns JSON data"}],"components":{"schemas":{"TickerResult":{"type":"object","properties":{"symbol":{"type":"string"},"name":{"type":"string"},"domain":{"type":"string"},"exchange":{"type":"string"},"logo":{"type":"string"},"error":{"type":"string"}},"required":["symbol","name"]},"CryptoResult":{"type":"object","properties":{"symbol":{"type":"string"},"name":{"type":"string"},"chain":{"type":"string"},"logo":{"type":"string"},"error":{"type":"string"}},"required":["symbol","name"]},"EnsResult":{"type":"object","properties":{"name":{"type":"string"},"address":{"type":["string","null"]},"avatar":{"type":["string","null"]},"avatarImg":{"type":"string"},"description":{"type":["string","null"]},"socials":{"type":"object","properties":{"github":{"type":["string","null"]},"twitter":{"type":["string","null"]},"url":{"type":["string","null"]},"email":{"type":["string","null"]}},"required":["github","twitter","url","email"]},"records":{"type":"object","additionalProperties":{"type":"string"}},"contentHash":{"type":["string","null"]},"error":{"type":"string"}},"required":["name","address","avatar","avatarImg","description","socials","records","contentHash"]},"GitHubResult":{"type":"object","properties":{"username":{"type":"string"},"avatar":{"type":["string","null"]},"avatarImg":{"type":"string"},"name":{"type":["string","null"]},"bio":{"type":["string","null"]},"company":{"type":["string","null"]},"blog":{"type":["string","null"]},"location":{"type":["string","null"]},"repos":{"type":"integer"},"followers":{"type":"integer"},"following":{"type":"integer"},"type":{"type":"string"},"error":{"type":"string"}},"required":["username","avatar","avatarImg","name","bio","company","blog","location","repos","followers","following","type"]},"BlockchainResult":{"type":"object","properties":{"chainId":{"type":"integer"},"name":{"type":"string"},"shortName":{"type":["string","null"]},"icon":{"type":["string","null"]},"iconUrl":{"type":["string","null"]},"iconImg":{"type":"string"},"nativeCurrency":{"type":["object","null"],"properties":{"name":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"number"}},"required":["name","symbol","decimals"]},"explorers":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}},"required":["name","url"]}},"rpc":{"type":"array","items":{"type":"string"}},"testnet":{"type":"boolean"},"error":{"type":"string"}},"required":["chainId","name","shortName","iconImg","nativeCurrency","explorers","rpc","testnet"]},"SearchResult":{"type":"object","properties":{"name":{"type":"string"},"domain":{"type":"string"},"logo":{"type":"string"}},"required":["name","domain"]},"BrandProfile":{"type":"object","properties":{"name":{"type":"string"},"domain":{"type":"string"},"description":{"type":"string"},"logo":{"type":"string"},"favicon":{"type":"string"},"blurhash":{"type":"string"},"colors":{"type":"array","items":{"type":"object","properties":{"hex":{"type":"string"},"r":{"type":"number"},"g":{"type":"number"},"b":{"type":"number"},"name":{"type":"string"}},"required":["hex"]}},"socials":{"type":"object","additionalProperties":{"type":"string"}},"fonts":{"type":"array","items":{"type":"string"}},"indexed_at":{"type":"string"},"error":{"type":"string"}},"required":["name","domain","description","logo","colors","socials"]}},"parameters":{}},"paths":{"/{domain}":{"get":{"summary":"Logo by domain","description":"Fetch a logo by domain name. Returns the highest quality logo available. Server: img.loadlogo.com","operationId":"getLogoByDomain","parameters":[{"schema":{"type":"string","example":"spotify.com"},"required":true,"name":"domain","in":"path"},{"schema":{"type":"integer","minimum":1,"maximum":2000,"default":128,"description":"Image size in pixels (1-2000). Maps to width."},"required":false,"description":"Image size in pixels (1-2000). Maps to width.","name":"size","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":2000,"description":"Explicit width in pixels (1-2000). Overrides size."},"required":false,"description":"Explicit width in pixels (1-2000). Overrides size.","name":"width","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":2000,"description":"Explicit height in pixels (1-2000)"},"required":false,"description":"Explicit height in pixels (1-2000)","name":"height","in":"query"},{"schema":{"type":"string","enum":["scale-down","contain","cover","crop","pad"],"default":"scale-down","description":"Resize mode: scale-down, contain, cover, crop, pad"},"required":false,"description":"Resize mode: scale-down, contain, cover, crop, pad","name":"fit","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":100,"default":85,"description":"Compression quality (1-100)"},"required":false,"description":"Compression quality (1-100)","name":"quality","in":"query"},{"schema":{"type":"string","enum":["png","jpg","webp","avif","svg"],"default":"png","description":"Output format: png, jpg, webp, avif, or svg"},"required":false,"description":"Output format: png, jpg, webp, avif, or svg","name":"format","in":"query"},{"schema":{"type":"integer","minimum":0,"maximum":250,"default":0,"description":"Gaussian blur radius (0-250)"},"required":false,"description":"Gaussian blur radius (0-250)","name":"blur","in":"query"},{"schema":{"type":"integer","minimum":0,"maximum":10,"default":0,"description":"Sharpen strength (0-10)"},"required":false,"description":"Sharpen strength (0-10)","name":"sharpen","in":"query"},{"schema":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Brightness multiplier (0-2)"},"required":false,"description":"Brightness multiplier (0-2)","name":"brightness","in":"query"},{"schema":{"type":"number","minimum":0,"maximum":2,"default":1,"description":"Contrast multiplier (0-2)"},"required":false,"description":"Contrast multiplier (0-2)","name":"contrast","in":"query"},{"schema":{"type":"string","enum":["0","90","180","270"],"default":"0","description":"Rotation angle: 0, 90, 180, or 270"},"required":false,"description":"Rotation angle: 0, 90, 180, or 270","name":"rotate","in":"query"},{"schema":{"type":"string","description":"Background CSS color (used with fit=pad)"},"required":false,"description":"Background CSS color (used with fit=pad)","name":"background","in":"query"},{"schema":{"type":"integer","minimum":1,"maximum":3,"default":1,"description":"Device pixel ratio (1-3)"},"required":false,"description":"Device pixel ratio (1-3)","name":"dpr","in":"query"},{"schema":{"type":"boolean","default":false,"description":"Convert logo to greyscale"},"required":false,"description":"Convert logo to greyscale","name":"greyscale","in":"query"},{"schema":{"type":"string","enum":["flat","pixel-art","monochrome","glossy","dot-grid","vectorize"],"description":"AI style variant: flat, pixel-art, monochrome, glossy, dot-grid, vectorize. Background is automatically removed for AI-generated styles."},"required":false,"description":"AI style variant: flat, pixel-art, monochrome, glossy, dot-grid, vectorize. Background is automatically removed for AI-generated styles.","name":"style","in":"query"},{"schema":{"type":"string","enum":["404","monogram","boring","boring-beam","boring-marble","boring-pixel","boring-sunset","boring-ring","boring-bauhaus","boring-geometric","boring-abstract"],"default":"monogram","description":"Fallback behavior: monogram, 404, or Boring Avatars variants like boring / boring-marble"},"required":false,"description":"Fallback behavior: monogram, 404, or Boring Avatars variants like boring / boring-marble","name":"fallback","in":"query"},{"schema":{"type":"string","enum":["light","dark"],"default":"light","description":"Color theme for SVG output: light (black fills) or dark (white fills). Useful for monochrome logos on dark backgrounds."},"required":false,"description":"Color theme for SVG output: light (black fills) or dark (white fills). Useful for monochrome logos on dark backgrounds.","name":"theme","in":"query"},{"schema":{"type":"boolean","description":"Set Content-Disposition to attachment for download"},"required":false,"description":"Set Content-Disposition to attachment for download","name":"download","in":"query"}],"responses":{"200":{"description":"Image binary","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Logo not found (fallback=404)"},"429":{"description":"Rate limited"}},"servers":[{"url":"https://img.loadlogo.com"}]}},"/name/{name}":{"get":{"summary":"Logo by company name","description":"AI resolves company name to domain and returns the logo. Server: img.loadlogo.com","operationId":"getLogoByName","parameters":[{"schema":{"type":"string","example":"spotify"},"required":true,"name":"name","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size in pixels"},"required":false,"description":"Image size in pixels","name":"size","in":"query"},{"schema":{"type":"string","enum":["404","monogram","boring","boring-beam","boring-marble","boring-pixel","boring-sunset","boring-ring","boring-bauhaus","boring-geometric","boring-abstract"],"description":"Fallback behavior"},"required":false,"description":"Fallback behavior","name":"fallback","in":"query"}],"responses":{"200":{"description":"Image binary","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}}},"servers":[{"url":"https://img.loadlogo.com"}]}},"/crypto/{chainId}/{address}":{"get":{"summary":"On-chain token logo","description":"Token logo by chain ID and contract address. All EVM chains. Server: img.loadlogo.com","operationId":"getOnChainTokenLogo","parameters":[{"schema":{"type":"integer","example":8453},"required":true,"name":"chainId","in":"path"},{"schema":{"type":"string","example":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"},"required":true,"name":"address","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size in pixels"},"required":false,"description":"Image size in pixels","name":"size","in":"query"}],"responses":{"200":{"description":"Image binary","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}}},"servers":[{"url":"https://img.loadlogo.com"}]}},"/blockchain/{idOrName}":{"get":{"summary":"Blockchain chain logo","description":"Chain logo by chain ID or name. Server: img.loadlogo.com","operationId":"getBlockchainLogo","parameters":[{"schema":{"type":"string","example":"8453"},"required":true,"name":"idOrName","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size in pixels"},"required":false,"description":"Image size in pixels","name":"size","in":"query"}],"responses":{"200":{"description":"Image binary","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}}},"servers":[{"url":"https://img.loadlogo.com"}]}},"/gravatar/{email}":{"get":{"summary":"Gravatar avatar","description":"Gravatar avatar by email (MD5 hashed). Server: img.loadlogo.com","operationId":"getGravatarAvatar","parameters":[{"schema":{"type":"string","example":"user@example.com"},"required":true,"name":"email","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size in pixels"},"required":false,"description":"Image size in pixels","name":"size","in":"query"}],"responses":{"200":{"description":"Image binary","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}}},"servers":[{"url":"https://img.loadlogo.com"}]}},"/wallet/{address}":{"get":{"summary":"Wallet avatar","description":"Wallet avatar via ENS reverse lookup, monogram fallback. Server: img.loadlogo.com","operationId":"getWalletAvatar","parameters":[{"schema":{"type":"string","example":"0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"},"required":true,"name":"address","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size in pixels"},"required":false,"description":"Image size in pixels","name":"size","in":"query"}],"responses":{"200":{"description":"Image binary","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}}},"servers":[{"url":"https://img.loadlogo.com"}]}},"/flag/{code}":{"get":{"summary":"Country flag","description":"Country flag by ISO 3166-1 alpha-2 code. SVG default. Server: img.loadlogo.com","operationId":"getFlag","parameters":[{"schema":{"type":"string","example":"us","description":"ISO 3166-1 alpha-2 code"},"required":true,"description":"ISO 3166-1 alpha-2 code","name":"code","in":"path"},{"schema":{"type":"string","enum":["svg","png"],"default":"svg","description":"Output format"},"required":false,"description":"Output format","name":"format","in":"query"}],"responses":{"200":{"description":"Image binary","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}}},"servers":[{"url":"https://img.loadlogo.com"}]}},"/favicon/{domain}":{"get":{"summary":"Website favicon","description":"Favicon by domain. Tries apple-touch-icon, hi-res, then Google fallback. Server: img.loadlogo.com","operationId":"getFavicon","parameters":[{"schema":{"type":"string","example":"spotify.com"},"required":true,"name":"domain","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size in pixels"},"required":false,"description":"Image size in pixels","name":"size","in":"query"}],"responses":{"200":{"description":"Image binary","content":{"image/*":{"schema":{"type":"string","format":"binary"}}}}},"servers":[{"url":"https://img.loadlogo.com"}]}},"/ticker/{symbol}":{"get":{"summary":"Stock ticker logo or metadata","description":"On img.loadlogo.com: returns ticker logo image. On api.loadlogo.com: returns ticker metadata JSON.","operationId":"getTicker","parameters":[{"schema":{"type":"string","example":"AAPL"},"required":true,"name":"symbol","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size (img server only)"},"required":false,"description":"Image size (img server only)","name":"size","in":"query"},{"schema":{"type":"string","enum":["png","jpg","webp"],"description":"Output format (img server only)"},"required":false,"description":"Output format (img server only)","name":"format","in":"query"}],"responses":{"200":{"description":"Ticker logo image (img) or metadata JSON (api)","content":{"image/*":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/TickerResult"},"example":{"symbol":"AAPL","name":"Apple Inc.","domain":"apple.com","exchange":"NASDAQ","logo":"https://img.loadlogo.com/apple.com"}}}}}}},"/crypto/{symbol}":{"get":{"summary":"Crypto token logo or metadata","description":"On img.loadlogo.com: returns crypto logo image. On api.loadlogo.com: returns token metadata JSON.","operationId":"getCrypto","parameters":[{"schema":{"type":"string","example":"btc"},"required":true,"name":"symbol","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size (img server only)"},"required":false,"description":"Image size (img server only)","name":"size","in":"query"},{"schema":{"type":"string","enum":["png","jpg","webp"],"description":"Output format (img server only)"},"required":false,"description":"Output format (img server only)","name":"format","in":"query"}],"responses":{"200":{"description":"Crypto logo image (img) or metadata JSON (api)","content":{"image/*":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/CryptoResult"},"example":{"symbol":"BTC","name":"Bitcoin","logo":"https://img.loadlogo.com/crypto/btc"}}}}}}},"/ens/{name}":{"get":{"summary":"ENS avatar or profile","description":"On img.loadlogo.com: returns ENS avatar image. On api.loadlogo.com: returns ENS profile JSON.","operationId":"getEns","parameters":[{"schema":{"type":"string","example":"vitalik.eth"},"required":true,"name":"name","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size (img server only)"},"required":false,"description":"Image size (img server only)","name":"size","in":"query"}],"responses":{"200":{"description":"ENS avatar image (img) or profile JSON (api)","content":{"image/*":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/EnsResult"}}}}}}},"/github/{username}":{"get":{"summary":"GitHub avatar or profile","description":"On img.loadlogo.com: returns GitHub avatar image. On api.loadlogo.com: returns GitHub profile JSON.","operationId":"getGithub","parameters":[{"schema":{"type":"string","example":"octocat"},"required":true,"name":"username","in":"path"},{"schema":{"type":"integer","default":128,"description":"Image size (img server only)"},"required":false,"description":"Image size (img server only)","name":"size","in":"query"}],"responses":{"200":{"description":"GitHub avatar image (img) or profile JSON (api)","content":{"image/*":{"schema":{"type":"string","format":"binary"}},"application/json":{"schema":{"$ref":"#/components/schemas/GitHubResult"}}}}}}},"/blockchain/{id}":{"get":{"summary":"Blockchain metadata","description":"Blockchain metadata: chain ID, name, native currency, explorers. Server: api.loadlogo.com","operationId":"getBlockchainData","parameters":[{"schema":{"type":"integer","example":8453},"required":true,"name":"id","in":"path"}],"responses":{"200":{"description":"Blockchain data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BlockchainResult"}}}}},"servers":[{"url":"https://api.loadlogo.com"}]}},"/search":{"get":{"summary":"Search brands","description":"FTS5 full-text search with AI-powered fallback. Server: api.loadlogo.com","operationId":"searchBrands","parameters":[{"schema":{"type":"string","description":"Search query","example":"spotify"},"required":true,"description":"Search query","name":"q","in":"query"}],"responses":{"200":{"description":"Brand search results","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/SearchResult"}},"example":[{"name":"Spotify","domain":"spotify.com","logo":"https://img.loadlogo.com/spotify.com"}]}}}},"servers":[{"url":"https://api.loadlogo.com"}]}},"/describe/{domain}":{"get":{"summary":"Brand profile","description":"Full brand profile including colors, fonts, social links, and description. Server: api.loadlogo.com","operationId":"describeBrand","parameters":[{"schema":{"type":"string","example":"spotify.com"},"required":true,"name":"domain","in":"path"},{"schema":{"type":"boolean","default":false,"description":"Force re-scrape"},"required":false,"description":"Force re-scrape","name":"fresh","in":"query"}],"responses":{"200":{"description":"Brand profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrandProfile"}}}}},"servers":[{"url":"https://api.loadlogo.com"}]}}},"webhooks":{}}