GET
/
v1
/
resources
curl --request GET \
  --url https://api.freepik.com/v1/resources \
  --header 'Accept-Language: <accept-language>' \
  --header 'x-freepik-api-key: <api-key>'
{
  "data": [
    {
      "id": 770011,
      "title": "Sports car",
      "active": true,
      "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",
      "active": true,
      "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
headerrequired

Headers

Accept-Language
string
required

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.

Accept
string

The Accept header is used to inform the server by the client that which content type is understandable by the client expressed as MIME-types.

Content-Type
string

The Content-Type header is used to indicate the media type of the resource. The media type is a string sent along with the file indicating the format of the file.

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.
  • random: Displays results in a random order.
Available options:
relevance,
recent,
random
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
data
object[]

A list of resources.

meta
object

Metainformation about pagination