get_icon_detail_by_id
Retrieve detailed metadata for a specific icon using its unique ID, including author, style, thumbnails, and related variants.
Instructions
Get detailed information about a specific icon identified by its unique ID.
Path Parameters:
id (Required): Icon resource ID
Responses:
200 (Success): OK
Content-Type:
application/jsonResponse Properties:
Example:
{
"data": {
"free_svg": true,
"related": {
"visual_concept": [
{
"free_svg": true,
"created": "2023-03-07T23:05:26Z",
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "a woman reads a book in a tablet sits in the luxurious back of the library",
"style": {
"name": "Meticulous Yellow shadow",
"id": 50
},
"id": 52912,
"family": {
"total": 1200,
"name": "Outline",
"id": 1
},
"thumbnails": [
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
},
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
}
],
"slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
},
{
"free_svg": true,
"created": "2023-03-07T23:05:26Z",
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "a woman reads a book in a tablet sits in the luxurious back of the library",
"style": {
"name": "Meticulous Yellow shadow",
"id": 50
},
"id": 52912,
"family": {
"total": 1200,
"name": "Outline",
"id": 1
},
"thumbnails": [
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
},
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
}
],
"slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
}
],
"style": [
{
"free_svg": true,
"created": "2023-03-07T23:05:26Z",
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "a woman reads a book in a tablet sits in the luxurious back of the library",
"style": {
"name": "Meticulous Yellow shadow",
"id": 50
},
"id": 52912,
"family": {
"total": 1200,
"name": "Outline",
"id": 1
},
"thumbnails": [
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
},
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
}
],
"slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
},
{
"free_svg": true,
"created": "2023-03-07T23:05:26Z",
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "a woman reads a book in a tablet sits in the luxurious back of the library",
"style": {
"name": "Meticulous Yellow shadow",
"id": 50
},
"id": 52912,
"family": {
"total": 1200,
"name": "Outline",
"id": 1
},
"thumbnails": [
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
},
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
}
],
"slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
}
],
"variants": [
{
"free_svg": true,
"created": "2023-03-07T23:05:26Z",
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "a woman reads a book in a tablet sits in the luxurious back of the library",
"style": {
"name": "Meticulous Yellow shadow",
"id": 50
},
"id": 52912,
"family": {
"total": 1200,
"name": "Outline",
"id": 1
},
"thumbnails": [
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
},
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
}
],
"slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
},
{
"free_svg": true,
"created": "2023-03-07T23:05:26Z",
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "a woman reads a book in a tablet sits in the luxurious back of the library",
"style": {
"name": "Meticulous Yellow shadow",
"id": 50
},
"id": 52912,
"family": {
"total": 1200,
"name": "Outline",
"id": 1
},
"thumbnails": [
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
},
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
}
],
"slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library"
}
]
},
"created": "2023-03-07T23:05:26Z",
"author": {
"assets": 0,
"name": "John Doe",
"id": 2147483647,
"avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
"slug": "merry-christmas"
},
"name": "a woman reads a book in a tablet sits in the luxurious back of the library",
"style": {
"name": "Meticulous Yellow shadow",
"id": 50
},
"id": 52912,
"family": {
"total": 1200,
"name": "Outline",
"id": 1
},
"thumbnails": [
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
},
{
"width": 512,
"url": "https://v4.cdnpk.net/videvo_files/video/free/video0485/thumbnails/_import_61a866e2519c71.61070863_large.png",
"height": 512
}
],
"slug": "a-woman-reads-a-book-in-a-tablet-sits-in-the-luxurious-back-of-the-library",
"tags": [
{
"name": "Dog",
"slug": "dog"
},
{
"name": "Dog",
"slug": "dog"
}
]
}
}
400: Bad Request - The server could not understand the request due to invalid syntax.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "message"
}
401: Unauthorized - The client must authenticate itself to get the requested response.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "message"
}
404: Not Found - The server can not find the requested resource.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "message"
}
500: Internal Server Error - The server has encountered a situation it doesn't know how to handle.
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "Internal Server Error"
}
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 |
Implementation Reference
- src/application/route_configuration.py:28-35 (registration)Maps all /v1/icon.* API endpoints to MCP tools, enabling the get_icon_detail_by_id tool among others.RouteMap( methods=[ "GET", "POST", ], pattern=r"/v1/icon.*", mcp_type=MCPType.TOOL, ),
- src/application/server_factory.py:84-90 (registration)Generates and registers MCP tools from the Freepik OpenAPI specification for routes mapped as tools, including icon endpoints.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, )
- Loads the OpenAPI specification used to generate tool schemas and handlers.spec_loader = OpenApiSpecLoader(cache_config) openapi_spec = spec_loader.load_spec()
- Creates the HTTP client used by generated OpenAPITools to execute API calls.http_client = HttpClientFactory.create_api_client(api_config)