For developers
Brand logos, straight into your project
Find a brand in your editor or terminal. Insert a link or markup, or download SVG and PNG files without hunting across websites.
npx trace-logos search telegram
01 / npm
From your terminal to assets
A CLI for quick tasks and a library for your scripts. One package: trace-logos.
- Search English and Russian names, even with the wrong keyboard layout.
- Download SVG and PNG, or return JSON for scripts and pipes.
- A current, cached catalog. Node.js 18.17+, ESM, CommonJS and TypeScript types.
npm i trace-logos
npx trace-logos search telegram1. Telegram (telegram) Мессенджеры и соцсети [svg png] 2. Walt (walt) Платежи и карты [svg] 3. Т-Бизнес Секреты (tbusinesssecrets) Музыка и медиа [svg png]
Download an SVG or get JSON
npx trace-logos get telegram --svg --out ./assets
npx trace-logos search telegram --jsonCLI flags and a library example
A slug is only unique within its category: alfa, google and monopoly each appear in more than one. When that happens the CLI lists the candidates and you add the category, as in bank/alfa.
--offline uses the cache only, --refresh re-checks the catalog right away. get never overwrites an existing file unless you pass --force.
Library
import { TraceLogos } from 'trace-logos';
const tl = new TraceLogos();
await tl.load();
const [logo] = tl.search('telegram', { limit: 1 });
console.log(logo.name, tl.pageUrl(logo));ESM and CommonJS, TypeScript types included. Methods: load, search, assetsOf, fetchAsset, pageUrl.
02 / VS Code
Find a logo without leaving your editor
Open Trace Logos: Search, find a brand and choose how to add it to your project.
- Preview on light, dark and checkerboard backgrounds.
- Ready-made
<img>, JSX, Markdown and CSSurl(). - Save SVG and PNG files to your project, choose variants or open the brand page.
ext install trace-logos.trace-logos
Paste the line into Quick Open (Ctrl+P, or Cmd+P on a Mac), or search for Trace Logos in the Extensions view.
<img src="https://trace-logos.ru/assets/logos/svgs/telegram.svg" alt="Telegram">
03 / JSON API
The whole catalog in one request
A static logos.json for your website, server or build. No API key or sign-up.
- Open CORS: read it straight from the browser.
- Direct links to SVG, PNG and the brand page.
- Names, tags, categories, ecosystems and logo variants.
https://trace-logos.ru/logos.json
{
"name": "Telegram",
"svgUrl": "https://trace-logos.ru/assets/logos/svgs/telegram.svg",
"url": "https://trace-logos.ru/logos/social/telegram/"
}Search in JavaScript
const res = await fetch(
'https://trace-logos.ru/logos.json'
);
const { logos } = await res.json();
const logo = logos.find(
({ name }) => name === 'Telegram'
);
console.log(logo.svgUrl, logo.url);Some logos have no SVG: check svgUrl and pngUrl. Filter out placeholders with comingSoon: true.
License and attribution
Code: MIT. Logos: trademarks of their owners. Check brand guidelines before publishing. Use the ready-made badge to link back to the catalog.
FAQ
Do I need an API key?
trace-logos package, for example, caches the catalog for 10 minutes and revalidates it with an ETag.How do new logos reach the package and the extension?
Why does trace-logos get alfa fail?
alfa belongs to both a bank and an insurance company. The CLI lists both and you pick one: bank/alfa or insurance/alfa.