HTTP API · No API key

PNG icon API for social & messenger brands

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.

Open Icon Picker Guides About Footerico

Quick start

Minimal request: flat logo, brand colors, 64×64 px.

Embed in HTML:

Instagram icon preview

Live preview from the URL above.

AI agent skill

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.

Download skill (.zip)

Install with one command

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.

npx skills add https://footeri.co/skills/footerico-icons.zip

Or install by hand

  • 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.

No query or path parameters.

Examples

https://api.footeri.co/categories

Response

{
  "categories": [
    { "id": "messengers", "label": "Messengers" }
  ]
}
GET/brands Brand catalog

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.

Examples

https://api.footeri.co/brands
https://api.footeri.co/brands?category=messengers

Response

{
  "brands": [
    {
      "id": "telegram",
      "name": "Telegram",
      "category": "messengers",
      "tags": ["tg", "chat", "messenger"],
      "iconUrl": "https://api.footeri.co/icons/telegram.png"
    }
  ]
}
GET/icons/{brandId}.png Render PNG

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)

https://api.footeri.co/icons/instagram.png?shape=circle

White logo on a brand-colored circle

https://api.footeri.co/icons/instagram.png?shape=circle&color=white&bgcolor=brand

Black outline with a black logo

https://api.footeri.co/icons/telegram.png?shape=round&radius=12&color=black&bgcolor=black&border

Logo cut out of a custom-colored square

https://api.footeri.co/icons/x.png?size=128&shape=square&color=transparent&bgcolor=3ef941

Retina PNG for a 32 px slot

https://api.footeri.co/icons/telegram.png?size=32&shape=circle&retina

HTTP methods

Method Description
GET Return PNG body with headers.
HEAD Same headers as GET without a body.
OPTIONS CORS preflight. Returns 204 with allowed methods.

Other methods receive 405 Method Not Allowed.

Errors

Error responses use text/plain; charset=utf-8.

Status When
400Invalid query parameters
404Unknown brandId or unknown path
405Method not allowed
500Internal error

Example 400 messages

  • 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.

Brand IDs

Use these ids in the path, or fetch GET /brands. Reference this table or the Icon Picker.

ID Name Category