download_icon_by_id

Download icons from Freepik by their unique ID in various formats and sizes for integration into projects.

Download the specified icon by its unique ID in the requested format and size.

Path Parameters:

Query Parameters:

format: These are the formats available for download
Note: gif, mp4, aep, json, psd and eps are not available for standard and sticker icon types.
png_size: These are the sizes available for png_url formats.
Note: Only apply to format png.

Responses:

200 (Success): OK
- Content-Type: application/json
- Response Properties:
- Example:

{ "data": { "filename": "filename", "url": "https://openapi-generator.tech" } }

400: Bad Request - The server could not understand the request due to invalid syntax.
- Content-Type: application/json
- Response Properties:
- Example:

{ "message": "message" }

401: Unauthorized - The client must authenticate itself to get the requested response.
- Content-Type: application/json
- Response Properties:
- Example:

{ "message": "message" }

403: Forbidden - The client does not have permission to access the requested resource.
- Content-Type: application/json
- Response Properties:
- Example:

{ "message": "message" }

404: Not Found - The server can not find the requested resource.
- Content-Type: application/json
- Response Properties:
- Example:

{ "message": "message" }

429: Too Many Requests - The client has sent too many requests in a given amount of time.
- Content-Type: application/json
- Response Properties:
- Example:

{ "message": "message" }

500: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
- Content-Type: application/json
- Response Properties:
- Example:

{ "message": "Internal Server Error" }

TableJSON Schema

Name	Required	Description
`Accept-Language`	No	Specifies the search query language using the ISO 639-1 (2-letter language code) and the ISO 3166-1 (2-letter country code) for language variants. The API will use "en-US" as a default language for processing if a code is not provided, or does not exist.
`id`	Yes	Icon resource ID
`format`	No	These are the formats available for download - Note: gif, mp4, aep, json, psd and eps are not available for standard and sticker icon types.
`png_size`	No	These are the sizes available for png_url formats. - Note: Only apply to format png.

src/application/route_configuration.py:28-35 (registration)
Registers all GET/POST endpoints matching /v1/icon.* as MCP tools. This exposes the Icons API, including the download_icon_by_id tool generated from the OpenAPI specification.
RouteMap( methods=[ "GET", "POST", ], pattern=r"/v1/icon.*", mcp_type=MCPType.TOOL, ),
src/application/server_factory.py:84-90 (registration)
Instantiates the FastMCP server from the loaded OpenAPI spec and route maps, automatically generating and registering tools (including download_icon_by_id) that proxy requests to the Freepik API via the configured HTTP client.
server = FastMCP.from_openapi( openapi_spec=openapi_spec, client=http_client, name=server_config.name, route_maps=route_maps, mcp_component_fn=mcp_component_fn, )
src/application/server_factory.py:77-79 (helper)
Loads the OpenAPI specification used to generate tool schemas and handlers for the Icons API endpoints.
spec_loader = OpenApiSpecLoader(cache_config) openapi_spec = spec_loader.load_spec()

Freepik FastMCP Toolkit