search_resources
Search and filter Freepik visual resources by orientation, content type, license, color, and other criteria to find specific images, vectors, and design assets.
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
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. | |
| page | No | Page number. It must be greater than 0 and less than or equal to 100. | |
| 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 |
| 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 | |
| filters | No | Advanced filtering options for resources |