API Documentation

Access our icon database programmatically with our simple REST API

Authentication

Currently, our API is open and does not require authentication.

We may introduce rate limiting and API keys in the future. Subscribe to our newsletter to stay updated.

Base URL

https://theicons.space/api

Get All Icons

GET

/icons

Get all icons or filter by query parameters

Parameter	Type	Description
q	string	Search query to filter icons by name or tags
category	string	Filter icons by category

Get Icon by Slug

GET

/icons/{slug}

Get a specific icon by Slug

Parameter	Type	Description
slug	string	The unique identifier of the icon

{
    "name": "React",
    "slug": "react",
    "hex": "61DAFB",
    "svgFilePath": "/icons/react.svg",
    "pngFilePath": "/icons/react.png",
    "category": "frontend"
}

Get All Categories

GET

/categories

Get a list of all predefined icon categories

Response	Type	Description
categories	string[]	Array of predefined category names like "frontend", "backend", etc.

[
    "frontend",
    "backend",
    "database",
    "devops",
    "design",
    "tools"
]