{ "openapi": "3.1.0", "info": { "title": "Logos API", "version": "1.0.0", "description": "Every icon a website publishes, scored and served as an image, from just the domain.\n\nCompany logos from any domain, in one call: give it github.com and get back every icon the site publishes — SVG favicons, apple-touch icons, web-app manifest icons, the classic favicon.ico and the Open Graph image — discovered live from the site itself, scored (SVG beats large PNG beats ICO; monochrome Safari mask icons are demoted because they are outlines, not logos) and verified with real fetches before one is declared best. The image endpoint serves that best icon directly with proper content-type and 24-hour edge caching, so you can serve it from your backend or CDN in one call: /v1/logos/github.com/image renders the Octocat. GitHub resolves to its SVG favicon, Stripe and the New York Times to crisp SVGs, Wikipedia to its apple-touch puzzle globe. No third-party logo service and no scraped database that goes stale — each lookup inspects the live site (with SSRF guards limiting targets to public websites) and caches for a day. Built for CRMs, sales tools, dashboards, link previews, directories and fintech apps that need a logo next to every company name. Pairs with our Tech Stack, Companies and URL Metadata APIs.", "contact": { "name": "Data and APIs", "url": "https://dataandapis.com/contact" }, "termsOfService": "https://dataandapis.com/terms-of-service", "license": { "name": "Data and APIs Terms of Service", "url": "https://dataandapis.com/terms-of-service" }, "x-logo": { "url": "https://dataandapis.com/images/logos.webp" } }, "externalDocs": { "description": "Documentation, live tester and pricing", "url": "https://dataandapis.com/apis/logos" }, "servers": [ { "url": "https://api-logos.dataandapis.com" } ], "tags": [ { "name": "Tools", "description": "Logos API belongs to the Tools category of the Data and APIs catalog." } ], "paths": { "/v1/logos/{domain}/image": { "get": { "operationId": "getLogoImage", "summary": "Get Logo Image", "description": "Get Logo Image endpoint of the Logos API. Costs 5 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/logos/get-logo-image" }, "parameters": [ { "name": "domain", "in": "path", "required": true, "schema": { "type": "string" }, "example": "github.com" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "note": "Binary response — the best icon itself, not JSON. Shown here as the headers the endpoint returns.", "status": 200, "headers": { "Content-Type": "image/svg+xml", "Cache-Control": "public, max-age=86400", "X-Logo-Source": "https://github.githubassets.com/favicons/favicon.svg" }, "body": " (959 bytes)" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/logos": { "get": { "operationId": "getLogosByQuery", "summary": "Get Logos By Query", "description": "Get Logos By Query endpoint of the Logos API. Costs 5 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/logos/get-logos-by-query" }, "parameters": [ { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" }, "example": "wikipedia.org" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "domain": "wikipedia.org", "url": "https://www.wikipedia.org/", "best": { "url": "https://www.wikipedia.org/static/apple-touch/wikipedia.png", "source": "apple_touch", "type": "image/png", "sizes": null, "size": null, "bytes": 1313, "verified": true, "score": 78 }, "icons": [ { "url": "https://www.wikipedia.org/static/apple-touch/wikipedia.png", "source": "apple_touch", "type": "image/png", "sizes": null, "size": null, "bytes": 1313, "verified": true, "score": 78 }, { "url": "https://www.wikipedia.org/static/favicon/wikipedia.ico", "source": "link_icon", "type": "image/vnd.microsoft.icon", "sizes": null, "size": null, "bytes": 2734, "verified": true, "score": 30 }, { "url": "https://www.wikipedia.org/favicon.ico", "source": "favicon_ico", "type": "image/vnd.microsoft.icon", "sizes": null, "size": null, "bytes": 2734, "verified": true, "score": 20 } ], "social_image": "https://upload.wikimedia.org/wikipedia/en/thumb/8/80/Wikipedia-logo-v2.svg/250px-Wikipedia-logo-v2.svg.png", "fetched_at": "2026-09-14T20:52:59.491Z" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } }, "/v1/logos/{domain}": { "get": { "operationId": "getLogosForDomain", "summary": "Get Logos For Domain", "description": "Get Logos For Domain endpoint of the Logos API. Costs 5 tokens per call.", "externalDocs": { "url": "https://dataandapis.com/apis/logos/get-logos-for-domain" }, "parameters": [ { "name": "domain", "in": "path", "required": true, "schema": { "type": "string" }, "example": "github.com" } ], "responses": { "200": { "description": "Successful response", "content": { "application/json": { "schema": { "type": "object" }, "example": { "ok": true, "domain": "github.com", "url": "https://github.com/", "best": { "url": "https://github.githubassets.com/favicons/favicon.svg", "source": "link_icon", "type": "image/svg+xml", "sizes": null, "size": null, "bytes": 959, "verified": true, "score": 88 }, "icons": [ { "url": "https://github.githubassets.com/favicons/favicon.svg", "source": "link_icon", "type": "image/svg+xml", "sizes": null, "size": null, "bytes": 959, "verified": true, "score": 88 }, { "url": "https://github.githubassets.com/assets/app-icon-512-7f9c4ff2e960.png", "source": "manifest", "type": "image/png", "sizes": "512x512", "size": 512, "bytes": 9825, "verified": true, "score": 86 }, { "url": "https://github.githubassets.com/assets/app-icon-192-bcc967ab9829.png", "source": "manifest", "type": "image/png", "sizes": "192x192", "size": 192, "bytes": 3015, "verified": true, "score": 80.1 }, { "url": "https://github.githubassets.com/assets/apple-touch-icon-180x180-a80b8e11abe2.png", "source": "manifest", "type": "image/png", "sizes": "180x180", "size": 180, "bytes": 21128, "verified": true, "score": 80 } ], "social_image": "https://images.ctfassets.net/8aevphvgewt8/4pe4eOtUJ0ARpZRE4fNekf/f52b1f9c52f059a33170229883731ed0/GH-Homepage-Universe-img.png", "fetched_at": "2026-09-14T20:52:58.327Z" } } } }, "401": { "description": "Missing or invalid API key" }, "402": { "description": "Subscription past due; the response carries a payment_url" }, "429": { "description": "Monthly token allowance exhausted" } }, "security": [ { "ApiKey": [] } ] } } }, "components": { "securitySchemes": { "ApiKey": { "type": "apiKey", "in": "header", "name": "X-Api-Key", "description": "Create a free key at https://dataandapis.com/sign-up. 500 tokens a month on the Free plan; this API costs 5 tokens per call." } } }, "security": [ { "ApiKey": [] } ] }