Skip to main content
Glama

Freepik FastMCP Toolkit

4
  • Linux

search_resources

Search and retrieve visual resources with filters for orientation, content type, license, and more. Use query parameters to refine results based on specific criteria.

Instructions

Retrieve a list of resources based on various filter criteria such as orientation, content type, license, and more.

Query Parameters:

  • page: Page number. It must be greater than 0 and less than or equal to 100.
  • limit: Limit results per page. It must be greater than 0.
  • order: Specifies the order in which search results are returned. The available options allow you to prioritize results based on different criteria:
  • relevance: Prioritizes results that are most relevant to the search query.
  • recent: Sorts results by the most recent updates.
  • 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
  • filters[orientation][landscape]: Filters results to only include resources with a landscape orientation. Set to 1 to enable, 0 to disable.
  • filters[orientation][portrait]: Filters results to only include resources with a portrait orientation. Set to 1 to enable, 0 to disable.
  • filters[orientation][square]: Filters results to only include resources with a square orientation. Set to 1 to enable, 0 to disable.
  • filters[orientation][panoramic]: Filters results to only include resources with a panoramic orientation. Set to 1 to enable, 0 to disable.
  • filters[content_type][photo]: Filters results to only include resources of type photo. Set to 1 to enable, 0 to disable.
  • filters[content_type][psd]: Filters results to only include resources of type PSD (Photoshop Document). Set to 1 to enable, 0 to disable.
  • filters[content_type][vector]: Filters results to only include resources of type vector. Set to 1 to enable, 0 to disable.
  • filters[license][freemium]: Filters results to only include resources with a freemium license. Set to 1 to enable, 0 to disable.
  • filters[license][premium]: Filters results to only include resources with a premium license. Set to 1 to enable, 0 to disable.
  • filters[people][include]: Filter by included people
  • filters[people][exclude]: Filter by excluded people
  • filters[people][number]: Filter by number of people
  • filters[people][age]: Filter by age of the people
  • filters[people][gender]: Filter by gender of the people
  • filters[people][ethnicity]: Filter by ethnicity of the people
  • filters[period]: Filters results based on the time period in which the resources were added.
  • filters[color]: Filters results by the predominant color in the resources.
  • filters[author]: Filters results to include resources by a specific author, identified by their author ID.
  • filters[ai-generated][excluded]: Excludes AI-generated images from the results. Set to 1 to exclude, 0 to include.
  • filters[ai-generated][only]: Filters results to only include AI-generated images. Set to 1 to include only AI-generated images, 0 to include all images.
  • filters[vector][type]: File type for vectors
  • filters[vector][style]: Style type for vectors, ignored if content_type exists and it is not vector
  • filters[psd][type]: File type for psd
  • filters[ids]: Filter by list of ids. This filter is incompatible with any other filters. In case of using this filter, the rest of filters will be ignored.

