Resources

Search and filter resources with advanced options

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

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

Query parameters

pageinteger

Page number. It must be greater than 0 and less than or equal to 100.

limitinteger

Limit results per page. It must be greater than 0.

order'relevance' | 'recent'

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.
termstring

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

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.

authornumber

Filters results to include resources by a specific author, identified by their author ID.

idsstring

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.

Advanced filtering options for resources

{
  "people": {
    "include": 1,
    "exclude": 1,
    "number": "2",
    "age": "child",
    "gender": "female",
    "ethnicity": "black"
  },
  "ids": "1,2,3,4,5"
}

Headers

Accept-Languagestring

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.

Response

Ok Response

Example response

{
  "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
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.