Get all resources

GET

resources

curl --request GET \
  --url https://api.freepik.com/v1/resources \
  --header 'x-freepik-api-key: <api-key>'

{
  "data": [
    {
      "id": 770011,
      "title": "Sports car",
      "url": "https://www.freepik.com/free-icon/sports-car_770011.htm",
      "filename": "sports-car.zip",
      "licenses": [
        {
          "type": "freemium",
          "url": "https://www.freepik.com/profile/license/pdf/770011?lang=en"
        }
      ],
      "products": [],
      "meta": {
        "published_at": "2022-01-14T20:45:28.000Z",
        "is_new": true,
        "available_formats": {
          "jpg": {
            "total": 2,
            "items": [
              {
                "id": 444,
                "name": "Sports car",
                "colorspace": "RGB",
                "size": 100
              },
              {
                "id": 555,
                "name": "Sports car",
                "colorspace": "RGB",
                "size": 200
              }
            ]
          }
        }
      },
      "image": {
        "type": "photo",
        "orientation": "square",
        "source": {
          "url": "https://img.flaticon.com/icons/png/512/67/67994.png",
          "key": "large",
          "size": "128x128"
        }
      },
      "related": {
        "serie": [],
        "others": [],
        "keywords": []
      },
      "stats": {
        "downloads": 52527,
        "likes": 137
      },
      "author": {
        "id": 744082,
        "name": "flaticon",
        "avatar": "https://avatar.cdnpk.net/744082.jpg",
        "slug": "flaticon"
      }
    },
    {
      "id": 1540200,
      "title": "Grey car logo collection",
      "url": "https://www.freepik.com/free-vector/grey-car-logo-collection_1540200.htm",
      "filename": "grey-car-logo-collection.zip",
      "licenses": [
        {
          "type": "freemium",
          "url": "https://www.freepik.com/profile/license/pdf/1540200?lang=en"
        }
      ],
      "products": [
        {
          "type": "essential",
          "url": "https://www.freepik.com/profile/license/pdf/1540200?lang=en"
        }
      ],
      "meta": {
        "published_at": "2022-01-14T16:06:23.000Z",
        "is_new": true,
        "available_formats": {
          "jpg": {
            "total": 2,
            "items": [
              {
                "id": 444,
                "size": 100
              },
              {
                "id": 555,
                "size": 200
              }
            ]
          }
        }
      },
      "image": {
        "type": "vector",
        "orientation": "square",
        "source": {
          "url": "https://",
          "key": "large",
          "size": "626x626"
        }
      },
      "related": {
        "serie": [],
        "others": [],
        "keywords": []
      },
      "stats": {
        "downloads": 1639,
        "likes": 18
      },
      "author": {
        "id": 23,
        "name": "freepik",
        "avatar": "https://avatar.cdnpk.net/23.jpg",
        "slug": "freepik"
      }
    }
  ],
  "meta": {
    "current_page": 1,
    "last_page": 32,
    "per_page": 2,
    "total": 63
  }
}

Authorizations

x-freepik-api-key

string

header

required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Headers

Accept-Language

string

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

integer

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

limit

integer

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

order

enum<string>

default:relevance

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.

Available options:

relevance,

recent

term

string

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[orientation][landscape]

number

default:0

Filters results to only include resources with a landscape orientation. Set to 1 to enable, 0 to disable.

filters[orientation][portrait]

number

default:0

Filters results to only include resources with a portrait orientation. Set to 1 to enable, 0 to disable.

filters[orientation][square]

number

default:0

Filters results to only include resources with a square orientation. Set to 1 to enable, 0 to disable.

filters[orientation][panoramic]

number

default:0

Filters results to only include resources with a panoramic orientation. Set to 1 to enable, 0 to disable.

filters[content_type][photo]

number

default:0

Filters results to only include resources of type photo. Set to 1 to enable, 0 to disable.

filters[content_type][psd]

number

default:0

Filters results to only include resources of type PSD (Photoshop Document). Set to 1 to enable, 0 to disable.

filters[content_type][vector]

number

default:0

Filters results to only include resources of type vector. Set to 1 to enable, 0 to disable.

filters[license][freemium]

number

default:0

Filters results to only include resources with a freemium license. Set to 1 to enable, 0 to disable.

filters[license][premium]

number

default:0

Filters results to only include resources with a premium license. Set to 1 to enable, 0 to disable.

filters[people][include]

number

default:0

Filter by included people

filters[people][exclude]

number

default:0

Filter by excluded people

filters[people][number]

enum<string>

Filter by number of people

Available options:

1,

2,

3,

more_than_three

filters[people][age]

enum<string>

Filter by age of the people

Available options:

infant,

child,

teen,

young-adult,

adult,

senior,

elder

filters[people][gender]

enum<string>

Filter by gender of the people

Available options:

male,

female

filters[people][ethnicity]

enum<string>

Filter by ethnicity of the people

Available options:

south-asian,

middle-eastern,

east-asian,

black,

hispanic,

indian,

white,

multiracial

filters[period]

enum<string>

Filters results based on the time period in which the resources were added.