Responses:

  • 200 (Success): Ok Response
    • Content-Type: application/json
    • Response Properties:
      • data: A list of resources.
    • Example:
{ "data": [ { "image": { "orientation": "horizontal", "source": { "size": "740x640", "key": "large", "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg" }, "type": "vector" }, "licenses": [ { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" }, { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" } ], "filename": "filename", "related": { "keywords": { "name": "Merry Christmas", "slug": "merry-christmas" }, "serie": { "image": { "orientation": "horizontal", "source": { "size": "740x640", "key": "large", "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg" }, "type": "vector" }, "licenses": [ { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" }, { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" } ], "author": { "assets": 0, "name": "John Doe", "id": 2147483647, "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg", "slug": "merry-christmas" }, "id": 15667327, "title": "White t-shirt with copy space on gray background", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm" }, "others": { "image": { "orientation": "horizontal", "source": { "size": "740x640", "key": "large", "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg" }, "type": "vector" }, "licenses": [ { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" }, { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" } ], "author": { "assets": 0, "name": "John Doe", "id": 2147483647, "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg", "slug": "merry-christmas" }, "id": 15667327, "title": "White t-shirt with copy space on gray background", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm" } }, "stats": { "downloads": 0, "likes": 0 }, "author": { "assets": 0, "name": "John Doe", "id": 2147483647, "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg", "slug": "merry-christmas" }, "meta": { "is_new": true, "available_formats": { "psd": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "jpg": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "zip": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "fonts": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "svg": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "ai": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "png": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "eps": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "resources": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "3d-render": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "atn": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] } }, "published_at": "2020-12-01T23:50:50Z" }, "id": 15667327, "title": "White t-shirt with copy space on gray background", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm", "products": [ { "type": "essential", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm" }, { "type": "essential", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm" } ] }, { "image": { "orientation": "horizontal", "source": { "size": "740x640", "key": "large", "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg" }, "type": "vector" }, "licenses": [ { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" }, { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" } ], "filename": "filename", "related": { "keywords": { "name": "Merry Christmas", "slug": "merry-christmas" }, "serie": { "image": { "orientation": "horizontal", "source": { "size": "740x640", "key": "large", "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg" }, "type": "vector" }, "licenses": [ { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" }, { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" } ], "author": { "assets": 0, "name": "John Doe", "id": 2147483647, "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg", "slug": "merry-christmas" }, "id": 15667327, "title": "White t-shirt with copy space on gray background", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm" }, "others": { "image": { "orientation": "horizontal", "source": { "size": "740x640", "key": "large", "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg" }, "type": "vector" }, "licenses": [ { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" }, { "type": "freemium", "url": "https://www.freepik.com/profile/license/pdf/4350594" } ], "author": { "assets": 0, "name": "John Doe", "id": 2147483647, "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg", "slug": "merry-christmas" }, "id": 15667327, "title": "White t-shirt with copy space on gray background", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm" } }, "stats": { "downloads": 0, "likes": 0 }, "author": { "assets": 0, "name": "John Doe", "id": 2147483647, "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg", "slug": "merry-christmas" }, "meta": { "is_new": true, "available_formats": { "psd": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "jpg": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "zip": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "fonts": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "svg": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "ai": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "png": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "eps": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "resources": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "3d-render": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] }, "atn": { "total": 1, "items": [ { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 }, { "size": 100, "colorspace": "RGB", "name": "image.jpg", "id": 1 } ] } }, "published_at": "2020-12-01T23:50:50Z" }, "id": 15667327, "title": "White t-shirt with copy space on gray background", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm", "products": [ { "type": "essential", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm" }, { "type": "essential", "url": "https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm" } ] } ], "meta": { "per_page": 1, "total": 1, "last_page": 1, "current_page": 1, "clean_search": true } }
  • 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" }
  • 503: Service Unavailable
    • Content-Type: application/json
    • Response Properties:
    • Example:
{ "message": "Service Unavailable. Please try again later." }

Input Schema

NameRequiredDescriptionDefault
Accept-LanguageNoSpecifies 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.
filters[ai-generated][excluded]NoExcludes AI-generated images from the results. Set to 1 to exclude, 0 to include.
filters[ai-generated][only]NoFilters results to only include AI-generated images. Set to 1 to include only AI-generated images, 0 to include all images.
filters[author]NoFilters results to include resources by a specific author, identified by their author ID.
filters[color]NoFilters results by the predominant color in the resources.
filters[content_type][photo]NoFilters results to only include resources of type photo. Set to 1 to enable, 0 to disable.
filters[content_type][psd]NoFilters results to only include resources of type PSD (Photoshop Document). Set to 1 to enable, 0 to disable.
filters[content_type][vector]NoFilters results to only include resources of type vector. Set to 1 to enable, 0 to disable.
filters[ids]NoFilter by list of ids. This filter is incompatible with any other filters. In case of using this filter, the rest of filters will be ignored.
filters[license][freemium]NoFilters results to only include resources with a freemium license. Set to 1 to enable, 0 to disable.
filters[license][premium]NoFilters results to only include resources with a premium license. Set to 1 to enable, 0 to disable.
filters[orientation][landscape]NoFilters results to only include resources with a landscape orientation. Set to 1 to enable, 0 to disable.
filters[orientation][panoramic]NoFilters results to only include resources with a panoramic orientation. Set to 1 to enable, 0 to disable.
filters[orientation][portrait]NoFilters results to only include resources with a portrait orientation. Set to 1 to enable, 0 to disable.
filters[orientation][square]NoFilters results to only include resources with a square orientation. Set to 1 to enable, 0 to disable.
filters[people][age]NoFilter by age of the people
filters[people][ethnicity]NoFilter by ethnicity of the people
filters[people][exclude]NoFilter by excluded people
filters[people][gender]NoFilter by gender of the people
filters[people][include]NoFilter by included people
filters[people][number]NoFilter by number of people
filters[period]NoFilters results based on the time period in which the resources were added.
filters[psd][type]NoFile type for psd
filters[vector][style]NoStyle type for vectors, ignored if content_type exists and it is not vector
filters[vector][type]NoFile type for vectors
limitNoLimit results per page. It must be greater than 0.
orderNoSpecifies the order in which search results are returned. The available options allow you to prioritize results based on different criteria: - `relevance`: Prioritizes results that are most relevant to the search query. - `recent`: Sorts results by the most recent updates. relevance
pageNoPage number. It must be greater than 0 and less than or equal to 100.
termNoSearch 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

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" }, "filters[ai-generated][excluded]": { "default": 0, "description": "Excludes AI-generated images from the results. Set to 1 to exclude, 0 to include.", "type": "number" }, "filters[ai-generated][only]": { "default": 0, "description": "Filters results to only include AI-generated images. Set to 1 to include only AI-generated images, 0 to include all images.", "type": "number" }, "filters[author]": { "default": 0, "description": "Filters results to include resources by a specific author, identified by their author ID.", "type": "number" }, "filters[color]": { "description": "Filters results by the predominant color in the resources.", "enum": [ "black", "blue", "gray", "green", "orange", "red", "white", "yellow", "purple", "cyan", "pink" ], "type": "string" }, "filters[content_type][photo]": { "default": 0, "description": "Filters results to only include resources of type photo. Set to 1 to enable, 0 to disable.", "type": "number" }, "filters[content_type][psd]": { "default": 0, "description": "Filters results to only include resources of type PSD (Photoshop Document). Set to 1 to enable, 0 to disable.", "type": "number" }, "filters[content_type][vector]": { "default": 0, "description": "Filters results to only include resources of type vector. Set to 1 to enable, 0 to disable.", "type": "number" }, "filters[ids]": { "description": "Filter by list of ids. This filter is incompatible with any other filters. In case of using this filter, the rest of filters will be ignored.", "type": "string" }, "filters[license][freemium]": { "default": 0, "description": "Filters results to only include resources with a freemium license. Set to 1 to enable, 0 to disable.", "type": "number" }, "filters[license][premium]": { "default": 0, "description": "Filters results to only include resources with a premium license. Set to 1 to enable, 0 to disable.", "type": "number" }, "filters[orientation][landscape]": { "default": 0, "description": "Filters results to only include resources with a landscape orientation. Set to 1 to enable, 0 to disable.", "type": "number" }, "filters[orientation][panoramic]": { "default": 0, "description": "Filters results to only include resources with a panoramic orientation. Set to 1 to enable, 0 to disable.", "type": "number" }, "filters[orientation][portrait]": { "default": 0, "description": "Filters results to only include resources with a portrait orientation. Set to 1 to enable, 0 to disable.", "type": "number" }, "filters[orientation][square]": { "default": 0, "description": "Filters results to only include resources with a square orientation. Set to 1 to enable, 0 to disable.", "type": "number" }, "filters[people][age]": { "description": "Filter by age of the people", "enum": [ "infant", "child", "teen", "young-adult", "adult", "senior", "elder" ], "type": "string" }, "filters[people][ethnicity]": { "description": "Filter by ethnicity of the people", "enum": [ "south-asian", "middle-eastern", "east-asian", "black", "hispanic", "indian", "white", "multiracial", "southeast-asian" ], "type": "string" }, "filters[people][exclude]": { "default": 0, "description": "Filter by excluded people", "type": "number" }, "filters[people][gender]": { "description": "Filter by gender of the people", "enum": [ "male", "female" ], "type": "string" }, "filters[people][include]": { "default": 0, "description": "Filter by included people", "type": "number" }, "filters[people][number]": { "description": "Filter by number of people", "enum": [ "1", "2", "3", "more_than_three" ], "type": "string" }, "filters[period]": { "description": "Filters results based on the time period in which the resources were added.", "enum": [ "last-month", "last-quarter", "last-semester", "last-year" ], "type": "string" }, "filters[psd][type]": { "description": "File type for psd", "enum": [ "jpg", "psd" ], "type": "string" }, "filters[vector][style]": { "description": "Style type for vectors, ignored if content_type exists and it is not vector", "enum": [ "watercolor", "flat", "cartoon", "geometric", "gradient", "isometric", "3d", "hand-drawn" ], "type": "string" }, "filters[vector][type]": { "description": "File type for vectors", "enum": [ "jpg", "ai", "eps", "svg" ], "type": "string" }, "limit": { "description": "Limit results per page. It must be greater than 0.", "type": "integer" }, "order": { "default": "relevance", "description": "Specifies the order in which search results are returned. The available options allow you to prioritize results based on different criteria:\n - `relevance`: Prioritizes results that are most relevant to the search query.\n - `recent`: Sorts results by the most recent updates.\n", "enum": [ "relevance", "recent" ], "type": "string" }, "page": { "description": "Page number. It must be greater than 0 and less than or equal to 100.", "type": "integer" }, "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" } }, "required": [], "type": "object" }

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/freepik-company/freepik-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server