Get all resources
Retrieve a list of resources based on various filter criteria such as orientation, content type, license, and more.
Authorizations
Your Freepik API key. Required for authentication. Learn how to obtain an API key
Headers
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.
Query Parameters
Page number. It must be greater than 0 and less than or equal to 100.
Limit results per page. It must be greater than 0.
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.random
: Displays results in a random order.
relevance
, recent
, random
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 results to only include resources with a landscape orientation. Set to 1 to enable, 0 to disable.
Filters results to only include resources with a portrait orientation. Set to 1 to enable, 0 to disable.
Filters results to only include resources with a square orientation. Set to 1 to enable, 0 to disable.
Filters results to only include resources with a panoramic orientation. Set to 1 to enable, 0 to disable.
Filters results to only include resources of type photo. Set to 1 to enable, 0 to disable.
Filters results to only include resources of type PSD (Photoshop Document). Set to 1 to enable, 0 to disable.
Filters results to only include resources of type vector. Set to 1 to enable, 0 to disable.
Filters results to only include resources with a freemium license. Set to 1 to enable, 0 to disable.
Filters results to only include resources with a premium license. Set to 1 to enable, 0 to disable.
Filter by included people
Filter by excluded people
Filter by number of people
1
, 2
, 3
, more_than_three
Filter by age of the people
infant
, child
, teen
, young-adult
, adult
, senior
, elder
Filter by gender of the people
male
, female
Filter by ethnicity of the people
south-asian
, middle-eastern
, east-asian
, black
, hispanic
, indian
, white
, multiracial
Filters results based on the time period in which the resources were added.
last-month
, last-quarter
, last-semester
, last-year
Filters results by the predominant color in the resources.
black
, blue
, gray
, green
, orange
, red
, white
, yellow
, purple
, cyan
, pink
Filters results to include resources by a specific author, identified by their author ID.
Excludes AI-generated images from the results. Set to 1 to exclude, 0 to include.
Filters results to only include AI-generated images. Set to 1 to include only AI-generated images, 0 to include all images.
File type for vectors
jpg
, ai
, eps
, svg
Style type for vectors, ignored if content_type exists and it is not vector
watercolor
, flat
, cartoon
, geometric
, gradient
, isometric
, 3d
, hand-drawn
File type for psd
jpg
, psd
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.
Response
A list of resources.
Metainformation about pagination
Was this page helpful?