Available options:

last-month,

last-quarter,

last-semester,

last-year

filters[color]

enum<string>

Filters results by the predominant color in the resources.

Available options:

black,

blue,

gray,

green,

orange,

red,

white,

yellow,

purple,

cyan,

pink

filters[author]

number

default:0

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

filters[ai-generated][excluded]

number

default:0

Excludes AI-generated images from the results. Set to 1 to exclude, 0 to include.

filters[ai-generated][only]

number

default:0

Filters results to only include AI-generated images. Set to 1 to include only AI-generated images, 0 to include all images.

filters[vector][type]

enum<string>

File type for vectors

Available options:

jpg,

ai,

eps,

svg

filters[vector][style]

enum<string>

Style type for vectors, ignored if content_type exists and it is not vector

Available options:

watercolor,

flat,

cartoon,

geometric,

gradient,

isometric,

3d,

hand-drawn

filters[psd][type]

enum<string>

File type for psd

Available options:

jpg,

psd

filters[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.

Response

200

application/json

Ok Response

data

object[]

A list of resources.

A resource within a list of resources from collection

data.id

integer

required

Resource's id.

Required range: x >= 1

Example:

15667327

data.title

string

required

Resource's title.

Example:

"White t-shirt with copy space on gray background"

data.url

string

required

Resource's url

Example:

"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"

data.licenses

object[]

required

The licenses of this resource

data.image

object

required

data.image.type

enum<string>

required

The type of the resource.

Available options:

photo,

vector,

psd

Example:

"vector"

data.image.orientation

enum<string>

required

The orientation of the image.

Available options:

horizontal,

vertical,

square,

panoramic,

unknown

data.image.source

object

required

Example:

{
  "size": "740x640",
  "key": "large",
  "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"
}

Example:

{
  "orientation": "horizontal",
  "source": {
    "size": "740x640",
    "key": "large",
    "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"
  },
  "type": "vector"
}

data.author

object

required

Example:

{
  "assets": 0,
  "name": "John Doe",
  "id": 2147483647,
  "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
  "slug": "merry-christmas"
}

data.filename

string

required

The filename of this resource.

data.meta

object

required

data.meta.published_at

string

required

The datetime when this resource was published.

Example:

"2020-12-01T23:50:50.000Z"

data.meta.is_new

boolean

required

True if this resource is new. False, otherwise.

Example:

true

data.meta.available_formats

object | null

required

The available formats for the resource.

data.meta.available_formats.psd

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.ai

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.eps

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.atn

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.fonts

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.resources

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.png

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.jpg

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.3d-render

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.zip

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

data.meta.available_formats.svg

object

Example:

{
  "total": 1,
  "items": [
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    },
    {
      "size": 100,
      "colorspace": "RGB",
      "name": "image.jpg",
      "id": 1
    }
  ]
}

Example:

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

Example:

{
  "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:50.000Z"
}

A resource within a list of resources from collection

Resource's id.

Required range: x >= 1

Example:

15667327

Resource's title.

Example:

"White t-shirt with copy space on gray background"

Resource's url

Example:

"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"

The licenses of this resource

The type of the resource.

Available options:

photo,

vector,

psd

Example:

"vector"

The orientation of the image.

Available options:

horizontal,

vertical,

square,

panoramic,

unknown

Example:

{
  "size": "740x640",
  "key": "large",
  "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"
}

Example:

{
  "orientation": "horizontal",
  "source": {
    "size": "740x640",
    "key": "large",
    "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"
  },
  "type": "vector"
}

Example:

{
  "assets": 0,
  "name": "John Doe",
  "id": 2147483647,
  "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
  "slug": "merry-christmas"
}

Example:

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

A resource within a list of resources from collection

Resource's id.

Required range: x >= 1

Example:

15667327

Resource's title.

Example:

"White t-shirt with copy space on gray background"

Resource's url

Example:

"https://www.freepik.com/free-photo/white-t-shirts-with-copy-space-gray-background_15667327.htm"

The licenses of this resource

The type of the resource.

Available options:

photo,

vector,

psd

Example:

"vector"

The orientation of the image.

Available options:

horizontal,

vertical,

square,

panoramic,

unknown

Example:

{
  "size": "740x640",
  "key": "large",
  "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"
}

Example:

{
  "orientation": "horizontal",
  "source": {
    "size": "740x640",
    "key": "large",
    "url": "https://img.freepik.com/free-photo/tshirt_53876-104920.jpg"
  },
  "type": "vector"
}

Example:

{
  "assets": 0,
  "name": "John Doe",
  "id": 2147483647,
  "avatar": "https://avatar.cdnpk.net/61668527-220726032514.jpg",
  "slug": "merry-christmas"
}

Example:

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

Example:

{
  "name": "Merry Christmas",
  "slug": "merry-christmas"
}

Example:

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

data.stats

object

required

Example:

{ "downloads": 0, "likes": 0 }

data.products

object[]

deprecated

These products of this resource

Image Generation API

Image Editing API

Classifier

Stock Content

Authorizations

Headers

Query Parameters

Response