simpleicons.org 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.
curl -X GET 'https://api.parse.bot/scraper/8a707b6b-908a-45d3-9de6-601de84af58e/search_icons?limit=3&query=google' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for brand/technology icons by keyword. Searches across icon titles, slugs, and known aliases (aka, old names, localized names). Returns matching icons with their brand color, SVG URL, and metadata.
| 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": 3,
"icons": [
{
"slug": "chromecast",
"title": "Chromecast",
"source": "https://www.google.com/intl/en_us/chromecast/built-in/",
"aliases": {
"aka": [
"Google Cast"
]
},
"svg_url": "https://cdn.jsdelivr.net/npm/simple-icons@latest/icons/chromecast.svg",
"hex_color": "#999999"
},
{
"slug": "google",
"title": "Google",
"source": "https://partnermarketinghub.withgoogle.com",
"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 simpleicons.org 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.
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.
- 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 | 250 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.