search_resources
Search and retrieve resources by applying filters such as orientation, content type, license, and more. Sort results by relevance or recency to find specific visual content efficiently.
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: Advanced filtering options for resources
Responses:
200 (Success): Ok Response
Content-Type:
application/jsonResponse 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/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"
}
403: Forbidden - The client does not have permission to access the requested resource.
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"
}
503: Service Unavailable
Content-Type:
application/jsonResponse Properties:
Example:
{
"message": "Service Unavailable. Please try again later."
}
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. | |
| filters | No | Advanced filtering options for resources | |
| limit | No | Limit results per page. It must be greater than 0. | |
| order | No | 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. | relevance |
| page | No | Page number. It must be greater than 0 and less than or equal to 100. | |
| 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 |
Input Schema (JSON Schema)
{
"$defs": {
"search_resources_filters_parameter_ai_generated": {
"properties": {
"excluded": {
"default": 0,
"description": "Excludes AI-generated images from the results. Set to 1 to exclude, 0 to include.",
"type": "number"
},
"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"
}
},
"type": "object"
},
"search_resources_filters_parameter_content_type": {
"properties": {
"photo": {
"default": 0,
"description": "Filters results to only include resources of type photo. Set to 1 to enable, 0 to disable.",
"type": "number"
},
"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"
},
"vector": {
"default": 0,
"description": "Filters results to only include resources of type vector. Set to 1 to enable, 0 to disable.",
"type": "number"
}
},
"type": "object"
},
"search_resources_filters_parameter_license": {
"properties": {
"freemium": {
"default": 0,
"description": "Filters results to only include resources with a freemium license. Set to 1 to enable, 0 to disable.",
"type": "number"
},
"premium": {
"default": 0,
"description": "Filters results to only include resources with a premium license. Set to 1 to enable, 0 to disable.",
"type": "number"
}
},
"type": "object"
},
"search_resources_filters_parameter_orientation": {
"properties": {
"landscape": {
"default": 0,
"description": "Filters results to only include resources with a landscape orientation. Set to 1 to enable, 0 to disable.",
"type": "number"
},
"panoramic": {
"default": 0,
"description": "Filters results to only include resources with a panoramic orientation. Set to 1 to enable, 0 to disable.",
"type": "number"
},
"portrait": {
"default": 0,
"description": "Filters results to only include resources with a portrait orientation. Set to 1 to enable, 0 to disable.",
"type": "number"
},
"square": {
"default": 0,
"description": "Filters results to only include resources with a square orientation. Set to 1 to enable, 0 to disable.",
"type": "number"
}
},
"type": "object"
},
"search_resources_filters_parameter_people": {
"properties": {
"age": {
"description": "Filter by age of the people",
"enum": [
"infant",
"child",
"teen",
"young-adult",
"adult",
"senior",
"elder"
],
"example": "child",
"type": "string"
},
"ethnicity": {
"description": "Filter by ethnicity of the people",
"enum": [
"south-asian",
"middle-eastern",
"east-asian",
"black",
"hispanic",
"indian",
"white",
"multiracial",
"southeast-asian"
],
"example": "black",
"type": "string"
},
"exclude": {
"default": 0,
"description": "Filter by excluded people",
"example": 1,
"type": "number"
},
"gender": {
"description": "Filter by gender of the people",
"enum": [
"male",
"female"
],
"example": "female",
"type": "string"
},
"include": {
"default": 0,
"description": "Filter by included people",
"example": 1,
"type": "number"
},
"number": {
"description": "Filter by number of people",
"enum": [
"1",
"2",
"3",
"more_than_three"
],
"example": "2",
"type": "string"
}
},
"type": "object"
},
"search_resources_filters_parameter_psd": {
"properties": {
"type": {
"description": "File type for psd",
"enum": [
"jpg",
"psd"
],
"type": "string"
}
},
"type": "object"
},
"search_resources_filters_parameter_vector": {
"properties": {
"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"
},
"type": {
"description": "File type for vectors",
"enum": [
"jpg",
"ai",
"eps",
"svg"
],
"type": "string"
}
},
"type": "object"
}
},
"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": {
"description": "Advanced filtering options for resources",
"properties": {
"ai-generated": {
"$ref": "#/$defs/search_resources_filters_parameter_ai_generated"
},
"author": {
"default": 0,
"description": "Filters results to include resources by a specific author, identified by their author ID.",
"type": "number"
},
"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"
},
"content_type": {
"$ref": "#/$defs/search_resources_filters_parameter_content_type"
},
"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.",
"example": "1,2,3,4,5",
"type": "string"
},
"license": {
"$ref": "#/$defs/search_resources_filters_parameter_license"
},
"orientation": {
"$ref": "#/$defs/search_resources_filters_parameter_orientation"
},
"people": {
"$ref": "#/$defs/search_resources_filters_parameter_people"
},
"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"
},
"psd": {
"$ref": "#/$defs/search_resources_filters_parameter_psd"
},
"vector": {
"$ref": "#/$defs/search_resources_filters_parameter_vector"
}
},
"type": "object"
},
"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"
}