--- title: "Search and filter resources with advanced options" method: GET path: "/v1/resources" tags: ["Resources"] --- # Search and filter resources with advanced options `GET /v1/resources` ## Request - Base URL: `https://api.magnific.com` - URL: `https://api.magnific.com/v1/resources` - Auth: API key in header `x-magnific-api-key` Retrieve a list of resources based on various filter criteria such as orientation, content type, license, and more. ## Query parameters - `page` integer - `limit` integer - `order` 'relevance' | 'recent' - `term` string - `filters` SearchResourcesFiltersParameter - `orientation` SearchResourcesFiltersParameterOrientation - `landscape` number: Filters results to only include resources with a landscape orientation. Set to 1 to enable, 0 to disable. - `portrait` number: Filters results to only include resources with a portrait orientation. Set to 1 to enable, 0 to disable. - `square` number: Filters results to only include resources with a square orientation. Set to 1 to enable, 0 to disable. - `panoramic` number: Filters results to only include resources with a panoramic orientation. Set to 1 to enable, 0 to disable. - `content_type` SearchResourcesFiltersParameterContentType - `photo` number: Filters results to only include resources of type photo. Set to 1 to enable, 0 to disable. - `psd` number: Filters results to only include resources of type PSD (Photoshop Document). Set to 1 to enable, 0 to disable. - `vector` number: Filters results to only include resources of type vector. Set to 1 to enable, 0 to disable. - `license` SearchResourcesFiltersParameterLicense - `freemium` number: Filters results to only include resources with a freemium license. Set to 1 to enable, 0 to disable. - `premium` number: Filters results to only include resources with a premium license. Set to 1 to enable, 0 to disable. - `people` SearchResourcesFiltersParameterPeople - `include` number: Filter by included people - `exclude` number: Filter by excluded people - `number` '1' | '2' | '3' | 'more_than_three': Filter by number of people - `age` 'infant' | 'child' | 'teen' | 'young-adult' | 'adult' | 'senior' | 'elder': Filter by age of the people - `gender` 'male' | 'female': Filter by gender of the people - `ethnicity` 'south-asian' | 'middle-eastern' | 'east-asian' | 'black' | 'hispanic' | 'indian' | 'white' | 'multiracial' | 'southeast-asian': Filter by ethnicity of the people - `period` 'last-month' | 'last-quarter' | 'last-semester' | 'last-year': Filters results based on the time period in which the resources were added. - `color` 'black' | 'blue' | 'gray' | 'green' | 'orange' | 'red' | 'white' | 'yellow' | 'purple' | 'cyan' | 'pink': Filters results by the predominant color in the resources. - `author` number: Filters results to include resources by a specific author, identified by their author ID. - `ai-generated` SearchResourcesFiltersParameterAiGenerated - `excluded` number: Excludes AI-generated images from the results. Set to 1 to exclude, 0 to include. - `only` number: Filters results to only include AI-generated images. Set to 1 to include only AI-generated images, 0 to include all images. - `vector` SearchResourcesFiltersParameterVector - `type` 'jpg' | 'ai' | 'eps' | 'svg': File type for vectors - `style` 'watercolor' | 'flat' | 'cartoon' | 'geometric' | 'gradient' | 'isometric' | '3d' | 'hand-drawn': Style type for vectors, ignored if content_type exists and it is not vector - `psd` SearchResourcesFiltersParameterPsd - `type` 'jpg' | 'psd': File type for psd - `ids` string: 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. ## Headers - `Accept-Language` string ## Response `200` Ok Response - SearchResources200Response - `data` SearchResources200ResponseDataInner[]: A list of resources. - union - VectorPsdResource: A resource within a list of resources from collection - `id` integer, required: Resource's id. - `title` string, required: Resource's title. - `url` string, uri, required: Resource's url - `licenses` LicenseInformation[], required: The licenses of this resource - `type` 'freemium' | 'premium', required: The type of license. - `url` string, uri, required: The URL of the license. - `image` ResourceImage, required - `type` 'photo' | 'vector' | 'psd', required: The type of the resource. - `orientation` 'horizontal' | 'vertical' | 'square' | 'panoramic' | 'unknown', required: The orientation of the image. - `source` ResourceImageSource, required - `key` 'large', required: The size of this image - `url` string, uri, required: The orientation of this resource. - `size` string, required: The width and height of the image - `author` Author, required - `id` integer, required - `name` string, required - `avatar` string, uri, required - `assets` integer, required: The number of assets of this author. - `slug` string, required - `filename` string, required: The filename of this resource. - `products` ResourceProduct[]: These products of this resource - `type` string, required: The type of product - `url` string, uri, required: The url of product - `meta` ResourceMeta, required - `published_at` string, required: The datetime when this resource was published. - `is_new` boolean, required: True if this resource is new. False, otherwise. - `available_formats` AvailableFormats1, nullable, required: The available formats for the resource. - `psd` Formats - … - `ai` Formats - … - `eps` Formats - … - `atn` Formats - … - `fonts` Formats - … - `resources` Formats - … - `png` Formats - … - `jpg` Formats - … - `3d-render` Formats - … - `zip` Formats - … - `svg` Formats - … - `related` ResourceRelated, required - `serie` ResourceBase, required: A resource within a list of resources from collection - `id` integer, required: Resource's id. - `title` string, required: Resource's title. - `url` string, uri, required: Resource's url - `licenses` LicenseInformation[], required: The licenses of this resource - … - `image` ResourceImage, required - … - `author` Author, required - … - `others` ResourceBase, required: A resource within a list of resources from collection - `id` integer, required: Resource's id. - `title` string, required: Resource's title. - `url` string, uri, required: Resource's url - `licenses` LicenseInformation[], required: The licenses of this resource - … - `image` ResourceImage, required - … - `author` Author, required - … - `keywords` Tag1, required - `slug` string, required - `name` string, required: The name of the tag. - `stats` ResourceStats, required - `downloads` integer, required: The number of downloads of this resource. - `likes` integer, required: The number of likes of this resource. - PhotoResource: A resource within a list of resources from collection - `id` integer, required: Resource's id. - `title` string, required: Resource's title. - `url` string, uri, required: Resource's url - `licenses` LicenseInformation[], required: The licenses of this resource - `type` 'freemium' | 'premium', required: The type of license. - `url` string, uri, required: The URL of the license. - `image` ResourceImage, required - `type` 'photo' | 'vector' | 'psd', required: The type of the resource. - `orientation` 'horizontal' | 'vertical' | 'square' | 'panoramic' | 'unknown', required: The orientation of the image. - `source` ResourceImageSource, required - `key` 'large', required: The size of this image - `url` string, uri, required: The orientation of this resource. - `size` string, required: The width and height of the image - `author` Author, required - `id` integer, required - `name` string, required - `avatar` string, uri, required - `assets` integer, required: The number of assets of this author. - `slug` string, required - `filename` string, required: The filename of this resource. - `products` ResourceProduct[]: These products of this resource - `type` string, required: The type of product - `url` string, uri, required: The url of product - `meta` PhotoMeta, required - `published_at` string, required: The datetime when this resource was published. - `is_new` boolean, required: True if this resource is new. False, otherwise. - `available_formats` PhotoAvailableFormats, nullable, required: The available formats for the photo. - `jpg` PhotoFormats - … - `related` ResourceBase, required: A resource within a list of resources from collection - `id` integer, required: Resource's id. - `title` string, required: Resource's title. - `url` string, uri, required: Resource's url - `licenses` LicenseInformation[], required: The licenses of this resource - `type` 'freemium' | 'premium', required: The type of license. - `url` string, uri, required: The URL of the license. - `image` ResourceImage, required - `type` 'photo' | 'vector' | 'psd', required: The type of the resource. - `orientation` 'horizontal' | 'vertical' | 'square' | 'panoramic' | 'unknown', required: The orientation of the image. - `source` ResourceImageSource, required - … - `author` Author, required - `id` integer, required - `name` string, required - `avatar` string, uri, required - `assets` integer, required: The number of assets of this author. - `slug` string, required - `stats` ResourceStats, required - `downloads` integer, required: The number of downloads of this resource. - `likes` integer, required: The number of likes of this resource. - `meta` SearchResources200ResponseMeta: Metainformation about pagination - `current_page` integer: The current page. - `per_page` integer: The limit of resources per page. - `last_page` integer: The total number of pages. - `total` integer: The total number of resources. - `clean_search` boolean: If true, It has been ensured that the search does not return disabled resources. ## Other responses - `400`: Bad Request - The server could not understand the request due to invalid syntax. - `401`: Unauthorized - The client must authenticate itself to get the requested response. - `403`: Forbidden - The client does not have permission to access the requested resource. - `404`: Not Found - The server can not find the requested resource. - `503`: Service Unavailable --- [API](https://skmtc.dev/magnific/apis/magnific-api.md) · [All operations](https://skmtc.dev/magnific/apis/magnific-api/llms.txt) · [OpenAPI document](https://skmtc.dev/magnific/apis/magnific-api/revisions/60711fb082c7?raw)