search_icons

Search for icons by term, slug, or filters like color, shape, and type. Define order, page, and results per page to retrieve relevant icon data in JSON format.

Instructions

Get a list of icons based on the provided parameters and ordering criteria.

Query Parameters:

term: Search term. If only term comes, it is searched for term, if only slug comes, it is searched for slug and if both come, it is searched for slug
slug: Search by slug
page: Page number. It must be greater than 0.
per_page: Results per page. It must be greater than 0.
family-id: Icon family id.
order: Define order of results.
Note: If the term or slug parameter is used, the order will be the similarity of the search.
filters[color]: Filter by color.
filters[shape]: Filter by shape.
filters[period]: Filter by period.
filters[free_svg]: Filter by free svg, for free or premium item or all for both
filters[icon_type][]: Filter of available icon types.
thumbnail_size: Size of the thumbnail. If the size is not specified, the API will return 128 as a default size.

Responses:

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

{
  "data": [
    {
      "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",
      "tags": [
        {
          "name": "Dog",
          "slug": "dog"
        },
        {
          "name": "Dog",
          "slug": "dog"
        }
      ]
    },
    {
      "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",
      "tags": [
        {
          "name": "Dog",
          "slug": "dog"
        },
        {
          "name": "Dog",
          "slug": "dog"
        }
      ]
    }
  ],
  "meta": {
    "pagination": {
      "per_page": 1,
      "total": 1,
      "last_page": 1,
      "current_page": 1
    }
  }
}

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"
}

404: Not Found - The server can not find the requested resource.
- 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"
}

Input 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.
`family-id`	No	Icon family id.
`filters[color]`	No	Filter by color.
`filters[free_svg]`	No	Filter by free svg, for free or premium item or all for both
`filters[icon_type][]`	No	Filter of available icon types.
`filters[period]`	No	Filter by period.
`filters[shape]`	No	Filter by shape.
`order`	No	Define order of results. - Note: If the term or slug parameter is used, the order will be the similarity of the search.	relevance
`page`	No	Page number. It must be greater than 0.
`per_page`	No	Results per page. It must be greater than 0.
`slug`	No	Search by slug
`term`	No	Search term. If only term comes, it is searched for term, if only slug comes, it is searched for slug and if both come, it is searched for slug
`thumbnail_size`	No	Size of the thumbnail. If the size is not specified, the API will return 128 as a default size.

Input Schema (JSON Schema)

{
  "properties": {
    "Accept-Language": {
      "description": "Specifies the search query language using the ISO 639-1 (2-letter\nlanguage code) and the ISO 3166-1 (2-letter country code) for language variants.\nThe API will use \"en-US\" as a default language for processing if a code is not\nprovided, or does not exist.\n",
      "type": "string"
    },
    "family-id": {
      "description": "Icon family id.",
      "minimum": 1,
      "type": "integer"
    },
    "filters[color]": {
      "description": "Filter by color.",
      "enum": [
        "gradient",
        "solid-black",
        "multicolor",
        "azure",
        "black",
        "blue",
        "chartreuse",
        "cyan",
        "gray",
        "green",
        "orange",
        "red",
        "rose",
        "spring-green",
        "violet",
        "white",
        "yellow"
      ],
      "example": "red",
      "type": "string"
    },
    "filters[free_svg]": {
      "description": "Filter by free svg, for free or premium item or all for both",
      "enum": [
        "all",
        "free",
        "premium"
      ],
      "type": "string"
    },
    "filters[icon_type][]": {
      "description": "Filter of available icon types.",
      "items": {
        "enum": [
          "standard",
          "animated",
          "sticker",
          "uicon"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "filters[period]": {
      "description": "Filter by period.",
      "enum": [
        "three-months",
        "six-months",
        "one-year",
        "all"
      ],
      "type": "string"
    },
    "filters[shape]": {
      "description": "Filter by shape.",
      "enum": [
        "outline",
        "fill",
        "lineal-color",
        "hand-drawn"
      ],
      "type": "string"
    },
    "order": {
      "default": "relevance",
      "description": "Define order of results.\n- Note: If the term or slug parameter is used, the order will be the similarity of the search.\n",
      "enum": [
        "relevance",
        "recent"
      ],
      "type": "string"
    },
    "page": {
      "description": "Page number. It must be greater than 0.",
      "type": "integer"
    },
    "per_page": {
      "description": "Results per page. It must be greater than 0.",
      "type": "integer"
    },
    "slug": {
      "description": "Search by slug",
      "type": "string"
    },
    "term": {
      "description": "Search term. If only term comes, it is searched for term, if only slug comes, it is searched for slug and if both come, it is searched for slug",
      "type": "string"
    },
    "thumbnail_size": {
      "description": "Size of the thumbnail. \nIf the size is not specified, the API will return 128 as a default size.\n",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Freepik FastMCP Toolkit

search_icons

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Freepik FastMCP Toolkit

Related Tools

MCP directory API