Need Instagram, Telegram, or X in a footer or newsletter? Request a PNG with one GET.
Size, shape, and color live in the query string: drop the URL into <img>, a CMS field, or email HTML.
Open CORS. No signup. Icons update at the source so you do not redeploy a folder of files.
A URL you embed keeps working: new options arrive as new parameters, and existing ones never change meaning.
Ask your AI agent for icons in plain words and get working links back. The Footerico skill teaches Claude, and other agents that support Agent Skills, how to build icon URLs and <img> code. With web access, the agent reads the live brand list from GET /brands. Without it, the agent uses the copy of the catalog bundled in the skill.
Installs the skill into the coding agents found on your computer, such as Claude Code, Cursor, or Codex. Needs Node.js 22.20 or later; add -g to install for your user instead of the current project.
Claude app (web or desktop): open Settings, find Skills, and upload the zip. Skills need code execution turned on.
Claude Code: unzip into ~/.claude/skills/, or into .claude/skills/ inside a project.
Other agents: unzip into the folder your agent loads skills from. The skill is a plain SKILL.md with two reference files.
Try asking
Give me Instagram, Telegram and LinkedIn icons for my email footer: white logos on brand-colored circles, 32 px, as HTML.
The bundled brand list is a backup for agents without web access. When a newer version of the skill is out, the agent tells you at the end of its answer: run npx skills update, or download the zip again if you uploaded it to the Claude app.
Endpoints
GET/categories
Categories
Returns the catalog category list (id, label) for building tabs or filters in a third-party UI.
Returns brands for a picker or grid. Each item includes id, name, category, tags, and an absolute iconUrl for the default PNG. Discontinued brands are omitted by default.
Parameter
Type
Description
category
string
Filter by topic. One of social-networks · messengers · files · others. Omit for all categories.
Returns a single styled PNG for a bundled brand. Omit any parameter below to use its default. color paints the logo and bgcolor paints the shape, independently. Links that start with /v1/icons keep working unchanged, see Older /v1 links.
Parameter
Type
Description
brandId
string (path)
Kebab-case brand id (e.g. telegram, instagram). See brand list or GET /brands.
size
integer
Optional. Listed sizes: 16, 32, 64, 128; any integer 16–128 also works. Default 64 (64×64 PNG). With retina, PNG pixels are min(size × 2, 256).
shape
enum
Background shape: circle · round · square. Default: flat logo, no shape (also settable explicitly as none).
color
enum | hex
Logo color: brand (the logo's own colors) · black · gray · white, or a 6-digit hex (e.g. 3ef941; a leading # is accepted too, URL-encoded as %23). transparent cuts the logo out of the shape so the page shows through; it needs a shape and no border. Default brand.
bgcolor
enum | hex
Shape color: brand · black · gray · white, or a 6-digit hex. Fills the shape; with border it colors the outline instead, since an outlined shape has no fill. Requires a shape. Default gray, or brand with border.
radius
integer
Corner radius in px at the current size (1 … floor(size/2)-1). Only when shape=round. Default 10 at size 64, scaled proportionally for other sizes.
scale
integer
Logo size inside the shape, in percent (75 … 120). Requires a shape. Default 100.
border
flag
Draw the shape as an outline in bgcolor instead of a fill. Requires a shape. Use ?border or border=true.
retina
flag
Render a 2× PNG for high-DPI displays. Query size stays logical. Use ?retina or retina=true.
Examples
Flat logo in its own colors
https://api.footeri.co/icons/telegram.png
Gray circle, logo in its own colors (the shape defaults)
category must be one of: social-networks, messengers, files, others
size must be an integer between 16 and 128
shape must be one of: circle, round, square
border requires shape other than none
color must be brand, black, gray, white, transparent, or RRGGBB hex (6 digits, no #)
bgcolor requires shape other than none
bgcolor must be brand, black, gray, white, or RRGGBB hex (6 digits, no #)
color=transparent requires shape other than none
color=transparent is not available with border
radius is only valid when shape=round
scale requires shape other than none
scale must be an integer between 75 and 120
CORS
Every response, including HEAD and error responses, includes Access-Control-Allow-Origin: *,
so icons work from any origin in <img src="…"> or fetch from browser apps.
Caching
PNG responses carry Cache-Control: public, max-age=86400, stale-while-revalidate=604800 and an ETag.
Send that ETag back as If-None-Match to get a bodyless 304 Not Modified instead of re-downloading the PNG.
Catalog JSON (/categories, /brands) carries Cache-Control: public, max-age=300, stale-while-revalidate=86400 and does not set an ETag.
A brand's logo can change behind the same PNG URL: the browser revalidates on the schedule above, so cached copies pick up a rebrand within a day at the outside.
Limitations
Listed size steps: 16, 32, 64, 128; any integer 16–128 also works. Default 64. With retina, the PNG can be up to 256 px.
Catalog JSON: /categories and /brands. PNG: /icons/{brandId}.png. No batch render endpoint.
Output format is PNG only.
Older /v1 links
Links that start with /v1/icons/ keep working, and each keeps returning the same PNG. Icons already sitting in sent emails and signatures will never change. /v1/categories and /v1/brands keep working too; /v1/brands still lists /v1/icons URLs. New integrations should use /icons/.
In a /v1/icons link, color means different things depending on the shape. On a flat logo it colors the logo. On a filled shape it colors the shape and draws the logo white; white and hex shapes cut the logo out instead. With border it colors both the outline and the logo. These links take the same size, shape, radius, border, and retina, and ignore bgcolor.
To switch a link to /icons/, change the path and the colors. Each pair below returns the same PNG:
/v1/icons query
/icons query
color=black
color=black
shape=circle
shape=circle&bgcolor=brand&color=white
shape=circle&color=black
shape=circle&bgcolor=black&color=white
shape=circle&color=white
shape=circle&bgcolor=white&color=transparent
shape=circle&color=3ef941
shape=circle&bgcolor=3ef941&color=transparent
shape=circle&border
shape=circle&border
shape=circle&border&color=black
shape=circle&border&bgcolor=black&color=black
One exception: Google, Gmail, Google Drive, Microsoft Teams, and a few other brands keep their multicolor logo on a brand-colored shape in /v1/icons links, because their brand color is near-white. For those, the /icons match for shape=circle is shape=circle&bgcolor=brand&color=brand.
Brand IDs
Use these ids in the path, or fetch GET /brands. Reference this table or the Icon Picker.