Simple Icons APIsimpleicons.org ↗
Access 3,300+ brand and technology icons via API. Get official hex colors, SVG URLs, slugs, and license info. Search, look up, or paginate the full collection.
What is the Simple Icons API?
The Simple Icons API exposes over 3,300 brand and technology icons across 3 endpoints, returning each icon's official hex brand color, SVG logo URL, and slug identifier. Use search_icons to find icons by keyword against titles, slugs, and known aliases, get_icon to retrieve a single icon by name or slug, or list_icons to paginate the full alphabetically ordered collection.
curl -X GET 'https://api.parse.bot/scraper/8a707b6b-908a-45d3-9de6-601de84af58e/search_icons?limit=5&query=google' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace simpleicons-org-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
from parse_apis.simple_icons_api import SimpleIcons, Icon, IconNotFound
client = SimpleIcons()
# Search for React-related icons
for icon in client.icons.search(query="react"):
print(icon.title, icon.hex_color, icon.svg_url)
# Get a specific icon by slug
github = client.icons.get(name="github")
print(github.title, github.hex_color, github.source)
# List all icons alphabetically
for icon in client.icons.list(offset=0, limit=10):
print(icon.title, icon.slug, icon.hex_color)
Full-text search across icon titles, slugs, and aliases (aka, old names, localized names). Returns matching icons ordered by title match quality. Paginates as a single page capped by limit.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of results to return |
| queryrequired | string | Search keyword (e.g., 'google', 'react', 'amazon') |
{
"type": "object",
"fields": {
"count": "integer - number of matching icons returned",
"icons": "array of Icon objects with title, slug, hex_color, svg_url, source, and optional aliases/guidelines/license fields",
"query": "string - the search query used"
},
"sample": {
"data": {
"count": 5,
"icons": [
{
"slug": "google",
"title": "Google",
"source": "https://partnermarketinghub.withgoogle.com",
"aliases": {
"loc": {
"ko-KR": "구글"
}
},
"svg_url": "https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/google.svg",
"hex_color": "#4285F4",
"guidelines": "https://about.google/brand-resource-center/brand-elements/"
}
],
"query": "google"
},
"status": "success"
}
}About the Simple Icons API
What the API Returns
Every icon object includes a title (the official brand name), a slug (URL-safe identifier used to reference the icon), a hex_color (the brand's official hex color with # prefix), and an svg_url pointing to the icon's SVG file. Most icons also include a source URL pointing to the original logo asset. Optional fields — aliases, guidelines, and license — are present only where the upstream dataset carries them.
Endpoint Details
search_icons accepts a required query string and an optional limit integer. It searches across icon titles, slugs, and all alias types (aka, old, loc, dup), making it useful for finding icons by common short names, legacy brand names, or localized variants. The response includes a count of results alongside the icons array and echoes back the query used.
get_icon accepts either the display title (e.g., GitHub, C++) or the slug (e.g., github, cplusplus) as the name parameter. It returns the full icon object including optional guidelines (a URL to the brand's usage policy) and structured license info with a type field when available.
Pagination and Coverage
list_icons supports limit and offset parameters for pagination and returns total (the full database size), count (icons in the current page), and the icons array. Icons are ordered alphabetically by title. The total field lets you calculate page counts and build offset-based pagination without needing a separate metadata call.
The Simple Icons API is a managed, monitored endpoint for simpleicons.org — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when simpleicons.org changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official simpleicons.org API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Populate a tech stack selector with matching SVG logos and brand hex colors using
search_icons - Auto-apply correct brand colors in a design tool by looking up
hex_colorviaget_icon - Build a searchable icon picker component backed by the full 3,300+ collection via
list_icons - Validate brand color usage in generated assets by comparing against the
hex_colorfield - Link to brand guidelines in a style guide by surfacing the
guidelinesURL fromget_icon - Display license information before redistributing a logo by checking the
license.typefield - Resolve legacy or alternate brand names to canonical slugs using alias search in
search_icons
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Simple Icons provide an official developer API?+
What does the `aliases` field in a response actually contain?+
aliases object can contain up to four sub-fields: aka (common alternate names), old (former brand names), loc (localized names in other languages), and dup (duplicate entries pointing to the canonical icon). Not every icon has all sub-fields — the object is omitted entirely when no aliases are recorded for that icon.Can I retrieve icons filtered by license type or by brand category?+
license.type as a metadata field on each icon, but none of the endpoints accept license type or brand category as a filter parameter. You can fork this API on Parse and revise it to add a filter endpoint that matches against license.type or groups icons by category.Does the API return the raw SVG markup, or just a URL?+
svg_url string pointing to the SVG file rather than the inline SVG markup. The get_icon and search_icons endpoints do not include the SVG source code in the response payload itself. You can fork the API on Parse and revise it to fetch and embed the SVG content if inline markup is required.How fresh is the icon data — does it reflect recent brand additions to Simple Icons?+
total field in list_icons responses is a reliable indicator of the current database size.